如何使用 Enterprise Architect 或 Rational Software Architect 从源代码创建类图？

Question

我不精通 UML，但我想根据现有的 C++ 代码创建一个类图。其他 StackOverflow 问题表明，两个程序 - Enterprise Architect 和 Rational Software Architect - 相当擅长“逆向工程”C++ 代码（即，基于现有 C++ 代码创建 UML 类图）。

我已经下载了这两个应用程序的试用版。但是，我无法在理解如何在这些应用程序中创建类图方面取得任何进展。

在 Rational Software Architect 中，我创建了一个 UML 项目，但我在程序中找不到任何方法来选择和反向工程，我现有的 C++ 代码。

在 Enterprise Architect 中，我能够导入我的 C++ 代码，但是所有元素（类）都出现在图表中一条无用的、重叠的对角线上。我尝试了其他设置，例如圆形，但这些设置同样无法阅读，因为图表太大（由于属性和方法占用了大量空间），没有任何平移和缩放是有用的。我想要隐藏除类名之外的所有内容（即不显示任何方法或属性），以便所有 20 个类在一个屏幕上方便且清晰地显示。

但是，我无法找到隐藏除类名之外的所有内容的方法。相反，当我发现一个选项（在 Enterprise Architect 中）似乎它可能隐藏除类名之外的所有内容时，由于某种原因，这些元素都在类图中消失了，并且没有重复这些步骤以及删除和重新添加包使类图重新出现。

注意：我的 C++ 代码（至少是我选择导入 Enterprise Architect 的那些文件）只有大约 20 个类。

遗憾的是，对这两个程序的文档进行非常仔细的搜索只能提供一般性信息——据我所知，没有给出关于这两个程序的逆向工程的具体说明。

如果有人能告诉我创建清晰、易于导航的图表的基本步骤，我将不胜感激。仅显示类名的逆向工程（即 C++ 到 UML），因此使用 Enterprise Architect 或 Rational Software Architect 或任何其他工具，可以在一个屏幕上（清晰地）显示大约 20 个类这样做（我建议 EA 和 Rational 只是因为它们已在其他 StackOverflow 答案中被强调为可用于此目的的最佳程序）。

Answer 1

此答案适用于 EA。

您可以递归地或不递归地导入单个文件或整个目录。目录导入是迄今为止最常见的情况；单个文件导入不允许您自动创建图表。

当您导入源目录时，您可以选择为每个 UML 包创建图表，或者根本不创建图表。您还可以决定是否为每个源代码目录、命名空间（默认）或文件创建包。

如果您的代码仅包含 20 个类，那么它们很可能位于单个目录和/或命名空间中，因此请尝试使用该选项（“导入源”对话框中的“包结构”）以获得正确数量的图表。

在同一个对话框中，有一个“新建图表选项”按钮，它会打开另一个配置对话框，您可以在其中选择图表是否应包含类的属性和/或操作。您还可以在可见性的基础上做出决定，例如仅显示公共成员。

此对话框仅影响创建时图表中显示的内容。成员仍然被导入，只是没有显示。这听起来像你所追求的。

您可以通过双击任何图表的空白区域或右键单击并选择“属性”来更改任何图表的显示选项。听起来你进入了这个对话框并改变了一些东西，但我真的不知道是什么。您所描述的情况，您无法将显示恢复到原来的状态，这不是我在 EA 中遇到过的情况。

还可以通过在图表中右键单击它并选择功能可见性来为每个类选择显示选项。我不建议你在逆向工程图中使用它，我只是为了完整性而提及它。

您描述的布局，所有类都在无意义的对角线中，这向我表明该图表在创建后没有正确布局。图表创建是一个两步过程；首先将所有类放到上面，然后应用布局。

这很奇怪，因为 EA 会自动布置生成的图表，而我无法找到允许您取消选择此行为的选项。如果这种情况持续存在，请向 Sparx Systems 发送错误报告。您始终可以通过打开图表并从顶层图表菜单中选择布局图表来布置图表。

最后，如果您的类分布在不同的包和命名空间中，以便 EA 为它们生成多个图表，您将不得不手动合并它们。为此，请打开两个图表，在其中一个中选择所有 (Ctrl-A)，复制 (Ctrl-C) 并粘贴 (Ctrl-V) 到另一个，然后让 EA 再次布局图表。

所以：

1. 在项目浏览器中右键单击一个空包，选择代码工程-导入源目录。
2. 在对话框中，选择根目录和源类型。
3. 勾选“为每个包创建逻辑图”并选择最适合您的源结构的包结构。
4. 点击“新建图表选项”并在新对话框中取消选中“显示属性”、“显示操作”和“显示属性方法”（如果适用）。
5. 确定两个对话框。
6. 如果已创建多个图表，请将所有类复制到一个图表中。
7. 如果布局看起来很糟糕，请选择图表 - 布局图。

希望这会有所帮助。