java - Mavenjavadoc生成用のUmlGraphとAPIViz

Question

Maven2ビルドでのjavadocUMLダイアグラムの生成に、APIVizではなくUmlGraphを選択する明確な理由があるかどうか疑問に思っています。一方が他方に対して持っている統合または機能はありますか、それらはかなり似ているように見えますか？

Answer 1

ここには、 UMLGraphとapiviz（ SOに関するこの質問でも言及されています）に関する興味深いスレッドがあり、私の理解は次のとおりです。

• UMLGraphは古いですが、本当に素晴らしいです（私よりも重みのあるdixit Fowler）。
• apivizはUMLGraphを書き直したものですが、なぜ書き直したのかは明確ではありません。
• apivizの「大きな」利点は、Graphvizがインストールされていなくてもビルドが失敗しないことです（これは、私の意見では、全体の書き直しを正当化するものではありません）。
• apivizはグラフを自動的に生成しません。タグを追加する必要がありますが、UMLGraphはデフォルトで自動的に生成し（便利な場合があります）、完全に自動化された結果はすべての人にとって問題なく簡単です（UMLGraphはカスタムjavadocsタグを使用して構成関係をモデル化することもできます）。
• UMLGraphはもっと多くのことをしているようです（「apivizは一般化とインターフェース使用率のビューを提供するだけのようです」または「UMLGraphによって示されるクラスの使用法は実際にクラスがどのように機能するかを理解するのに役立ちます」）が、私は自分自身をチェックしませんでしたそして、これはもはや真実ではないか、時代遅れかもしれません。

したがって、プロジェクトが公開されている場合、apivizがGraphvizなしで正常に機能するという事実は素晴らしいことです。クラスがたくさんある場合、どこでもjavadocにタグを追加しなければならないのは大きな苦痛です。特別な機能をお探しの場合は、UMLGraphがさらに多くの機能を提供する可能性があります。実際、最終的な選択のためのニーズと制約についての知識が明らかにあるので、両方を実験する必要があると思います。

Answer 2

ドキュメントに明確に記載されているように、apivizがグラフの生成に注釈を必要とするというのは真実ではありません。

APIvizは、デフォルトでパッケージとクラスの関係とそれらのステレオタイプを自動的に検出します。さらに、次のドックレットタグを使用して、関係を追加したり、生成された図をよりきれいに見せたりすることができます。