本文档旨在解决在使用 Docx4j 将 Word 文档转换为 PDF 时，页眉和页脚中的图片被保存在默认的 /tmp 目录下，导致无法有效清理临时文件的问题。文章将阐述该问题的根本原因，并提供一个临时解决方案，即避免在页眉和页脚中使用图片，同时指出该问题已作为 Bug 提交给 Docx4j 官方。
在使用 Docx4j 将 .docx 文件转换为 PDF 格式时，特别是通过 XSL-FO 转换，你可能会遇到一个问题：文档中的图片会被保存在临时文件夹中，通常是 /tmp 目录。这是由于 AbstractConversionImageHandler.java 的默认行为所致，它在 XSL-FO 转换过程中总是会存储图片。
虽然可以通过设置 FOSettings 中的 ImageDirPath 属性来指定图片保存路径，但这个设置对于页眉和页脚中的图片无效。这是因为在计算页眉和页脚区域大小时，FopAreeTreeHelper 使用 FOP 时采用了一些默认设置，导致页眉和页脚中的图片会被保存在默认的 /tmp 目录下。
以下是一个示例代码，展示了如何使用 Docx4j 将 Word 文档转换为 PDF，并尝试设置图片保存路径：
import org.docx4j.Docx4J; import org.docx4j.fonts.Mapper; import org.docx4j.fonts.BestMatchingMapper; import org.docx4j.openpackaging.packages.WordprocessingMLPackage; import org.docx4j.convert.out.FOSettings; import org.docx4j.convert.out.FORendererApacheFOP; import org.apache.fop.apps.FopFactory; import org.apache.fop.apps.FopFactoryBuilder; import org.apache.fop.apps.FOUserAgent; import org.apache.commons.io.FileUtils; import java.io.File; import java.io.OutputStream; public class DocxToPdfConverter { private static final String TEMP_IMAGE_DIR_PATH = "/tmp/images"; public static void convert(WordprocessingMLPackage wordMLPackage, OutputStream output) throws Exception { Mapper fontMapper = new BestMatchingMapper(); wordMLPackage.setFontMapper(fontMapper); FOSettings foSettings = new FOSettings(wordMLPackage); foSettings.setApacheFopMime("application/pdf"); foSettings.setImageDirPath(TEMP_IMAGE_DIR_PATH); foSettings.setFoDumpFile(null); FopFactoryBuilder fopFactoryBuilder = FORendererApacheFOP.getFopFactoryBuilder(foSettings) ; FopFactory fopFactory = fopFactoryBuilder.build(); FOUserAgent foUserAgent = FORendererApacheFOP.getFOUserAgent(foSettings, fopFactory); Docx4J.toFO(foSettings, output, Docx4J.FLAG_EXPORT_PREFER_XSL); // Clean up, so any ObfuscatedFontPart temp files can be deleted if (wordMLPackage.getMainDocumentPart().getFontTablePart()!=null) { wordMLPackage.getMainDocumentPart().getFontTablePart().deleteEmbeddedFontTempFiles(); } foSettings = null; wordMLPackage = null; FileUtils.deleteDirectory(new File(TEMP_IMAGE_DIR_PATH)); } }
上述代码尝试将文档主体中的图片保存到 TEMP_IMAGE_DIR_PATH 目录，并在转换完成后删除该目录。然而，如前所述，页眉和页脚中的图片仍然会被保存在 /tmp 目录下。
当前解决方案和注意事项：
由于这是 Docx4j 库中的一个 Bug，目前官方尚未提供直接的解决方案。临时解决方案是避免在页眉和页脚中使用图片。
总结：
虽然可以通过 FOSettings 设置图片路径，但该设置对页眉和页脚无效。目前最好的方法是避免在页眉和页脚中使用图片，并关注 Docx4j 官方的更新，以期未来能够修复此问题。 建议在 Docx4j 的 issue 跟踪系统中关注此问题，以便及时获取修复信息。
评论（已关闭）
评论已关闭