JavaDoc中未自动集成UmlGraph

Question

我使用maven和maven- javadoc -plugin和umlgraph-doclet为我的项目创建javadoc。我的pom中的一部分：

<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开发人员。

有人能在这里给我一些建议，或者有一些想法如何解决这个问题吗？

Answer 1

我检查了各种可能性，情况如下：

已经修复了UmlGraph中与

• 相关的错误:但是，https://github.com/dspinellis/UMLGraph/pull/8
• problem表示尚未发布包含修复

的UmlGraph的稳定版本

然而，好消息是，存在包含修复的快照存储库：https://oss.sonatype.org/content/repositories/snapshots/org/umlgraph/umlgraph/5.5.8-SNAPSHOT/

因此，您需要将jar文件放到本地存储库(取决于您的基础设施设置)：

通过导入到本地存储库(http://maven.apache.org/guides/mini/guide-3rd-party-jars-local.html)，将参考存储库添加到您的environment

• or，从而创建

事后更新：

<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>

Answer 2

更新: 5.6.6版本现在在maven central上。我是用JDK7构建的，图看起来不错。

<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>

Answer 3

UmlGraphDoc 5.4版本，更改javadocs警告，找不到与模式'/H2‘匹配的行

HTML则完全不同。

Java7 JavaDocs START OF CLASS DATA h2 title=“胡言乱语

Java6 JavaDocs类的起始数据H2

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