Java中XSLT资源相对路径解析问题的完整解决方案-java教程-PHP中文网

Java中XSLT资源相对路径解析问题的完整解决方案

在Java Web应用（如Payara 6）中使用XSLT时，的相对路径默认以应用服务器配置目录（如GlassFish/Payara的config/）为基准，而非类路径资源位置；正确设置StreamSource.setSystemId()可强制解析器以资源URI为基址解析引用文件。

在java web应用（如payara 6）中使用xslt时，`` 的相对路径默认以应用服务器配置目录（如glassfish/payara的`config/`）为基准，而非类路径资源位置；正确设置`streamsource.setsystemid()`可强制解析器以资源uri为基址解析引用文件。

在基于Java EE/Jakarta EE的Web应用中（例如使用Payara 6部署的项目），当通过ClassLoader.getResourceAsStream("example.xsl")加载XSLT样式表后，若该XSLT内含等相对引用，JAXP默认不会以类路径（classpath）为解析基准——而是退回到JVM当前工作目录或应用服务器的全局配置路径（如$PAYARA_HOME/glassfish/domains/domain1/config/），导致FileNotFoundException，正如你遇到的错误：

/usr/local/payara6/glassfish/domains/domain1/config/dir/i18n.inc.xslt (No such file or directory)

根本原因在于：Transformer在解析或时，需依赖Source对象的systemId（即逻辑URI）来确定相对路径的解析起点。而new StreamSource(InputStream)构造的实例默认systemId == null，此时XSLT处理器会使用实现默认的“base URI”，通常指向不安全的外部路径。

✅ 正确解法：显式设置systemId为资源的绝对URI

// ✅ 关键步骤：获取资源的URI，并设为StreamSource的systemId
URL xslUrl = MyClass.class.getClassLoader().getResource("example.xsl");
if (xslUrl == null) {
    throw new IllegalStateException("XSLT resource 'example.xsl' not found in classpath");
}
String systemId = xslUrl.toURI().toString(); // e.g., "jar:file:/app.jar!/example.xsl" or "file:/path/to/classes/example.xsl"

InputStream styleSheetInput = xslUrl.openStream();
StreamSource source = new StreamSource(styleSheetInput);
source.setSystemId(systemId); // ← 核心！告知XSLT处理器解析相对路径的基准URI

TransformerFactory factory = TransformerFactory.newInstance();
Transformer transformer = factory.newTransformer(source);

? 补充注意事项：

文件扩展名一致性：XSLT处理器（尤其是Apache FOP集成环境）对.xsl与.xslt扩展名敏感。若资源未被正确打包进WEB-INF/classes/或JAR的根路径，请统一使用.xsl（如将i18n.inc.xslt重命名为i18n.inc.xsl），并确保其位于src/main/resources/dir/i18n.inc.xsl（Maven结构），这样构建后能正确出现在类路径dir/i18n.inc.xsl位置。

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

下载

资源路径验证：建议在运行时校验资源是否可访问：

Objects.requireNonNull(xslUrl, "example.xsl must be present in classpath");
Objects.requireNonNull(MyClass.class.getClassLoader()
    .getResource("dir/i18n.inc.xsl"), "Included file dir/i18n.inc.xsl missing");

避免硬编码路径：切勿使用new File(".")或System.getProperty("user.dir")作为FOP基础路径——这与XSLT资源定位无关，且破坏可移植性。FopFactory.newInstance()应配合URI参数使用（如FopFactory.newInstance(getClass().getResource("/").toURI())），但本场景中systemId已足够解决包含问题。
进阶建议（生产环境）：对于复杂XSLT工程，可考虑自定义URIResolver，实现更灵活的资源加载逻辑（如从数据库或远程存储读取片段），但对大多数场景，setSystemId()已是简洁、标准且跨JDK/XSLT引擎（Xalan、Saxon）兼容的方案。