用于生成Maven javadoc的UmlGraph与APIViz

Question

我想知道在Maven2构建中是否有任何明确的理由选择UmlGraph而不是APIViz来生成javadoc UML图。是否有任何集成或功能，其中一个超过另一个，他们似乎非常相似？

Answer 1

有一个关于UMLGraph vs apiviz的有趣的帖子here (在in this question上也有提到)，我的理解如下：

• UMLGraph更老，但真的很好(dixit Fowler比我更有分量)。
• apiviz是UMLGraph的重写，但不清楚为什么要重写它。
• apiviz的“最大”优势是，如果没有安装Graphviz，构建不会失败(这并不能证明整个重写是合理的，尽管在我的apiviz中不会自动生成图形。您必须添加标记而不是UMLGraph默认情况下自动执行(这可能很方便)，完全自动的结果对所有人来说都很好并且很容易(UMLGraph还可以建模与自定义javadoc的组合关系) tags).
• UMLGraph似乎做了更多的事情(“它看起来UMLGraph除了提供泛化和接口利用率的视图”或“apiviz显示的类用法实际上有助于理解类是如何工作的”)，但我没有检查自己，这可能不再是真的或过时的。

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

Answer 2

apiviz需要注解来生成图形，这不是真的，因为它的文档清楚地说明：

默认情况下，

APIviz会自动发现包和类之间的关系以及它们的构造型。此外，您可以使用下面的doclet标记来添加更多的关系，或者使生成的图表看起来更干净。