Java利用Apache POI实现多模板Word文档生成的示例代码

 更新时间:2025年07月14日 08:45:53   作者:自由的疯  
当 Word 模板文档的内容是复杂表单时,处理方式会比普通文字更复杂一些,但依旧可以借助 Apache POI 库来完成,以下是详细的处理思路和示例代码,需要的朋友可以参考下

处理思路

  1. 识别表单元素:复杂表单里可能包含表格、文本框、下拉框等元素。你需要对这些元素进行识别,并且明确要替换内容的位置。
  2. 替换表格内容:对于表格,要定位到具体的单元格,然后对单元格内的内容进行替换。
  3. 处理文本框:文本框也是需要特别处理的元素,要遍历文档中的文本框并替换其中的内容。
  4. 动态赋值:和处理普通文字一样,利用占位符来进行动态赋值。

示例代码

import org.apache.poi.xwpf.usermodel.*;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTBody;

import java.io.*;
import java.util.HashMap;
import java.util.Map;

public class ComplexFormDocGenerator {

    public static void main(String[] args) {
        String[] templatePaths = {"complex_template.docx"};
        String outputPath = "complex_output.docx";
        Map<String, String> values = new HashMap<>();
        values.put("${name}", "李四");
        values.put("${department}", "技术部");

        try {
            generateDocument(templatePaths, outputPath, values);
            System.out.println("文档生成成功,路径为: " + outputPath);
        } catch (IOException e) {
            System.err.println("生成文档时出现错误: " + e.getMessage());
            e.printStackTrace();
        }
    }

    public static void generateDocument(String[] templatePaths, String outputPath, Map<String, String> values) throws IOException {
        XWPFDocument finalDocument = new XWPFDocument();

        for (String templatePath : templatePaths) {
            try (FileInputStream templateStream = new FileInputStream(templatePath);
                 XWPFDocument templateDocument = new XWPFDocument(templateStream)) {

                replacePlaceholders(templateDocument, values);
                appendDocument(finalDocument, templateDocument);
            }
        }

        try (FileOutputStream outputStream = new FileOutputStream(outputPath)) {
            finalDocument.write(outputStream);
        }
    }

    private static void replacePlaceholders(XWPFDocument document, Map<String, String> values) {
        // 处理段落中的占位符
        for (XWPFParagraph paragraph : document.getParagraphs()) {
            for (XWPFRun run : paragraph.getRuns()) {
                String text = run.getText(0);
                if (text != null) {
                    for (Map.Entry<String, String> entry : values.entrySet()) {
                        text = text.replace(entry.getKey(), entry.getValue());
                    }
                    run.setText(text, 0);
                }
            }
        }

        // 处理表格中的占位符
        for (XWPFTable table : document.getTables()) {
            for (XWPFTableRow row : table.getRows()) {
                for (XWPFTableCell cell : row.getTableCells()) {
                    for (XWPFParagraph paragraph : cell.getParagraphs()) {
                        for (XWPFRun run : paragraph.getRuns()) {
                            String text = run.getText(0);
                            if (text != null) {
                                for (Map.Entry<String, String> entry : values.entrySet()) {
                                    text = text.replace(entry.getKey(), entry.getValue());
                                }
                                run.setText(text, 0);
                            }
                        }
                    }
                }
            }
        }

        // 处理文本框中的占位符(POI 对文本框处理有限,可结合其他库)
        // 这里仅简单示例,实际可能需要更复杂逻辑
        // 可以使用 docx4j 等库来更好地处理文本框
        for (IBodyElement element : document.getBodyElements()) {
            if (element instanceof XWPFSDT) {
                XWPFSDT sdt = (XWPFSDT) element;
                for (XWPFParagraph paragraph : sdt.getContent().getParagraphs()) {
                    for (XWPFRun run : paragraph.getRuns()) {
                        String text = run.getText(0);
                        if (text != null) {
                            for (Map.Entry<String, String> entry : values.entrySet()) {
                                text = text.replace(entry.getKey(), entry.getValue());
                            }
                            run.setText(text, 0);
                        }
                    }
                }
            }
        }
    }

    private static void appendDocument(XWPFDocument mainDocument, XWPFDocument appendDocument) throws IOException {
        CTBody mainBody = mainDocument.getDocument().getBody();
        CTBody appendBody = appendDocument.getDocument().getBody();

        for (Object object : appendBody.getContent()) {
            mainBody.addNewP().set(object);
        }
    }
}

