c++ - 我可以在 Enterprise Architect 中使用 C++ 中的逆向工程导入 doxygen 标签吗？

Question

我们目前正在评估 Enterprise Architect(12，发布候选)。

我们想要使用它的主要原因是使用逆向工程功能，从 C++ 到 UML。

我们的代码库是使用 Doxygen 标签记录的。

现在，EA 的解析器似乎无法识别这些标签。有什么方法可以启用它吗？

编辑:我要找的东西不是要插入到UML中，而是要添加到项目的模型中。例如，@param 标签为方法定义的信息被插入到方法的“注释”中，而不是插入到参数的“注释”中。生成模型等时不考虑@author doxygen 标签。

Answer 1

解析器的一些简单的开箱即用定制可能不可用。

我正在解决导入自定义元数据的类似问题(负责类的开发人员、相应的数据库表或 View 映射实体、部署包 (.dll) 和体系结构层、人性化的类描述、对规范文档的引用等。 ) 包含在其他地方，并以非正式注释和正式标记值的形式在 Enterprise Architect 中提供它们。

在尝试将此元数据信息生成为 doxygen 样式注释后，我放弃了，因为 doxygen 注释解析器似乎无法自定义，并且为了使非 ascii 字符正确导入，源代码文件必须包含UTF-8 BOM 前导码，它不是非常适合第 3 方遗留工具的编码。

我决定采用生成 XMI file 的方式所有元数据都放在 tags 和 documentation XML 元素中。

在我解决组合和聚合关系的正确 XMI 编码之前，项目停止在所有类、属性和关联以及所有元模型属性(作为注释和标记值)都在 600 行 C# 中的阶段XMI 特定的代码，我们在 EA 中有几千个类可供分析师使用。

在您的情况下，您可以通过类似的方式解决需求:

1. 使用逆向工程将 C++ 代码库导入 Enterprise Architect
2. 使用 doxygen 的 GENERATE_XML 等工具提取 doxygen 评论元数据特色
3. 以双向友好的 XMI 格式导出 Enterprise Architect 模型
4. 编写一个单一用途的工具，它将采用 XMI 模型、您的评论元数据并吐出用您的专有信息注释的新 XMI 模型
5. 导入 XMI 模型，完成。

对于步骤 3...5，可能有更简单的方法，因为 Enterprise Architect 有 Scripting and Automation允许使用 Visual Basic 或 C#

等语言读取/修改模型的界面