Javadoc Вставка UML-диаграмм

Question

Есть ли способ встроить изображения в мой JavaDoc? По сути, я хочу включить некоторые UML-диаграммы, объясняющие иерархию моих классов, в некоторые документы.

Спасибо!

Answer 1

Ознакомьтесь с этим разделом документации Javadoc, в которой объясняется, как встраивать изображения в Javadoc.

Кроме того, здесь есть статья , описывающая, как выполнить обратный инжиниринг диаграмм UML и внедрить их в ваш Javadoc, используя UMLGraph .

Answer 2

Да.

Документация объясняет, как вставлять произвольные изображения в документацию Javadoc.

Если вы хотите сгенерировать диаграммы классов UML из вашего Java-источника, взгляните на UMLGraph doclet .

Answer 3

Простой ответ:

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

Answer 4

В этой статье показано, как использовать UMLGraph с плагином Maven Javadoc.

Короче говоря:

1. Установите GraphViz.

   Ubuntu: apt-get install graphviz4.
   Windows: скачать .

2. Обновление 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. Выполнить mvn javadoc:javadoc.

Answer 5

ApiViz тоже хороший доклет.

Answer 6

yDoc является опцией

Answer 7

В этой статье объясняется, как это можно сделать, поместив изображения в папку, доступную для инструмента javadoc.