如何通过Enterprise Architect Java API获取模型内所有层级用例图?
跨层级获取全量模型图表的实现方案
有成熟可落地的实现方案,完全不需要顺着模型层级逐节点递归查找,核心依托EA Java API对全局仓储的直读能力实现。
核心原理
EA模型的所有图表在存储层是独立的仓储实体,每个Diagram对象仅通过GUID关联所属的父级模型节点(可以是包、用例、类等任意模型元素),不要求必须从父节点位置出发才能检索到图表。EA Java API封装的仓储层提供了全局范围的图表查询入口,天然不受图表所在的模型层级位置限制。
具体实现步骤
- 完成EA Java API的初始化,获取全局
Repository实例,建立和当前打开模型仓库的连接 - 直接调用Repository实例的
getDiagrams()方法,拉取仓库内存储的全部Diagram实体集合,该返回结果覆盖模型任意位置下的所有图表,包括嵌套子包、元素内嵌的图表,无需自行逐层遍历模型树节点检索下属图表 - 按目标图表类型做结果过滤:遍历全量图表集合,读取每个Diagram的
getType()属性值匹配目标类型即可- 用例图对应的类型固定值为
"UseCase" - 如果需要获取模型内任意类型的全部图表,跳过过滤步骤直接使用全量集合即可
- 用例图对应的类型固定值为
参考实现代码
// 基于已初始化完成的Repository实例操作 List<Diagram> allModelDiagrams = repository.getDiagrams(); List<Diagram> matchedUseCaseDiagrams = new ArrayList<>(); for (Diagram diagram : allModelDiagrams) { // 仅保留用例图类型的条目 if ("UseCase".equalsIgnoreCase(diagram.getType())) { matchedUseCaseDiagrams.add(diagram); // 后续可读取diagram的属性、关联关系完成业务逻辑 } }
注意事项
- 不推荐采用“逐层遍历所有Package节点、递归读取每个节点下属Diagrams”的实现方式:该方式不仅检索效率低,还容易漏掉附着在非包类元素下的图表,直接调用Repository级别的
getDiagrams()得到的是仓储全量权威结果 - 如果后续需要定位每个图表所在的模型层级位置,可通过Diagram对象携带的父级属性GUID,反查对应的父模型元素,不需要在检索图表阶段提前遍历模型树定位路径
- 面对超大规模模型场景,若直接拉取全量Diagram实体存在内存压力,可先通过仓储的全局GUID查询接口拿到所有Diagram的GUID列表,再按需逐个加载Diagram实体,降低内存占用
内容的提问来源于stack exchange,提问作者BIndu_Madhav
相关产品推荐
相关产品推荐

