如何在 Java XSLT 处理中正确引用资源目录下的相对路径文件-java教程-PHP中文网

如何在 Java XSLT 处理中正确引用资源目录下的相对路径文件

当使用 getResourceAsStream() 加载 XSLT 文件时，XSLT 引用的默认以应用服务器配置目录为基准路径；需通过 Source.setSystemId() 显式声明基础 URI，才能使相对路径解析指向 classpath 资源目录。

当使用 `getresourceasstream()` 加载 xslt 文件时，xslt 引用的 `` 默认以应用服务器配置目录为基准路径；需通过 `source.setsystemid()` 显式声明基础 uri，才能使相对路径解析指向 classpath 资源目录。

在基于 Java EE（如 Payara 6）的环境中使用 Apache FOP 进行 XSL-FO 转 PDF 时，若主样式表 example.xsl 存于 src/main/resources/（即运行时位于 WEB-INF/classes/），且其内部通过引用同属资源目录的子文件，仅靠 getResourceAsStream() 是不够的——因为 Transformer 在解析 href 时会丢失上下文路径信息，默认回退至服务器工作目录（如 Payara 的 domains/domain1/config/），导致 FileNotFoundException。

✅ 正确做法是：为 StreamSource 显式设置 systemId，使其指向该 XSLT 文件在 classpath 中的完整 URI（如 jar:file:/app.jar!/example.xsl 或 file:/path/to/classes/example.xsl）。这将作为所有相对 href 的解析基准。

以下是修复后的关键代码段（适配 Java 17 + Payara 6 + Apache FOP）：

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

ClassLoader cl = MyClass.class.getClassLoader();
URL xslUrl = cl.getResource("example.xsl");
if (xslUrl == null) {
    throw new IllegalStateException("XSL file 'example.xsl' not found in classpath");
}

String systemId = xslUrl.toURI().toString(); // ✅ 关键：提供绝对 URI 作为 base URI
InputStream styleSheetInput = cl.getResourceAsStream("example.xsl");

// 构建带 systemId 的 Source
StreamSource xslSource = new StreamSource(styleSheetInput);
xslSource.setSystemId(systemId); // ← 必须调用！

TransformerFactory factory = TransformerFactory.newInstance();
Transformer transformer = factory.newTransformer(xslSource); // 使用带 systemId 的 source

// 后续 FOP 流程保持不变
FopFactory fopFactory = FopFactory.newInstance(new File(".").toURI());
FOUserAgent foUserAgent = fopFactory.newFOUserAgent();
try (Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, foUserAgent, outputStream)) {
    Source xmlSource = new StreamSource(datafile);
    Result foResult = new SAXResult(fop.getDefaultHandler());

    transformer.setParameter("versionParam", "2.0");
    transformer.transform(xmlSource, foResult);
}

⚠️ 注意事项：

文件扩展名一致性：确保被包含文件（如 i18n.inc.xsl）与引用中的 href 完全一致（注意 .xsl vs .xslt）。某些构建工具（如 Maven Resources 插件）可能默认过滤非标准扩展名，导致 i18n.inc.xslt 未被打包进 classes/ 目录。
资源路径结构：dir/i18n.inc.xsl 必须实际存在于 src/main/resources/dir/i18n.inc.xsl，编译后路径为 WEB-INF/classes/dir/i18n.inc.xsl。
URI 安全性：xslUrl.toURI() 在含空格或特殊字符的路径下可能抛 URISyntaxException，生产环境建议包裹 try-catch 并降级处理（但通常 classpath 资源 URL 是安全的）。
替代方案（不推荐）：可改用 TransformerFactory.setURIResolver() 自定义解析逻辑，但过度复杂；setSystemId 是最轻量、标准且符合 XSLT 规范的解法。