有没有办法定义';javadoc类型';-成员的自定义参数?

有没有办法定义';javadoc类型';-成员的自定义参数?,java,javadoc,categories,custom-tags,Java,Javadoc,Categories,Custom Tags,我能想到的用例如下: 在一个典型的应用程序中,某个类别通常有许多成员,例如,一个web应用程序包含许多常量属性键、操作类、服务等。对于每个类别,为了保持一致性,一致地记录它们是很有用的 考虑用于属性键的常量: /** * Request scope attribute key of the {@link com.acme.domain.User} object added by the {@link LoginAction}. */ public static final String US

我能想到的用例如下:

在一个典型的应用程序中,某个类别通常有许多成员,例如,一个web应用程序包含许多常量属性键、操作类、服务等。对于每个类别,为了保持一致性,一致地记录它们是很有用的

考虑用于属性键的常量:

/**
 * Request scope attribute key of the {@link com.acme.domain.User} object added by the {@link LoginAction}.
 */
public static final String USER_KEY = "com.acme.web.user";
每个属性键通常都应该记录其作用域、存储在其下的对象类型、设置它的人以及它的对象。“javadoc类型/类别”将按如下方式使用:

/**
 * @AttributeKey
 * @scope request
 * @type com.acme.domain.User
 * @source com.acme.web.action.LoginAction#processLogin()
 * @for HomePage.jsp
 */
public static final String USER_KEY = ...;
当然,呈现的文档标签应该翻译成英语进行呈现。上述方案的一个重要部分是@AttributeKey标记——这将迫使文档编写者包含所有必需的字段或面部警告消息


我几乎可以肯定的是,Java不存在这样的功能,但它值得吗?还有哪些其他语言/文档系统具有这样的功能?

我认为这更适合您所谈论的类型(语义、约束、契约等)。

是的。。。@AttributeKey本应是某种注释