在UMLGraph中有没有替代anotations和comments的方法

Question

我正在使用UMLGraph for Java to UML。它在关系文档中说明了以下内容：

关联关系(使用javadoc @assoc标记指定)

可导航(定向)关联关系(使用javadoc @navassoc标记指定)

聚合关系(使用javadoc @has标记指定)

组合关系(使用javadoc @composed标记指定)

依赖关系(使用javadoc @depend标记指定)

我不能在源代码中添加这些标签或任何注释。有什么替代方案吗？

Answer 1

如果您正在使用常用的模板来配置UmlGraph，那么您可能使用的是旧版本。

我在通常的maven存储库中找不到doclet。我建议您下载最新版本，并将其手动部署到您的存储库管理器。你可以从这里下载：http://www.umlgraph.org/download.html

部署完成后，使用以下命令：

  <plugin>
   <groupId>org.apache.maven.plugins</groupId>
   <artifactId>maven-javadoc-plugin</artifactId>
   <version>2.9</version>
   <configuration>
    <maxmemory>1024</maxmemory>
    <quiet>true</quiet>
    <doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
    <docletArtifact>
     <groupId>org.umlgraph</groupId>
     <artifactId>doclet</artifactId>
     <version>5.6</version>
    </docletArtifact>
    <additionalparam>
     -inferrel -inferdep -quiet -hide java.*
     -collpackages java.util.* -qualify -postfixpackage
     -nodefontsize 9 -nodefontpackagesize 7
    </additionalparam>
    <links>
     <link>http://download.oracle.com/javase/7/docs/api</link>
    </links>
   </configuration>
  </plugin>

Answer 2

在您使用的是与Java8兼容的最新快照版本中的Java8和UMLGraph时，由于Javadoc doclint‌​的变化，需要额外的配置。所以本例需要额外的参数:参见belove。

 <!-- UMLGraph Javadoc doclet -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.9</version>
<configuration>
<tags>
<tag>
<name>depend</name>
<placement>X</placement>
</tag>
<tag>
<name>hidden</name>
<placement>X</placement>
</tag>
<tag>
<name>opt</name>
<placement>X</placement>
</tag>
<tag>
<name>assoc</name>
<placement>X</placement>
</tag>
<tag>
<name>has</name>
<placement>X</placement>
</tag>
<tag>
<name>composed</name>
<placement>X</placement>
</tag>
<tag>
<name>view</name>
<placement>X</placement>
</tag>
<tag>
<name>match</name>
<placement>X</placement>
</tag>
</tags>
<doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
<docletPath>${basedir}/doclets/UmlGraph.jar</docletPath>
<additionalparam>-inferrel</additionalparam>
<additionalparam>-inferdep</additionalparam>
<additionalparam>-collapsible</additionalparam>
<additionalparam>-hide java.*</additionalparam>
<additionalparam>-compact</additionalparam>
<additionalparam>-subpackages gr.spinellis</additionalparam>
<useStandardDocletOptions>true</useStandardDocletOptions>
</configuration>
</plugin>