java - 用于 Maven javadoc 生成的 UmlGraph 与 APIViz

Question

我想知道是否有明确的理由选择 UmlGraph在 APIViz用于 Maven2 构建中的 javadoc UML 图生成。是否有任何集成或功能优于另一个，它们看起来非常相似？

Answer 1

有一个有趣的话题here关于 UMLGraph 与 apiviz(在 SO 上也提到了 in this question)，我的理解如下:

• UMLGraph 比较老，但真的很好(dixit Fowler 比我还重)。
• apiviz 是对 UMLGraph 的重写，但不太清楚为什么要重写它。
• apiviz 的“大”优势是，如果未安装 Graphviz，构建不会失败(尽管在我看来，这并不能证明整个重写是合理的)。
• apiviz 不会自动生成图表，您必须添加标签，而 UMLGraph 默认情况下会自动生成(这很方便)并且完全自动的结果对所有人来说都很好且容易(UMLGraph 还可以使用自定义 javadocs 标签对组合关系进行建模)。
• UMLGraph 似乎可以做更多的事情(“看起来 apiviz 只是提供了概括和接口(interface)利用的 View ”或“UMLGraph 显示的类用法实际上有助于理解一个类(class)是如何运作的")，但我没有检查自己，这可能不再是真的或过时了。

因此，如果您的项目是公开的，那么 apiviz 可以在没有 Graphviz 的情况下优雅地工作这一事实很好。如果你有很多类，必须在 javadoc 中到处添加标签是一件很痛苦的事情。如果您正在寻找特殊功能，UMLGraph 可能会提供更多。实际上，我认为您应该对两者都进行试验，因为您显然对最终选择的需求和限制有更好的了解。