2011-12-22 38 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>