javadoc 中的@uml.property 标签从何而来？

Posted 2023-03-28

【中文标题】javadoc 中的@uml.property 标签从何而来？

【英文标题】：Where does @uml.property tag in javadoc come from?

【发布时间】：2015-10-21 23:34:56

【问题描述】：

我偶然发现了一段由我之前离开公司的人编写的代码；我是他代码的继承人。

这些标签是什么？我只在一个特定的 Class 文件中找到它们，它们似乎具有很少或很大的价值。我只是不知道他们是不是垃圾。

该类未引用任何外部“uml”库。

这是一个完整的例子......

/**
 * @uml.property  name="devs"
 */
public ArrayList<String> getDevs() 
    return devs;

【参考方案1】：

这些标签来自Soyatec UML plugin。这里也是标签的详细解释。代码显然是从 UML 图生成的。生成器将该标签添加到生成的字段中。

如果您不再使用 UML 插件，您可以将其删除。它不会影响您的代码。但是参数（name、readOnly、multiplicity、dimension、ordering、container、default）可以告诉您有关该领域的一些信息，设计师的意图是什么 - 请参阅上面的链接。

如果您想保留代码中的标签但想摆脱警告，请参阅此问题：Killing Javadoc warnings for specific tags