Java使用Apache POI处理Word文档与打印实战-代码聚汇网

Java使用Apache POI处理Word文档与打印实战

cyx 22

1. 为什么选择Java处理Word文档打印？

在企业级应用开发中，文档处理是绕不开的刚需场景。作为服务端开发的主力语言，Java在Word文档处理领域有着独特的优势。Apache POI这个老牌开源库已经发展了近20年，其HWPF和XWPF组件对Word文档的读写支持相当成熟。相比其他方案，Java+POI的组合特别适合需要批量处理、服务端静默打印等企业级需求。

我经历过一个政务项目，需要每天凌晨自动生成5000份带公章的红头文件并发送到各科室打印机。当时比较了Python、PHP等方案后，最终选择Java实现的核心原因有三点：首先是内存控制精准，通过流式API可以处理超大型文档；其次是线程安全有保障，多线程批量生成不会出现文档损坏；最后是与现有JavaEE系统无缝集成，不需要额外部署运行环境。

实际开发中要注意：不同版本的Word文件格式差异很大，.doc（97-2003）和.docx（2007+）需要分别使用HWPF和XWPF组件处理

2. 基础环境搭建与POI配置

2.1 开发环境准备

推荐使用Maven构建项目，在pom.xml中添加最新版POI依赖。当前稳定版本是5.2.3，但要注意从4.1.2开始需要额外引入poi-ooxml-full处理.docx文件：

xml复制<dependencies>
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi</artifactId>
        <version>5.2.3</version>
    </dependency>
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml-full</artifactId>
        <version>5.2.3</version>
    </dependency>
</dependencies>

如果遇到Lombok兼容性问题（如热词中提到的"you aren't using a compiler supported by lombok"），建议升级到最新版Lombok或暂时移除相关注解。

2.2 打印服务检测

在Windows环境下，需要通过PrintServiceLookup获取可用打印机列表。这段代码可以检查默认打印机是否就绪：

java复制import javax.print.PrintService;
import javax.print.PrintServiceLookup;

public class PrinterCheck {
    public static void main(String[] args) {
        PrintService defaultPrinter = PrintServiceLookup.lookupDefaultPrintService();
        if(defaultPrinter == null) {
            System.err.println("未检测到默认打印机");
        } else {
            System.out.println("默认打印机: " + defaultPrinter.getName());
        }
    }
}

3. Word文档生成实战

3.1 创建基础文档

先看一个创建包含表格、段落和样式的完整示例。这段代码生成带公司LOGO的公文头：

java复制XWPFDocument doc = new XWPFDocument();

// 添加标题段落
XWPFParagraph title = doc.createParagraph();
title.setAlignment(ParagraphAlignment.CENTER);
XWPFRun titleRun = title.createRun();
titleRun.setText("年度技术报告");
titleRun.setBold(true);
titleRun.setFontSize(18);

// 创建带边框的表格
XWPFTable table = doc.createTable(3, 2);
table.setWidth("100%");
CTTblPr tblPr = table.getCTTbl().getTblPr();
tblPr.addNewTblBorders().addNewBottom().setVal(STBorder.SINGLE);

// 填充表格内容
table.getRow(0).getCell(0).setText("项目名称");
table.getRow(0).getCell(1).setText("Java打印系统");
// 更多行...

3.2 样式处理技巧

很多开发者会遇到格式混乱的问题，特别是从HTML或Markdown转换时（如热词中的"java markdown转word"需求）。POI的样式继承机制需要特别注意：

先创建样式再应用，不要重复创建
表格样式要设置Borders对象才会生效
中文乱码问题可通过统一设置字体解决：

java复制XWPFRun run = paragraph.createRun();
run.setFontFamily("宋体");

4. 打印控制核心逻辑

4.1 静默打印实现

企业级应用通常需要后台静默打印，这段代码演示了不弹出打印对话框直接输出：

java复制DocFlavor flavor = DocFlavor.BYTE_ARRAY.AUTOSENSE;
PrintRequestAttributeSet attrs = new HashPrintRequestAttributeSet();
attrs.add(new Copies(1)); // 设置份数

// 转换文档为打印格式
ByteArrayOutputStream out = new ByteArrayOutputStream();
doc.write(out);
byte[] bytes = out.toByteArray();