代码解释

  1. ​main​方法:和处理普通文字的示例类似,定义了模板文件路径、输出文件路径以及动态赋值的内容,然后调用 ​​generateDocument​​ 方法生成文档。
  2. ​generateDocument​方法:循环读取每个模板文件,对其进行动态赋值,再将内容追加到最终文档里,最后把最终文档写入输出文件。
  3. ​replacePlaceholders​方法
  • 处理段落:和普通文字处理一样,遍历文档中的段落和运行对象,把占位符替换成实际的值。
  • 处理表格:遍历文档中的所有表格,再遍历表格的行和单元格,对单元格内的段落和运行对象进行占位符替换。
  • 处理文本框:使用 ​​XWPFSDT​​​ 来识别文本框,遍历文本框内的段落和运行对象,进行占位符替换。不过 Apache POI 对文本框的处理能力有限,实际应用中可能需要结合 ​​docx4j​​ 等其他库。
  1. ​appendDocument​方法:将一个文档的内容追加到另一个文档中。

注意事项

  • 要保证 ​​complex_template.docx​​ 文件存在于项目的根目录下,或者根据实际情况修改文件路径。
  • 运行代码前,要确保项目中已经正确引入了 Apache POI 的依赖。
  • 对于复杂的表单元素,如下拉框、复选框等,可能需要更复杂的处理逻辑,你可以结合 ​​docx4j​​ 等库来实现。

到此这篇关于Java利用Apache POI实现多模板Word文档生成的示例代码的文章就介绍到这了,更多相关Java Apache POI多模板Word生成内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java中调用第三方接口的详细代码示例

    Java中调用第三方接口的详细代码示例

    这篇文章主要介绍了Java中调用第三方接口的详细代码示例,文章总结了多种Java进行HTTP请求的方法,每种方法都有其特点和适用场景,从原生到封装,再到声明式客户端,满足了不同复杂度的HTTP请求需求,需要的朋友可以参考下
    2024-12-12
  • 在SpringBoot中更改默认端口的方法总结

    在SpringBoot中更改默认端口的方法总结

    在本文中,小编将带大家学习如何在 Spring Boot 中更改默认端口,默认情况下,嵌入式 Web 服务器使用 8080端口来启动 Spring 引导应用程序,有几种方法可以更改该端口,文中介绍的非常详细,需要的朋友可以参考下
    2023-07-07
  • 浅谈JAVA在项目中如何自定义异常

    浅谈JAVA在项目中如何自定义异常

    今天给大家带来的是关于Java的相关知识,文章围绕着JAVA在项目中如何自定义异常展开,文中有非常详细的介绍及代码示例,需要的朋友可以参考下
    2021-06-06
  • 老生常谈设计模式之动态代理

    老生常谈设计模式之动态代理

    下面小编就为大家带来一篇老生常谈设计模式之动态代理。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-06-06
  • springboot整合Nacos组件环境搭建和入门案例详解(最新推荐)

    springboot整合Nacos组件环境搭建和入门案例详解(最新推荐)

    本文介绍了Nacos的基础概念、关键特性、专业术语和生态圈,如何在Windows环境下搭建Nacos单个服务,以及如何整合SpringBoot2来使用Nacos进行服务注册和配置管理,感兴趣的朋友一起看看吧
    2025-03-03
  • Java实现Token工具类进行登录和拦截

    Java实现Token工具类进行登录和拦截

    在应用的登录时需要生成token进行验证,并放入信息,之后的话可以直接使用浏览器的session进行登录,本文就来利用java编写一个token工具类,可以很方便的生成和解析token,感兴趣的可以了解下
    2023-12-12
  • springboot连接oracle全流程

    springboot连接oracle全流程

    这篇文章主要介绍了springboot连接oracle全流程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-03-03
  • 小米推送Java代码

    小米推送Java代码

    今天小编就为大家分享一篇关于小米推送Java代码,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
    2019-01-01
  • 运行jar程序时添加vm参数的方法

    运行jar程序时添加vm参数的方法

    下面小编就为大家带来一篇运行jar程序时添加vm参数的方法。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-02-02
  • JVM执行引擎和垃圾回收要点总结

    JVM执行引擎和垃圾回收要点总结

    不论是在问题现场还是跳槽面试,我们面对JVM性能问题,依旧会束手无辞,它需要你对Java虚拟机的实现和优化,有极为深刻的理解。所以我在这里整理了一下 JVM的知识点。今天说说虚拟机执行引擎和垃圾回收,都是十足的干货,请各位看官耐心批阅!
    2021-06-06

最新评论