我想知道是否有任何明确的理由选择UmlGraph而不是APIViz在 Maven2 构建中生成 javadoc UML 图。是否有任何集成或功能，它们看起来非常相似？
问问题
3779 次
2 回答
7
这里有一个关于 UMLGraph vs apiviz的有趣线程（在这个问题中也提到过），我的理解如下：
- UMLGraph 较旧但非常好（dixit Fowler 比我重）。
- apiviz 是对 UMLGraph 的重写，但还不清楚为什么要重写它。
- apiviz 的“大”优势是，如果没有安装 Graphviz，构建不会失败（尽管在我看来，这并不能证明整个重写是合理的）。
- apiviz 不会自动生成图形，您必须添加标签，而 UMLGraph 默认会自动生成（这很方便），并且完全自动的结果对所有人来说都很好并且很容易（UMLGraph 还可以使用自定义 javadocs 标签对组合关系进行建模）。
- UMLGraph 似乎做了更多的事情（“看起来 apiviz 只是提供了泛化和接口利用的视图”或“ UMLGraph 显示的类用法实际上有助于理解一个类是如何工作的”）但我没有检查自己这可能不再正确或过时了。
因此，如果您的项目是公开的，那么 apiviz 可以在没有 Graphviz 的情况下优雅地工作这一事实很好。如果你有很多类，那么必须在 javadoc 中到处添加标签是一件很痛苦的事情。如果您正在寻找特殊功能，UMLGraph 可能会提供更多。实际上，我认为您应该尝试两者，因为您显然对最终选择的需求和限制有更好的了解。
于 2009-11-11T07:48:50.013 回答
4
apiviz 需要注释来生成图形是不正确的，因为它的文档清楚地指出：
APIviz 默认自动发现包和类之间的关系以及它们的构造型。此外，您可以使用以下 doclet 标记来添加更多关系或使生成的图表看起来更清晰。
于 2010-05-26T11:30:08.523 回答