本文详细阐述了在apache FOP中通过fop.xconf文件配置字体相对路径的有效方法，尤其适用于无法使用fopFactoryBuilder.setFontBaseURL()的旧版本FOP。核心解决方案是利用<base>标签设定基础URI，结合<font embed-url>指定字体文件，确保跨操作系统环境下的字体正确嵌入和渲染，提升应用的可移植性。
Apache FOP字体配置与相对路径挑战
在apache fop（formatting objects processor）中，正确配置字体是生成高质量pdf文档的关键。然而，当应用程序需要在不同操作系统（如windows和linux）上运行时，直接指定绝对路径的字体配置会带来兼容性问题。例如，windows上的c:/windows/fonts/arial.ttf在linux上显然无法找到。为了解决这一问题，使用相对路径来引用字体文件变得尤为重要，通常将字体文件打包到应用程序的资源目录中。
在某些旧版本的FOP中，可能无法通过编程方式（如fopFactoryBuilder.setFontBaseURL()）来设置字体基础URL，这使得在fop.xconf配置文件中直接指定相对路径成为一个挑战。简单地使用<Directory>标签或不带base的相对路径往往不能达到预期效果。
解决方案：利用<base>标签配置相对路径
解决上述问题的关键在于在fop.xconf文件中引入<base>标签，它允许您为配置文件中所有的相对URI（包括字体路径）定义一个基础URL。结合<font embed-url>，可以精确地指定字体文件的位置。
以下是一个配置示例，展示了如何将字体文件（例如Arial.ttf）放置在Java应用程序的src/main/resources/fonts/目录下，并通过fop.xconf正确引用：
<?xml version="1.0" encoding="utf-8" ?> <fop> <!-- 定义所有相对URI的基础路径。 这里的 "." 表示 fop.xconf 文件所在的目录， 或更常见地，应用程序的当前工作目录。 根据实际运行环境，这个路径可能需要调整。 例如，如果FOP从应用的根目录启动，且字体在 app/src/main/resources/fonts/， 则这里的 "." 结合 embed-url 即可正确解析。 --> <base>.</base> <renderers> <renderer mime="application/pdf"> <fonts> <!-- 配置要嵌入的字体 --> <font kerning="yes" embed-url="app/src/main/resources/fonts/Arial.ttf" embedding-mode="subset"> <!-- 定义字体的三元组，用于FO文件中的字体引用 --> <font-triplet name="Arial" style="normal" weight="400"/> </font> <!-- 可选：自动检测系统或指定目录下的字体。 对于精确控制，建议显式定义 <font> 标签。 --> <autodetect/> </fonts> </renderer> </renderers> </fop>
配置解析：
- <base>.</base>: 这是核心。它将FOP解析相对路径的基准点设置为FOP应用程序的当前工作目录。这意味着所有在fop.xconf中指定的相对路径都将以此目录为起点进行解析。
- <font kerning=”yes” embed-url=”app/src/main/resources/fonts/Arial.ttf” embedding-mode=”subset”>:
- embed-url: 这是字体文件的相对路径。它会相对于<base>标签定义的路径进行解析。在上述示例中，如果应用程序的当前工作目录是项目的根目录，那么app/src/main/resources/fonts/Arial.ttf就能正确指向打包在JAR/WAR文件中的字体资源。
- kerning=”yes”: 启用字距调整。
- embedding-mode=”subset”: 仅嵌入字体中实际使用的字符子集，有助于减小PDF文件大小。
- <font-triplet name=”Arial” style=”normal” weight=”400″/>: 定义了字体在XSL-FO文档中被引用时的名称、样式和字重。当FO文档中指定font-family=”Arial”时，FOP会查找这个三元组来匹配并使用配置的字体。
- <autodetect/>: 这是一个可选标签，指示FOP自动检测系统字体目录或<directory>标签指定的目录中的字体。虽然方便，但在需要精确控制和跨平台一致性时，通常更推荐显式定义<font>标签。
注意事项与最佳实践
- base路径的确定: <base>标签的值至关重要。.通常指FOP应用程序的启动目录。在Java Web应用中，这可能是服务器的根目录或部署目录。在独立的Java应用中，则是执行java -jar命令的目录。务必确保embed-url中的相对路径，结合这个<base>路径，能够准确指向字体文件。
- 资源打包: 确保Arial.ttf文件确实被打包到了应用程序的src/main/resources/fonts/目录下。在maven或gradle项目中，这通常意味着该文件会包含在最终的JAR或WAR文件中。
- 路径验证: 如果字体仍然无法找到，请检查FOP的日志输出，通常会有关于字体加载失败的详细信息。同时，手动验证在FOP运行时的当前工作目录，以及字体文件的实际相对路径。
- 字体名称一致性: font-triplet中的name属性应与XSL-FO文档中font-family属性的值保持一致，以确保FOP能够正确匹配和使用字体。
- 跨平台兼容性: 这种方法通过将字体作为应用程序资源的一部分进行管理，并使用相对路径引用，极大地增强了应用程序在不同操作系统环境下的可移植性。
总结
通过在fop.xconf文件中巧妙地使用<base>标签，结合embed-url属性，即使在不支持fopFactoryBuilder.setFontBaseURL()的旧版本Apache FOP中，也能有效地配置字体相对路径。这种方法提供了一种健壮且跨平台兼容的字体管理策略，确保了PDF生成的一致性和可靠性。在配置过程中，理解<base>路径的解析机制和字体资源的打包方式是成功的关键。
