Hutool-POI：让Excel与Word操作变得轻而易举

各位开发者们，在日常的 Java 开发工作里，处理 Excel 和 Word 文件是相当常见的需求。无论是从 Excel 里读取数据进行分析，还是将数据写入 Excel 生成报表，亦或是对 Word 文档进行内容编辑，传统的 Apache POI 库虽然功能强大，但使用起来往往比较复杂，代码量也不少。不过，有了 Hutool - POI 这个得力助手，一切都变得轻松起来了。它对 Apache POI 进行了封装，提供了简洁易用的 API，让我们可以更高效地操作 Excel 和 Word 文件。

一、Excel 操作：数据读写如此简单 1. 从 Excel 读取数据

假设我们有一个 Excel 文件，里面存储着员工信息，现在要把这些信息读取出来。

import cn.hutool.poi.excel.ExcelReader; import cn.hutool.poi.excel.ExcelUtil; import java.util.List; import java.util.Map; public class ExcelReadExample { public static void main(String[] args) { // 创建 Excel 读取器 ExcelReader reader = ExcelUtil.getReader("employees.xlsx"); // 读取数据，每行数据以 Map 形式存储 List<Map<String, Object>> dataList = reader.readAll(); for (Map<String, Object> row : dataList) { System.out.println("员工信息: " + row); } // 关闭读取器 reader.close(); } }

在这段代码中，我们使用 ExcelUtil.getReader 方法创建了一个 Excel 读取器，指定要读取的 Excel 文件。然后调用 readAll 方法，将 Excel 中的所有数据读取出来，每行数据都以 Map 的形式存储，键是列名，值是单元格的值。最后遍历这个数据列表，输出每一行的员工信息。别忘了，使用完读取器后要调用 close 方法关闭它，释放资源。

2. 将数据写入 Excel

现在我们有一些员工数据，要把它们写入到一个新的 Excel 文件中。

import cn.hutool.poi.excel.ExcelWriter; import cn.hutool.poi.excel.ExcelUtil; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; public class ExcelWriteExample { public static void main(String[] args) { // 准备数据 List<Map<String, Object>> dataList = new ArrayList<>(); Map<String, Object> row1 = new HashMap<>(); row1.put("姓名", "张三"); row1.put("年龄", 25); dataList.add(row1); Map<String, Object> row2 = new HashMap<>(); row2.put("姓名", "李四"); row2.put("年龄", 30); dataList.add(row2); // 创建 Excel 写入器 ExcelWriter writer = ExcelUtil.getWriter("new_employees.xlsx"); // 写入数据 writer.write(dataList, true); // 关闭写入器 writer.close(); System.out.println("数据已成功写入 Excel 文件"); } }

这里，我们先创建了一个包含员工信息的 List<Map<String, Object>> 数据列表。然后使用 ExcelUtil.getWriter 方法创建一个 Excel 写入器，指定要写入的文件名称。调用 write 方法将数据写入到 Excel 中，第二个参数 true 表示是否写入表头。最后关闭写入器，数据就成功写入到新的 Excel 文件里了。

二、Word 操作：内容编辑得心应手 1. 创建并填充 Word 文档

我们来创建一个简单的 Word 文档，并且往里面添加一些文本内容。

import cn.hutool.poi.word.WordUtil; import java.io.File; public class WordCreateExample { public static void main(String[] args) { String content = "这是一个使用 Hutool - POI 创建的 Word 文档示例。"; // 创建 Word 文档并写入内容 WordUtil.writeWord(content, new File("example.docx")); System.out.println("Word 文档创建成功"); } }

在这个例子中，我们定义了一段文本内容，然后使用 WordUtil.writeWord 方法将这段内容写入到一个新的 Word 文档中，指定文档的存储路径和文件名。运行代码后，一个包含指定内容的 Word 文档就创建好了。

2. 读取 Word 文档内容

如果我们有一个已有的 Word 文档，想要读取其中的内容，也很容易实现。

import cn.hutool.poi.word.WordUtil; import java.io.File; public class WordReadExample { public static void main(String[] args) { // 读取 Word 文档内容 String content = WordUtil.readWord(new File("example.docx")); System.out.println("Word 文档内容: " + content); } }

使用 WordUtil.readWord 方法，传入要读取的 Word 文件对象，就能把文档中的内容读取出来并以字符串的形式返回，方便我们进一步处理。

三、注意事项

在使用 Hutool - POI 进行 Excel 和 Word 操作时，也有一些需要留意的地方。对于 Excel 操作，要注意数据类型的匹配，确保写入的数据类型和 Excel 单元格的类型兼容。同时，处理大量数据时，要考虑性能问题，可以采用分批读取和写入的方式。对于 Word 操作，不同版本的 Word 文档可能会有一些格式差异，在处理时要进行充分的测试。另外，操作文件时要确保文件的读写权限，避免出现权限不足的错误。

总之，Hutool - POI 为我们提供了一种简单、高效的方式来操作 Excel 和 Word 文件。无论是新手开发者还是有经验的老程序员，都能借助它快速实现文件处理的需求，提升开发效率，让我们把更多的精力放在业务逻辑上。大家不妨在自己的项目中试试，相信它会给你带来不错的体验！