Javadoc 插入 UML 图

Question

Is there a way to embed images into my JavaDoc? Basically i want to include some UML diagrams explaining the hierarchy of my classes in some of the documentation.

Thanks!

Answer 1

Check out this section of the Javadoc documentation, which explains how to embed images in your Javadoc.

Also, here is an article describing how to reverse engineer UML diagrams and embed them in your Javadoc using UMLGraph .

Answer 2

Yes.

The documentation explains how to embed arbitrary images to javadoc documentation.

If you want to generate UML class diagrams from your Java source, have a look at the UMLGraph doclet .

Answer 3

This article shows how to use UMLGraph with Maven Javadoc plugin.

In short:

1. Install GraphViz.

   Ubuntu: apt-get install graphviz4 .
   Windows: download .

2. Update pom.xml.

    <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>doclet</artifactId> <version>5.1</version> </docletArtifact> <additionalparam> -inferrel -attributes -types -visibility -inferdep -quiet -hide java.* -collpackages java.util.* -qualify -postfixpackage -nodefontsize 9 -nodefontpackagesize 7 </additionalparam> </configuration> </plugin>

3. Run mvn javadoc:javadoc .

Answer 4

ApiViz也是一个不错的 doclet。

Answer 5

Simple Answer:

/**
 * This class does some stuff (see diagram).
 * <img src="relative/path/to/image.png" />
 * 
 */
 public class SomeClass{
 }

Answer 6

yDoc是一个选项

Answer 7

本文解释了如何通过将图像放置在 javadoc 工具可访问的文件夹中来完成此操作。