使用Java POI生成包含表格的Word文件

在现代软件开发中，自动化生成文档是一个非常实用的需求。Java的Apache POI库提供了一种简单而强大的方法，可以帮助开发者创建和操作Word文档。本文将介绍如何使用POI生成一个包含表格的Word文档，并提供相应的代码示例。

Apache POI简介

Apache POI是一个开源Java库，专门用于处理Microsoft Office格式的文档，包括Excel、Word和PowerPoint。通过POI，开发者可以轻松地读取和写入这些文档，而不需要依赖Microsoft Office。

环境配置

在使用Apache POI之前，你需要将其加入到你的Java项目中。可以通过Maven进行依赖管理，在pom.xml中添加以下依赖：

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

创建Word文档并添加表格

我们将创建一个简单的Word文档，在其中添加一个表格。以下是实现的步骤：

  1. 创建一个Word文档实例。
  2. 创建一个表格。
  3. 填充表格数据。
  4. 保存文档。

以下是完整的代码示例：

import org.apache.poi.xwpf.usermodel.*;

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

public class WordTableExample {
    public static void main(String[] args) {
        XWPFDocument document = new XWPFDocument();
        
        // 创建表格
        XWPFTable table = document.createTable(3, 3);

        // 设置表格标题
        String[] headers = {"姓名", "年龄", "城市"};
        for (int i = 0; i < headers.length; i++) {
            table.getRow(0).getCell(i).setText(headers[i]);
        }

        // 填充数据
        String[][] data = {
                {"张三", "25", "北京"},
                {"李四", "30", "上海"},
                {"王五", "28", "广州"}
        };

        for (int i = 0; i < data.length; i++) {
            for (int j = 0; j < data[i].length; j++) {
                table.getRow(i + 1).getCell(j).setText(data[i][j]);
            }
        }

        // 保存Word文档
        try (FileOutputStream out = new FileOutputStream("example.docx")) {
            document.write(out);
            System.out.println("Word文档已成功生成。");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

在上述代码中，我们首先创建了一个Word文档，接着创建了一个包含3行3列的表格，并填充了表格的标题和数据，最后将文档保存为example.docx。

旅行图示例

为了让学习过程更生动，我使用mermaid语法绘制了一幅旅行图，展示了生成Word文档的步骤：

journey
    title 生成Word文档的步骤
    section 创建文档
      创建Word文档: 5: 人工
    section 创建表格
      创建表格结构: 4: 人工
      填充数据: 3: 人工
    section 保存文档
      写入文件: 5: 人工

结论

通过以上示例，你应该能够成功地使用Apache POI生成一个包含表格的Word文档。这在报告生成、数据导出等场景中具有重要的应用价值。随着项目的深入，你可以根据实际需求进行更复杂的文档操作，比如插入图像、调整格式等。希望这篇文章能为你在Java开发中使用POI提供帮助。如果你有更多问题，欢迎在评论区讨论！