java word 文档生成模板好用的

原创

mob64ca12ebf2cc 2024-08-17 07:15:28 ©著作权

©著作权归作者所有：来自51CTO博客作者mob64ca12ebf2cc的原创作品，请联系作者获取转载授权，否则将追究法律责任

Java Word 文档生成模板指南

在这个指南中，我将教你如何使用 Java 生成 Word 文档的模板。这是一个很有用的技能，广泛应用于商业报告、合同、发票等多种场景。我们将通过以下步骤完成这个任务：

流程步骤

我们可以将整个过程分为以下几个关键步骤：

步骤	描述
1	准备工作：创建 Maven 项目并添加依赖
2	创建 Word 模板文件
3	使用 Java 代码读取模板并生成文档
4	测试生成的文档

flowchart TD
    A[准备工作] --> B[创建 Word 模板]
    B --> C[Java 读取模板]
    C --> D[测试生成的文档]

1. 准备工作

首先，确保你已经安装了 Java 开发工具包（JDK），并且你的开发环境中可以使用 Maven。然后，创建一个新的 Maven 项目，并在 pom.xml 文件中添加 Apache POI 依赖，这个库是处理 Word 文档的工具。

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.0</version>
</dependency>

这段代码的意思是添加 Apache POI 库的依赖，用于支持读取和生成 Word 文档。

2. 创建 Word 模板文件

使用 Microsoft Word 创建一个模板文件（如 template.docx），在需要替换的地方放置占位符，例如 {{name}} 和 {{date}}。这可以在 Word 文档中实现自定义内容的插入。

3. 使用 Java 代码读取模板并生成文档

接下来，我们需编写 Java 代码来读取模板，并替换其中的占位符。以下是代码示例：

import org.apache.poi.xwpf.usermodel.XWPFDocument;
import org.apache.poi.xwpf.usermodel.XWPFParagraph;
import org.apache.poi.xwpf.usermodel.XWPFRun;

import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;

public class WordGenerator {
    public static void main(String[] args) {
        String templatePath = "template.docx"; // 模板文件路径
        String outputPath = "output.docx"; // 输出文件路径
        String name = "张三"; // 替换内容
        String date = "2023年10月30日"; // 替换内容
        
        try {
            // 读取模板文件
            FileInputStream fis = new FileInputStream(templatePath);
            XWPFDocument document = new XWPFDocument(fis); // 创建文档对象
            
            // 遍历段落并替换占位符
            for (XWPFParagraph paragraph : document.getParagraphs()) {
                replacePlaceholder(paragraph, "{{name}}", name);
                replacePlaceholder(paragraph, "{{date}}", date);
            }

            // 写入到输出文件
            FileOutputStream fos = new FileOutputStream(outputPath);
            document.write(fos);
            fos.close();
            document.close();
            fis.close();
            System.out.println("文档生成成功，文件位置：" + outputPath);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    private static void replacePlaceholder(XWPFParagraph paragraph, String placeholder, String value) {
        String text = paragraph.getText(); // 获取段落的文本
        if (text.contains(placeholder)) {
            text = text.replace(placeholder, value); // 替换占位符
            for (XWPFRun run : paragraph.getRuns()) {
                run.setText(text, 0); // 设置新的文本
            }
        }
    }
}

代码说明

导入所需包：导入 Apache POI 包以处理 Word 文档。
主方法：读取 Word 模板，初始化替换的内容（如 name 和 date）。
读取模板文件：通过 FileInputStream 读取模板，并创建文档对象。
替换占位符：遍历段落，找到占位符并替换为实际内容。
输出文件：将结果写入新的 Word 文档，并在控制台输出生成成功的信息。

4. 测试生成的文档

运行主方法，你将会看到新的 Word 文档 output.docx 生成成功，里面的占位符已经被替换为你定义的内容。

类图

为了更清晰地显示我们的项目结构，我们可以绘制一个类图，描述项目中的关键类及其关系。

classDiagram
    class WordGenerator {
        +String templatePath
        +String outputPath
        +String name
        +String date
        +void main(String[] args)
        +void replacePlaceholder(XWPFParagraph paragraph, String placeholder, String value)
    }