Javadoc Inserting UML Diagrams

问题

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!

回答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.

回答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.

回答3:

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

In short:

Install GraphViz.

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

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>

Run mvn javadoc:javadoc.

回答4:

ApiViz is a nice doclet too.

回答5:

Simple Answer:

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

回答6:

yDoc is an option

回答7:

This article explains how it can be done by placing your images in a folder accessible to the javadoc tool.

来源：https://stackoverflow.com/questions/1411172/javadoc-inserting-uml-diagrams

标签

java

javadoc

class-diagram