各位開發者們，在日常的 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 文件。無論是新手開發者還是有經驗的老程序員，都能借助它快速實現文件處理的需求，提升開發效率，讓我們把更多的精力放在業務邏輯上。大家不妨在自己的項目中試試，相信它會給你帶來不錯的體驗！
