UmlGraph 与 APIViz 用于 Maven javadoc 生成

Question

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

Answer 1

这里有一个关于 UMLGraph 与 apiviz 的有趣主题（提到了 在这个问题上也是如此），我的理解如下：

• UMLGraph 较旧，但非常好（dixit Fowler 的权重更大）比我）。
• apiviz 是 UMLGraph 的重写，但目前还不清楚为什么要重写它。
• apiviz 的“大”优势是，如果未安装 Graphviz，构建不会失败（但在我看来，这并不能证明整个重写是合理的）。
• apiviz 不会自动生成图形，您必须添加标签，而 UMLGraph 默认情况下会自动生成（这可能很方便）并且完全自动的结果对所有人来说都很好且容易（UMLGraph 可以还可以使用自定义 javadocs 标签对组合关系进行建模）。
• UMLGraph 似乎可以做更多的事情（“看起来 apiviz 只不过提供了泛化和接口利用率的视图”或“UMLGraph 显示的类用法实际上有助于理解类如何有效”），但我没有检查自己，这可能不再正确或已经过时。

因此，如果您的项目是公开的，那么 apiviz 无需 Graphviz 即可正常工作，这一点很好。如果你有很多类，那么必须在 javadoc 中到处添加标签是一个很大的痛苦。如果您正在寻找特殊功能，UMLGraph 可能会提供更多。实际上，我认为您应该尝试两者，因为您显然对最终选择的需求和限制有更好的了解。

Answer 2

apiviz 需要注释来生成图形，这是不正确的，因为它的文档明确指出：

APIviz 默认情况下会自动发现包和类之间的关系及其构造型。此外，您可以使用以下 doclet 标签来添加更多关系或使生成的图表看起来更清晰。