// 获取打印机服务
PrintService service = PrintServiceLookup.lookupDefaultPrintService();
DocPrintJob job = service.createPrintJob();
job.print(new SimpleDoc(bytes, flavor, null), attrs);

4.2 打印异常处理

实际部署中最常遇到三类问题：

内存不足（对应热词中的"java: outofmemoryerror"）
打印机离线
文档格式损坏

建议采用这样的异常处理结构：

java复制try {
    // 打印逻辑
} catch (PrintException e) {
    if(e.getMessage().contains("PrinterNotResponding")) {
        // 重试逻辑
    }
} catch (OutOfMemoryError err) {
    // 启用大内存模式处理
    System.gc();
    // 使用XWPFEventBasedParser处理大文件
} finally {
    doc.close();
}

5. 高级应用场景

5.1 批量打印方案

对于需要批量处理的情况（如热词中的"小升初简历模版word"场景），建议采用生产者-消费者模式：

java复制ExecutorService executor = Executors.newFixedThreadPool(4);
BlockingQueue<File> queue = new LinkedBlockingQueue<>(100);

// 生产者线程
new Thread(() -> {
    while(hasMoreFiles()) {
        queue.put(renderTemplate());
    }
}).start();

// 消费者线程
for(int i=0; i<4; i++) {
    executor.submit(() -> {
        while(true) {
            printDocument(queue.take());
        }
    });
}

5.2 与前端集成

现代应用常需要与Web结合（如热词中的"vue项目 word在线编辑"）。推荐两种方案：

服务端生成下载链接：

java复制@GetMapping("/export")
public void exportWord(HttpServletResponse response) throws IOException {
    response.setContentType("application/vnd.openxmlformats-officedocument.wordprocessingml.document");
    response.setHeader("Content-Disposition", "attachment; filename=report.docx");
    XWPFDocument doc = generateDocument();
    doc.write(response.getOutputStream());
}

使用docx.js等前端库实现预览：

javascript复制// Vue组件中
import { renderAsync } from 'docx-preview';

export default {
  methods: {
    async preview() {
      const res = await axios.get('/api/doc/template');
      renderAsync(res.data, this.$refs.container);
    }
  }
}

6. 性能优化实践

6.1 内存管理技巧

处理大文档时（如热词中的"伪word文档"检测场景），一定要使用流式API：

java复制try (OPCPackage pkg = OPCPackage.open(largeFile)) {
    XWPFDocument doc = new XWPFDocument(pkg);
    // 使用SAX解析器逐段处理
    XWPFWordExtractor extractor = new XWPFWordExtractor(doc);
    String text = extractor.getText();
    // 避免全文档DOM操作
}

6.2 缓存策略

对于模板类文档（如合同、报表），建议预编译样式：

java复制public class DocumentTemplate {
    private static XWPFDocument TEMPLATE;
    
    static {
        try(InputStream is = Resources.getResourceAsStream("template.docx")) {
            TEMPLATE = new XWPFDocument(is);
        }
    }
    
    public XWPFDocument createDocument() {
        // 克隆模板而非重新解析
        return TEMPLATE.clone();
    }
}

7. 常见问题解决方案

7.1 格式错乱排查

当遇到热词中提到的"word 保存时容易卡"类似问题时，通常有三个排查方向：

检查文档复杂度（页数、对象数量）
验证打印机驱动是否最新
分析文档XML结构（解压.docx后检查document.xml）

7.2 跨平台问题

在Linux服务器部署时，需要额外配置：

bash复制# 安装基础字体
sudo apt install ttf-mscorefonts-installer
# 设置打印服务
sudo apt install cups

对于Mac环境（如热词中的"mac中word文件图标不是word"），要注意文件关联问题：

java复制// 显式设置MIME类型
attributes.add(new ContentType("application/vnd.openxmlformats-officedocument.wordprocessingml.document"));

我在金融项目迁移到国产化环境时，发现WPS与MS Office的兼容性问题。最终通过对比两种软件生成的document.xml，定位到是页码样式定义差异导致的。这类问题建议使用OpenOffice提供的兼容性验证工具提前检测。