ソフトウェアエンジニアリング

PlantUMLのサイトに、javadocに埋め込む関連の記述を発見
https://plantuml.com/ja/doclet

UMLDocletを試してみた。
https://github.com/talsma-ict/umldoclet

まずは、JDK 9以降対応のumldoclet-2.0.7.jarをダウンロードし、graphviz 2.38へのPATHを通して実行。

D:\work\hello
  +-- src
        +-- com
              +-- torutk
                    +-- Hello.java

hello> javadoc -sourcepath src -d apidocs ^
-docletpath "C:\Program Files\Java\umldoclet\umldoclet-2.0.7.jar" ^
-doclet nl.talsmasoftware.umldoclet.UMLDoclet com.torutk ^
  :
Generating apidocs\package-dependencies.svg...
javadoc: エラー - Unanticipated error generating UML: java.lang.IllegalStateException: I/O exception postprocessing apidocs\com\torutk\Hello.html
エラー1個

JDK11ではダメなのか？　続いてJDK 8にしてみる。

JDK 8対応のumldoclet-1.1.4.jarをダウンロードして実行。

hello> javadoc -sourcepath src -d apidocs ^
-docletpath "C:\Program Files\Java\umldoclet\umldoclet-1.1.4.jar" ^
-doclet nl.talsmasoftware.umldoclet.UMLDoclet com.torutk ^
  :

正常に終わり、UML図がJavadocのHTMLに埋め込まれた。
クラスのドキュメントページにはクラス図（そのクラス単独）が、パッケージページにはパッケージ図が埋め込まれた。

ただし、コメントでのPlantUML記述はうまくいっていない。