Apache POI中HSSFWorkbook、XSSFWorkbook、SXSSFWorkbook的區(qū)別解析
一、前言
在java項(xiàng)目中,我們經(jīng)常使用Apache POI的包導(dǎo)出Excel文件,但是在創(chuàng)建Workbook的時(shí)候,有三種選型HSSFWorkbook、XSSFWorkbook、SXSSFWorkbook可以選擇,本文總結(jié)一下這三個(gè)實(shí)現(xiàn)類的區(qū)別。
二、Workbook的三個(gè)實(shí)現(xiàn)類
在Apache POI中,Workbook接口 代表一個(gè)Excel工作簿(即一個(gè)Excel文件)。針對(duì)不同版本的Excel文件,POI提供了三個(gè)主要的實(shí)現(xiàn)類:
| 實(shí)現(xiàn)類 | 支持的文件格式 | 對(duì)應(yīng)Excel版本 | 文件擴(kuò)展名 |
|---|---|---|---|
| HSSFWorkbook | HSSF (Horrible SpreadSheet Format) | Excel 97-2003 | .xls |
| XSSFWorkbook | XSSF (XML SpreadSheet Format) | Excel 2007+ | .xlsx |
| SXSSFWorkbook | 基于XSSF的流式擴(kuò)展 | Excel 2007+ | .xlsx |
SXSSFWorkbook
- 也是用于.xlsx格式,但它主要用于處理非常大的電子表格文件,通過(guò)在內(nèi)存中僅保留一定數(shù)量的行來(lái)優(yōu)化性能。
- SXSSFWorkbook非常適合用于生成非常大的電子表格文件,因?yàn)樗梢詼p少內(nèi)存使用。
三個(gè)類的API設(shè)計(jì)高度一致,切換起來(lái)非常方便:
import org.apache.poi.hssf.usermodel.HSSFWorkbook; import org.apache.poi.xssf.usermodel.XSSFWorkbook; import org.apache.poi.xssf.streaming.SXSSFWorkbook; // 使用HSSFWorkbook創(chuàng)建.xls文件 Workbook workbook = new HSSFWorkbook(); // 使用XSSFWorkbook創(chuàng)建.xlsx文件 Workbook workbook = new XSSFWorkbook(); // 使用SXSSFWorkbook創(chuàng)建.xlsx文件(低內(nèi)存模式) Workbook workbook = new SXSSFWorkbook();
三、三個(gè)實(shí)現(xiàn)類的核心區(qū)別
3.1、HSSFWorkbook:老兵不死,但已逐漸凋零
HSSFWorkbook是POI中最古老的實(shí)現(xiàn),對(duì)應(yīng)的是Excel 97-2003版本的二進(jìn)制格式(.xls)。
主要特點(diǎn):
- 行數(shù)限制:每個(gè)Sheet最多支持65535行,超過(guò)會(huì)報(bào)錯(cuò)
- 列數(shù)限制:最多支持256列
- 內(nèi)存模型:
所有數(shù)據(jù)全部加載到內(nèi)存中 - 性能表現(xiàn):由于是二進(jìn)制格式,處理速度反而是三個(gè)中最快的
適用場(chǎng)景:
- 需要兼容老舊系統(tǒng),必須輸出.xls格式
- 數(shù)據(jù)量很?。?lt; 6.5萬(wàn)行)
- 對(duì)性能要求極高且數(shù)據(jù)量可控
3.2、XSSFWorkbook:現(xiàn)代辦公的主力軍
隨著Excel 2007推出新的OpenXML格式(.xlsx),POI推出了XSSFWorkbook來(lái)支持這種基于XML的新格式。
主要特點(diǎn):
- 行數(shù)限制:每個(gè)Sheet最多支持1048576行(約104萬(wàn)行)
- 列數(shù)限制:最多支持16384列
- 內(nèi)存模型:
所有數(shù)據(jù)全部加載到內(nèi)存中,內(nèi)存占用是HSSFWorkbook的2-7倍 - 性能表現(xiàn):由于XML解析的開(kāi)銷,處理速度最慢,比HSSFWorkbook慢約30倍
適用場(chǎng)景:
- 需要輸出.xlsx格式
- 數(shù)據(jù)量中等(幾十萬(wàn)行以內(nèi))
- 內(nèi)存充足,且需要使用完整的Excel功能(樣式、公式、圖表等)
3.3、SXSSFWorkbook:大數(shù)據(jù)處理的救星
從POI 3.8版本開(kāi)始,推出了基于XSSF的流式實(shí)現(xiàn)SXSSFWorkbook,專門為了解決大數(shù)據(jù)量導(dǎo)出時(shí)的內(nèi)存溢出問(wèn)題。
主要特點(diǎn):
- 行數(shù)限制:與XSSFWorkbook相同,支持百萬(wàn)行級(jí)別
- 內(nèi)存模型:流式處理,
默認(rèn)只在內(nèi)存中保留100行,超出的行會(huì)刷新到磁盤(pán)臨時(shí)文件中 - 性能表現(xiàn):介于HSSF和XSSF之間,但內(nèi)存占用穩(wěn)定,幾乎不隨數(shù)據(jù)量增長(zhǎng)
功能限制(重要?。?/strong>
由于數(shù)據(jù)被刷新到磁盤(pán),以下功能無(wú)法使用:
autoSizeColumn()- 自動(dòng)調(diào)整列寬cloneSheet()- 克隆工作表- 對(duì)已刷新行的隨機(jī)訪問(wèn)(
getRow()可能返回null) - 公式求值(涉及已刷新行的公式)
shiftColumns()- 列位移操作
適用場(chǎng)景:
- 百萬(wàn)級(jí)數(shù)據(jù)導(dǎo)出
- 內(nèi)存受限的環(huán)境
- 不需要上述受限功能(或可以在導(dǎo)出完成后處理)
四、性能數(shù)據(jù)說(shuō)話
口說(shuō)無(wú)憑,我們來(lái)看一組權(quán)威的性能測(cè)試數(shù)據(jù)(來(lái)自Baeldung的JMH基準(zhǔn)測(cè)試):
執(zhí)行時(shí)間對(duì)比(單位:毫秒)
| 行數(shù) | HSSFWorkbook | XSSFWorkbook | SXSSFWorkbook |
|---|---|---|---|
| 2,500 | 73 | 2,658 | 296 |
| 10,000 | 347 | 10,994 | 1,808 |
| 20,000 | 754 | 21,733 | 3,751 |
| 40,000 | 1,455 | 42,331 | 7,342 |
內(nèi)存消耗對(duì)比(單位:MB)
| 行數(shù) | HSSFWorkbook | XSSFWorkbook | SXSSFWorkbook |
|---|---|---|---|
| 2,500 | 828 | 1,871 | 258 |
| 10,000 | 1,268 | 4,136 | 209 |
| 20,000 | 1,766 | 7,443 | 209 |
| 40,000 | 1,475 | 10,119 | 210 |
從數(shù)據(jù)中可以清晰看到:
- XSSFWorkbook是典型的"內(nèi)存殺手",40k行數(shù)據(jù)消耗高達(dá)10GB內(nèi)存
- SXSSFWorkbook的內(nèi)存占用穩(wěn)定在210MB左右,優(yōu)勢(shì)極其明顯
- HSSFWorkbook雖然速度快,但受限于行數(shù)上限,無(wú)法處理大規(guī)模數(shù)據(jù)
五、實(shí)際開(kāi)發(fā)中的選型建議
5.1、決策樹(shù):三步選對(duì)Workbook
開(kāi)始選型
↓
是否需要輸出.xls格式?
├─ 是 → 數(shù)據(jù)量<6.5萬(wàn)行? → 是 → HSSFWorkbook
│ → 否 → 無(wú)法滿足,考慮分批導(dǎo)出或升級(jí)格式
↓
是否需要完整的Excel功能(樣式、公式、圖表等)?
├─ 是 → 數(shù)據(jù)量<10萬(wàn)行且內(nèi)存充足? → 是 → XSSFWorkbook
│ → 否 → 考慮分批寫(xiě)入+ XSSFWorkbook
↓
是否需要處理超大數(shù)據(jù)量(>10萬(wàn)行)?
├─ 是 → 能否接受功能限制? → 是 → SXSSFWorkbook
│ → 否 → 考慮EasyExcel或分批導(dǎo)出
↓
默認(rèn)選擇 → XSSFWorkbook(常規(guī)場(chǎng)景)5.2、實(shí)戰(zhàn)經(jīng)驗(yàn)分享
場(chǎng)景1:常規(guī)報(bào)表導(dǎo)出(幾千到幾萬(wàn)行)
// 推薦使用XSSFWorkbook,功能完整,開(kāi)發(fā)簡(jiǎn)單
try (Workbook workbook = new XSSFWorkbook()) {
// 正常的樣式、公式處理
}場(chǎng)景2:百萬(wàn)級(jí)數(shù)據(jù)導(dǎo)出,無(wú)需復(fù)雜樣式
// SXSSFWorkbook是最佳選擇
SXSSFWorkbook workbook = new SXSSFWorkbook(100); // 設(shè)置內(nèi)存窗口大小為100
try {
// 分批寫(xiě)入數(shù)據(jù)
for (...) {
Row row = sheet.createRow(...);
// 填充數(shù)據(jù)
}
} finally {
// 務(wù)必清理臨時(shí)文件
workbook.dispose();
workbook.close();
}場(chǎng)景3:需要復(fù)雜樣式,但數(shù)據(jù)量也大
這種情況下可以采取折中方案:
- 使用XSSFWorkbook創(chuàng)建模板,設(shè)置好所有樣式
- 使用SXSSFWorkbook基于模板填充數(shù)據(jù)
- 或者使用EasyExcel等封裝庫(kù)
六、SXSSFWorkbook使用注意事項(xiàng)
如果選擇了SXSSFWorkbook,有幾個(gè)坑需要特別注意:
6.1、及時(shí)清理臨時(shí)文件
SXSSFWorkbook workbook = new SXSSFWorkbook();
try {
// 處理數(shù)據(jù)...
} finally {
workbook.dispose(); // 刪除臨時(shí)文件
workbook.close();
}6.2、避免使用受限功能
// 以下代碼會(huì)拋出異常 sheet.autoSizeColumn(0); // IllegalStateException workbook.cloneSheet(0); // IllegalStateException
6.3、合理設(shè)置窗口大小
// 窗口大小設(shè)置原則: // - 越小,內(nèi)存占用越低,但功能限制影響越大 // - 越大,可用功能越多,但內(nèi)存占用越高 SXSSFWorkbook workbook = new SXSSFWorkbook(500); // 根據(jù)實(shí)際需求調(diào)整
七、結(jié)語(yǔ)
Apache POI的三個(gè)Workbook實(shí)現(xiàn)類各有千秋,沒(méi)有絕對(duì)的"最好",只有最適合你當(dāng)前場(chǎng)景的選擇。簡(jiǎn)單總結(jié)一下:
- HSSFWorkbook:老當(dāng)益壯,但已是過(guò)去式
- XSSFWorkbook:中規(guī)中矩,日常開(kāi)發(fā)主力
- SXSSFWorkbook:黑馬選手,大數(shù)據(jù)場(chǎng)景必備
在實(shí)際項(xiàng)目中,建議根據(jù)數(shù)據(jù)量、功能需求、內(nèi)存限制這三個(gè)維度綜合評(píng)估。如果數(shù)據(jù)量真的到了百萬(wàn)級(jí)別,且功能需求復(fù)雜,也可以考慮阿里開(kāi)源的EasyExcel,它在POI基礎(chǔ)上做了進(jìn)一步的封裝和優(yōu)化,同樣值得關(guān)注。
希望這篇文章能幫你徹底搞懂POI的Workbook家族,從此不再為Excel導(dǎo)出發(fā)愁!
到此這篇關(guān)于Apache POI中HSSFWorkbook、XSSFWorkbook、SXSSFWorkbook的區(qū)別解析的文章就介紹到這了,更多相關(guān)apache poi詳解內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
- Java使用Apache POI和EasyExcel讀取Excel文件的實(shí)現(xiàn)方案
- 使用Java和Apache POI實(shí)現(xiàn)HTML轉(zhuǎn)Word的完整指南
- Java利用Apache POI實(shí)現(xiàn)多模板Word文檔生成的示例代碼
- SpringMVC框架使用 Apache POI實(shí)現(xiàn)導(dǎo)出Excel
- 使用Apache POI在Java中實(shí)現(xiàn)Excel單元格的合并
- 使用 Apache POI 在 Java 中寫(xiě)入 Excel 文件的方法
- 使用Apache?POI和SpringBoot實(shí)現(xiàn)Excel文件上傳和解析功能
- SpringBoot使用Apache POI庫(kù)讀取Excel文件的操作詳解
- Java使用Apache.POI中HSSFWorkbook導(dǎo)出到Excel的實(shí)現(xiàn)方法
相關(guān)文章
Linux基本命令及Linux文件類型用法及說(shuō)明
本文主要講解了Linux文件類型、目錄切換命令、目錄操作命令、查找命令、文件內(nèi)容查看命令、文件內(nèi)容查詢命令以及文本處理命令,文中詳細(xì)解釋了每種命令的功能、使用方法及參數(shù)選項(xiàng),并通過(guò)實(shí)例展示了命令的具體用法2026-05-05
centos7下搭建ZooKeeper3.4中間件常用命令小結(jié)
Zookeeper 作為一個(gè)分布式的服務(wù)框架,主要用來(lái)解決分布式集群中應(yīng)用系統(tǒng)的一致性問(wèn)題,它能提供基于類似于文件系統(tǒng)的目錄節(jié)點(diǎn)樹(shù)方式的數(shù)據(jù)存儲(chǔ)。這篇文章主要介紹了centos7下搭建ZooKeeper3.4中間件常用命令小結(jié),需要的朋友可以參考下2019-07-07
無(wú)法啟動(dòng)Apache的問(wèn)題解決方法
這篇文章主要介紹了無(wú)法啟動(dòng)Apache的問(wèn)題解決方法,需要的朋友可以參考下2014-05-05
centos6.5升級(jí)安裝配置supervisor的教程
Supervisor 是用Python開(kāi)發(fā)的一個(gè)client/server服務(wù),是Linux/Unix系統(tǒng)下的一個(gè)進(jìn)程管理工具,不支持Windows系統(tǒng)。這篇文章主要介紹了centos6.5升級(jí)安裝配置supervisor的方法,需要的朋友可以參考下2019-11-11

