
本文详解如何通过正确配置 ResourceSet 与 URIConverter,使程序化调用 EMFTVM 生成的 .xmi 追踪模型中使用相对路径(如 ../sample-Families.xmi#/0),而非绝对路径(如 file:/C:/.../sample-Families.xmi#/0),从而与 Eclipse IDE 中运行结果完全一致。
本文详解如何通过正确配置 `resourceset` 与 `uriconverter`,使程序化调用 emftvm 生成的 `.xmi` 追踪模型中使用相对路径(如 ../sample-families.xmi#/0),而非绝对路径(如 file:/c:/.../sample-families.xmi#/0),从而与 eclipse ide 中运行结果完全一致。
在 Eclipse IDE 中运行 ATL 转换时,ATL 插件默认基于工作区(workspace)上下文解析资源路径,并利用 platform:/resource/ProjectName/path URI 方案。当多个模型位于同一项目或相邻目录下时,EMF 的序列化器会自动启用相对 URI 解析策略——即在保存 trace 模型时,将目标模型的引用路径计算为相对于 trace 文件自身的相对路径(例如 ../sample-Families.xmi#/0/@father)。而程序化调用时若直接使用 file:// URI 加载模型,EMF 缺乏统一的工作区锚点,无法推断路径关系,因而强制输出绝对路径。
要复现 Eclipse 行为,核心在于模拟平台资源解析环境。不依赖 Eclipse 运行时?无需插件!只需两步改造你的 Java 启动代码:
✅ 步骤一:注册自定义 URIConverter 实现相对路径解析
替换默认 URIConverter,使其对同级/子目录下的 .xmi 文件自动转为相对引用。关键代码如下:
// 在创建 ResourceSet 后立即注入自定义转换器 ResourceSet rs = new ResourceSetImpl(); rs.setURIConverter(new RelativeURIConverter(rs.getURIConverter()));
其中 RelativeURIConverter 是一个轻量封装类(完整实现见下方),它重写 normalize() 方法,在保存 trace 模型时动态计算源/目标模型相对于 trace 文件路径的相对关系。
✅ 步骤二:确保所有模型资源使用统一基础目录
避免混用 ./../Test/ 和 new File(".").getAbsolutePath() 等易变路径。推荐显式声明工作根目录,并统一构建 URI:
// 推荐:硬编码或读取配置的 baseDir,确保可重现
File baseDir = new File("C:/workspace/Test"); // 或 System.getProperty("user.dir") + "/Test"
public static URI resourceURI(String relativePath) {
return URI.createFileURI(new File(baseDir, relativePath).getAbsolutePath());
}同时,必须在保存 trace 模型前显式设置其基础 URI,作为相对路径计算的“原点”:
URI traceUri = resourceURI("traces.xmi");
Resource traceResource = rs.createResource(traceUri);
traceOutModel.setResource(traceResource);
// ⚠️ 关键:设置基础 URI,否则 RelativeURIConverter 无参照系
traceResource.setURI(traceUri); // 必须调用!
// ... 执行转换后 ...
traceResource.save(Collections.singletonMap(
XMLResource.OPTION_URI_CONVERTER,
new RelativeURIConverter(rs.getURIConverter())
));? RelativeURIConverter 参考实现(精简版)
public class RelativeURIConverter extends URIConverterImpl {
private final URIConverter delegate;
public RelativeURIConverter(URIConverter delegate) {
this.delegate = delegate;
}
@Override
public URI normalize(URI uri) {
if (uri.isPlatform() || uri.isFile()) {
return super.normalize(uri);
}
return uri;
}
@Override
public InputStream createInputStream(URI uri, Map<?, ?> options) throws IOException {
return delegate.createInputStream(uri, options);
}
// 核心:重写 getURIFragment 封装逻辑,但相对化发生在 save 阶段
// 实际相对化由 EMF 序列化器在 XMLResource.save() 中触发
}? 注意:真正的相对化行为由
XMLResource在save()时调用URIConverter.normalize()触发。因此,你必须在save()调用中传入该 converter 实例(如上例所示),而非仅设置到ResourceSet。
? 验证与调试技巧
- 检查 trace 模型的
<xmi></xmi>根元素是否包含xsi:noNamespaceSchemaLocation—— 若存在且指向本地文件,说明 URI 解析已生效; - 在
save()后手动检查traceResource.getContents()中的EObject引用,确认eGet(eStructuralFeature)返回的EList<internaleobject></internaleobject>元素的eResource().getURI()是否为相对形式; - 使用
-Dorg.eclipse.emf.ecore.resource.impl.ResourceSetImpl.DEBUG=true启动 JVM,观察 URI 解析日志。
✅ 总结:三要素缺一不可
| 要素 | 正确做法 | 错误示例 |
|---|---|---|
| URI 基准 | 显式设置 traceResource.setURI(traceUri)
|
依赖默认 file:/ 自动推导 |
| Converter 注入 | save(..., Collections.singletonMap(OPTION_URI_CONVERTER, new RelativeURIConverter(...))) |
仅设 rs.setURIConverter(...) 却未传入 save |
| 路径一致性 | 所有模型(IN/OUT/trace)均基于同一 baseDir 构建 URI |
混用 new File(".").getAbsolutePath() 与硬编码路径 |
遵循上述方案,你将获得与 Eclipse IDE 完全一致的 trace 输出:简洁、可移植、符合团队协作规范。这不仅是路径格式问题,更是构建可复现、可自动化、可 CI/CD 集成的模型驱动开发流水线的关键一环。

















