Java SpringBoot将Word文档转为PDF的全流程解析

目录

• 一、需求分析
• 二、技术选型
• 三、Spring Boot 整合
• 四、代码实现
• 五、总结

今天产品丢给我一个需求，说用户希望在系统里上传 Word 文档，然后能一键转成 PDF 格式。好家伙，乍一听还挺简单，但仔细想想，这需求门道可不少。咱们一点点来拆解。

一、需求分析

首先，用户说的 “Word 文档” 其实挺宽泛的。Word 文档有.doc和.docx两种常见格式，.doc是老版本的二进制格式，.docx是基于 XML 的压缩格式，处理方式完全不一样。另外，文档里可能有图片、表格、公式、超链接，甚至还会有页眉页脚，这些内容在转换过程中都得保证原样显示，不能丢东西、乱排版。

还有，从系统角度看，得考虑转换效率和稳定性。要是用户上传个几十 MB 的大文档，转换半天没反应，或者直接把服务器搞崩了，那肯定不行。最后，还得做好异常处理，比如文档格式不对、文件损坏，这些情况都得给用户友好的提示。

二、技术选型

明确需求后，就得找趁手的工具了。在 Java 里，能android把 Word 转 PDF 的工具还真不少。

第一个想到的是 Apache POI，它能读写 Word 文档，但是它主要侧重于文档内容的操作，直接转 PDF 还得配合其他库，有点麻烦，而且对复杂格式支持不太好，就先 pass 掉。

然后是 ASPose.Words，这个库功能超强大，几乎能完美支持所有 Word 格式和元素，转换效果也很好。但它是收费的，要是公司预算充足，其实是个不错的选择。

最后，我盯上了 Docx4j。它是开源的，对.docx格式支持特别好，转换 PDF 也很方便，社区资料也多，遇到问题能找到不少解决方案。虽然对老版本.doc支持差点，但现在主流都是.docx，权衡之下，就它了！

三、Spring Boot 整合

确定用 Docx4j 后，就开始把它集成到 Spring Boojst 项目里。

先打开pom.xml文件，加依赖：

<dependency>
    <groupId>org.docx4j</groupId>
    <artifactId>docx4j</artifactId>
    <version>8.3.3</version>
</dependency>
<dependency>
    <groupId>org.docx4j</groupId>
    <artifactId>docx4j-export-fo</artifactId>
    <version>8.3.3</version>
</dependency>

第一个依赖是 Docx4j 的核心库，第二个是用来把 Word 文档转成 PDF 的模块。加完依赖，Maven 会自动把需要的 jar 包下载下来。

四、代码实现

接下来就是写代码了，咱们新建一个工具类WordToPdTFFdnKUUfConverter：

import org.docx4j.Docx4J;
import org.docx4j.fonts.IdentityPlusMapper;
import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
import org.docx4j.openpackaging.parts.WordprocessingML.MainDocumentPart;
import org.docx4j.pdf2htmlEx.PdfSettings;
import org.docx4j.utils.fonts.FontUtils;
import java.io.File;
import java.io.FileOutputStream;
import java.io.OutputStream;
public class WordToPdfConverter {
    public static void convert(String inputFilePath, String outputFilePath) {
        try {
      TFFdnKUU      // 加载Word文档
            WordprocessingMLPackage wordMLPackage = WordprocessingMLPackage.load(new java.io.File(inputFilePath));
            // 处理字体，解决中文乱码问题
            FontUtils.setFontInfo(wordMLPackage);
            IdentityPlusMapper fontMapper = new IdentityPlusMapper();
            fontMapper.put("隶书", "LiSu");
            fontMapper.put("宋体", "SimSun");
            fontMapper.put("黑体", "SimHei");
            fontMapper.put("楷体", "KaiTi");
            wordMLPackage.setFontMapper(fontMapper);
            // 获取文档的主部分
            MainDocumentPart documentPart = wordMLPackage.getMainDocumentPart();
            // 创建PDF设置
            PdfSettings pdfSettings = new PdfSettings();
            // 设置字体嵌入，防止在其他设备上显示异常
            pdfSettings.setFontEmbeddingEnabled(true);
            // 执行转换
            OutputStream os = new FileOutputStream(new File(outputFilePath));
            Docx4J.toPDF(wordMLPackage, os, pdfSettings);
            os.close();
            System.out.println("转换成功！");
        } catch (Exception e) {
            e.printStackTrace();
            System.out.println("转换失败：" + e.getMessage());
        }
    }
}

代码解释：

• WordprocessingMLPackage.load方法加载指定路径的 Word 文档。
• 处理字体部分，因为默认可能会出现中文乱码，通过IdentityPlusMapper指定常用中文字体的映射关系。
• PdfSettings用来配置 PDF 转换的参数，这里开启了字体嵌入，这样生成的 PDF 在其他设备上打开，字体也不会错乱。
• 最后用Docx4J.toPDF方法执行转换，把转换后的内容输出到指定的文件路径。

在 Spring Boot 的 Controller 里调用这个方法，就能提供转换接口了：

import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;
import java.io.File;
import java.io.IOException;
import java.util.UUID;
@RestController
@RequestMapping("/convert")
public class WordToPdfController {
    @PostMapping
    public String convertWordToPdf(@RequestParam("file") MultipartFile file) {
        try {
            // 生成临时文件路径
            String originalFilename = file.getOriginalFilename();
            String tempFilePath = System.getProperty("java.io.tmpdir") + File.separator + UUID.randomUUID() + "_" + originalFilenawww.devze.comme;
            file.transferTo(new File(tempFilePath));
            // 生成输出PDF文件路径
            String outputFilePath = System.getProperty("java.io.tmpdir") + File.separator + UUID.randomUUID() + ".pdf";
            // 执行转换
            WordToPdfConverter.convert(tempFilePath, outputFilePath);
            // 返回下载链接或者处理逻辑
            return "转换成功，PDF路径：" + outputFilePath;
        } catch (IOException e) {
            e.printStackTrace();
            return "文件处理失败：" + e.getMessage();
        }
    }
}

在这个 Controller 里，@PostMapping定义了一个接收文件上传的接口。先把上传的文件保存到临时目录，再调用WordToPdfConverter.convert方法进行转换，最后可以根据实际需求，把生成的 PDF 返回给用户下载，或者存到指定位置。

五、总结

到这儿，从接到需求到代码实现，Java 用 Spring Boot 把 Word 转 PDF 的整个流程就走完了。当然，实际项目里还得考虑更多，比如文件存储优化、并发处理、转换进度监控。要是你在做这个功能时遇到啥问题，或者有更好的方案，欢迎一起唠唠！

到此这篇关于Java SpringBoot将Word文档转为PDF的全流程解析的文章就介绍到这了,更多相关SpringBoot Word转PDF内容请搜索编程客栈(www.devze.com)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程客栈(www.devze.com)！