2011-12-22 24 views
3

我使用maven和maven-javadoc插件与umlgraph-doclet来为我的项目创建javadoc。从我的POM中的一部分:UmlGraph不自动集成在JavaDoc

<build> 
    <plugins> 
    <plugin> 
     <groupId>org.apache.maven.plugins</groupId> 
     <artifactId>maven-site-plugin</artifactId> 
     <inherited>false</inherited> 
     <configuration> 
     <reportPlugins> 
      <plugin> 
      <groupId>org.apache.maven.plugins</groupId> 
      <artifactId>maven-javadoc-plugin</artifactId> 
      <version>2.8</version> 
      <configuration> 
       <show>public</show> 
       <quiet>true</quiet> 

       <doclet>org.umlgraph.doclet.UmlGraphDoc</doclet> 
       <docletArtifact> 
       <groupId>org.umlgraph</groupId> 
       <artifactId>doclet</artifactId> 
       <version>5.1</version> 
       </docletArtifact> 

       <useStandardDocletOptions>true</useStandardDocletOptions> 
       <additionalparam> 
       -inferrel -inferdep -quiet -hide java.* -hide org.eclipse.* -collpackages java.util.* -postfixpackage 
       -nodefontsize 9 -nodefontpackagesize 7 -attributes -types -visibility -operations -constructors 
       -enumerations -enumconstants -views 
       </additionalparam> 
      </configuration> 
      <reportSets> 
       <reportSet> 
       <reports> 
        <report>aggregate</report> 
       </reports> 
       </reportSet> 
      </reportSets> 
      </plugin> 
     </reportPlugins> 
     </configuration> 
    </plugin> 
    </plugins> 
</build> 

的图像生成,并期待细末,用JDK1.6建设的javadoc时,他们都会自动集成到所有的javadoc页面。但是在使用jdk1.7构建时,图像仍然会被创建,但不在javadoc页面内。即使从官方网站使用v5.4,javadoc也没有图像。而maven的调试输出也没有提供任何线索。最重要的是,没有办法通过邮件联系其中一个UmlGraph开发人员。

任何人都可以给我一些建议,或者有一些想法如何解决这个问题吗?

+0

我的猜测是,由标准doclet产生的HTML页面改变的Java 6和Java 7之间的结构,所以UMLGraph的doclet失败在所生成的图像堵塞。不知道如何解决这个问题(我从来没有使用过这个doclet)。 – 2011-12-23 20:39:20

回答

6

我查了可能性,情况如下:

不过好消息是,存在包含修复快照库:https://oss.sonatype.org/content/repositories/snapshots/org/umlgraph/umlgraph/5.5.8-SNAPSHOT/

为此,你需要得到的jar文件到你的本地库(取决于您的基础架构设置):

事后更新:

<doclet>org.umlgraph.doclet.UmlGraphDoc</doclet> 
<docletArtifact> 
      <groupId>org.umlgraph</groupId> 
      <artifactId>doclet</artifactId> 
      <version>5.1</version> 
</docletArtifact> 

以下(命名约定已更改):

<doclet>org.umlgraph.doclet.UmlGraphDoc</doclet> 
<docletArtifact> 
    <groupId>org.umlgraph</groupId> 
    <artifactId>umlgraph</artifactId> 
    <version>5.5.8-SNAPSHOT</version> 
</docletArtifact> 
1

我有同样的问题。我的猜测是,它的这个错误:

https://issues.jboss.org/browse/APIVIZ-10

+0

是不是这个apiviz而不是umlgraph相关的问题?我猜这两个项目是分开的。有关差异的更多细节似乎存在于:http://stackoverflow.com/questions/1713262/umlgraph-vs-apiviz-for-maven-javadoc-generation – 2012-12-06 08:37:09

2

UmlGraphDoc版本5.4,改变的javadoc 预警,找不到该模式“/ H2”

的HTML简直是天壤之别行匹配。

Java7的JavaDoc START类数据的 H2标题=“等等等等

的Java6的JavaDoc START类数据的 H2

你可以反编译和修改UmlGraphDoc.java

11

更新:版本5.6.6现在在Maven中心。我用JDK 7构建并且图表看起来不错。

<plugin> 
    <artifactId>maven-javadoc-plugin</artifactId> 
    <version>2.7</version> 
    <configuration> 
     <aggregate>true</aggregate> 
     <show>private</show> 
     <doclet>org.umlgraph.doclet.UmlGraphDoc</doclet> 
     <docletArtifact> 
      <groupId>org.umlgraph</groupId> 
      <artifactId>umlgraph</artifactId> 
      <version>5.6.6</version> 
     </docletArtifact> 
    </configuration> 
</plugin>