各位開發(fā)者們，在日常的 Java 開發(fā)工作里，處理 Excel 和 Word 文件是相當(dāng)常見的需求。無論是從 Excel 里讀取數(shù)據(jù)進行分析，還是將數(shù)據(jù)寫入 Excel 生成報表，亦或是對 Word 文檔進行內(nèi)容編輯，傳統(tǒng)的 Apache POI 庫雖然功能強大，但使用起來往往比較復(fù)雜，代碼量也不少。不過，有了 Hutool - POI 這個得力助手，一切都變得輕松起來了。它對 Apache POI 進行了封裝，提供了簡潔易用的 API，讓我們可以更高效地操作 Excel 和 Word 文件。

一、Excel 操作：數(shù)據(jù)讀寫如此簡單

1. 從 Excel 讀取數(shù)據(jù)

假設(shè)我們有一個 Excel 文件，里面存儲著員工信息，現(xiàn)在要把這些信息讀取出來。

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) {// 創(chuàng)建 Excel 讀取器ExcelReader reader = ExcelUtil.getReader("employees.xlsx");// 讀取數(shù)據(jù)，每行數(shù)據(jù)以 Map 形式存儲List<Map<String, Object>> dataList = reader.readAll();for (Map<String, Object> row : dataList) {System.out.println("員工信息: " + row);}// 關(guān)閉讀取器reader.close();}
}

在這段代碼中，我們使用 ExcelUtil.getReader 方法創(chuàng)建了一個 Excel 讀取器，指定要讀取的 Excel 文件。然后調(diào)用 readAll 方法，將 Excel 中的所有數(shù)據(jù)讀取出來，每行數(shù)據(jù)都以 Map 的形式存儲，鍵是列名，值是單元格的值。最后遍歷這個數(shù)據(jù)列表，輸出每一行的員工信息。別忘了，使用完讀取器后要調(diào)用 close 方法關(guān)閉它，釋放資源。

2. 將數(shù)據(jù)寫入 Excel

現(xiàn)在我們有一些員工數(shù)據(jù)，要把它們寫入到一個新的 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) {// 準(zhǔn)備數(shù)據(jù)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);// 創(chuàng)建 Excel 寫入器ExcelWriter writer = ExcelUtil.getWriter("new_employees.xlsx");// 寫入數(shù)據(jù)writer.write(dataList, true);// 關(guān)閉寫入器writer.close();System.out.println("數(shù)據(jù)已成功寫入 Excel 文件");}
}

這里，我們先創(chuàng)建了一個包含員工信息的 List<Map<String, Object>> 數(shù)據(jù)列表。然后使用 ExcelUtil.getWriter 方法創(chuàng)建一個 Excel 寫入器，指定要寫入的文件名稱。調(diào)用 write 方法將數(shù)據(jù)寫入到 Excel 中，第二個參數(shù) true 表示是否寫入表頭。最后關(guān)閉寫入器，數(shù)據(jù)就成功寫入到新的 Excel 文件里了。

二、Word 操作：內(nèi)容編輯得心應(yīng)手

1. 創(chuàng)建并填充 Word 文檔

我們來創(chuàng)建一個簡單的 Word 文檔，并且往里面添加一些文本內(nèi)容。

import cn.hutool.poi.word.WordUtil;
import java.io.File;public class WordCreateExample {public static void main(String[] args) {String content = "這是一個使用 Hutool - POI 創(chuàng)建的 Word 文檔示例。";// 創(chuàng)建 Word 文檔并寫入內(nèi)容WordUtil.writeWord(content, new File("example.docx"));System.out.println("Word 文檔創(chuàng)建成功");}
}

在這個例子中，我們定義了一段文本內(nèi)容，然后使用 WordUtil.writeWord 方法將這段內(nèi)容寫入到一個新的 Word 文檔中，指定文檔的存儲路徑和文件名。運行代碼后，一個包含指定內(nèi)容的 Word 文檔就創(chuàng)建好了。

2. 讀取 Word 文檔內(nèi)容

如果我們有一個已有的 Word 文檔，想要讀取其中的內(nèi)容，也很容易實現(xiàn)。

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

使用 WordUtil.readWord 方法，傳入要讀取的 Word 文件對象，就能把文檔中的內(nèi)容讀取出來并以字符串的形式返回，方便我們進一步處理。

三、注意事項

在使用 Hutool - POI 進行 Excel 和 Word 操作時，也有一些需要留意的地方。對于 Excel 操作，要注意數(shù)據(jù)類型的匹配，確保寫入的數(shù)據(jù)類型和 Excel 單元格的類型兼容。同時，處理大量數(shù)據(jù)時，要考慮性能問題，可以采用分批讀取和寫入的方式。對于 Word 操作，不同版本的 Word 文檔可能會有一些格式差異，在處理時要進行充分的測試。另外，操作文件時要確保文件的讀寫權(quán)限，避免出現(xiàn)權(quán)限不足的錯誤。

總之，Hutool - POI 為我們提供了一種簡單、高效的方式來操作 Excel 和 Word 文件。無論是新手開發(fā)者還是有經(jīng)驗的老程序員，都能借助它快速實現(xiàn)文件處理的需求，提升開發(fā)效率，讓我們把更多的精力放在業(yè)務(wù)邏輯上。大家不妨在自己的項目中試試，相信它會給你帶來不錯的體驗！