我可以在 企业架构师中使用 c++ 中的反向 egineer 导入 doxygen 标签吗?

Can I import doxygen tags in Enterprise Architect with reverse egineer in c++?

本文关键字:egineer 导入 doxygen 标签 c++ 企业 我可以      更新时间:2023-10-16

我们目前正在评估Enterprise Architect(12,候选版本)。

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

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

现在,EA 的解析器似乎无法识别这些标签。有没有办法启用它?

编辑:我正在寻找的东西不是插入到UML中,而是添加到项目的模型中。例如,由方法的@param标签定义的信息入到方法的"注释"中,而不是插入到参数的"注释"中。生成模型等时不考虑@author doxygen 标签。

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

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

在尝试将此元数据信息生成为 doxygen 样式注释后,我放弃了,因为 doxygen 注释解析器似乎不可自定义,为了使非 ASCII 字符正确导入源代码文件必须包含 UTF-8 BOM 前导码,这不是非常 3rd 方遗留工具友好的编码。

我决定采用生成XMI文件的方式,将所有元数据放置在tagsdocumentation XML元素中。

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

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

  1. 使用逆向工程将C++代码库导入企业架构师
  2. 使用一些工具(如 Doxygen 的GENERATE_XML功能)提取 doxygen 注释元数据
  3. 以往返友好的XMI格式导出企业架构师模型
  4. 编写一个单一用途的工具,该工具将采用XMI模型,您的注释元数据,并吐出带有您的专有信息注释的新XMI模型
  5. 将XMI模型导入回去,完成。

对于步骤3...5,可能有一种更简单的方法,因为Enterprise Architect具有脚本和自动化界面,该接口允许使用Visual BasicC#等语言读取/修改模型