SpringBoot根據(jù)Word模板導(dǎo)出復(fù)雜格式的文檔
更新時間：2025年08月17日 09:46:20 作者：IT界Tony哥
這篇文章主要為大家詳細(xì)介紹了Spring Boot 中根據(jù) Word 模板導(dǎo)出包含表格、圖表等復(fù)雜格式的文檔的相關(guān)實現(xiàn)方法,大家可以根據(jù)自己的需求進(jìn)行選擇
在 Spring Boot 中根據(jù) Word 模板導(dǎo)出包含表格、圖表等復(fù)雜格式的文檔，可通過以下方案實現(xiàn)。以下是綜合多篇技術(shù)博客和最佳實踐的完整指南：
一、技術(shù)選型與方案對比
| 方案 | 優(yōu)點 | 缺點 | 適用場景 |
|---|---|---|---|
| ??poi-tl?? | 直接操作 Word 模板，支持動態(tài)循環(huán)、合并單元格，開發(fā)效率高 | 需熟悉模板語法，圖表需結(jié)合其他庫生成 | 快速開發(fā)，模板復(fù)雜度中等 |
| ??Apache POI?? | 靈活性強，支持底層操作文檔結(jié)構(gòu) | 代碼量大，模板處理復(fù)雜度高 | 高度定制化需求 |
| ??Freemarker/Thymeleaf?? | 模板語法簡單，適合文本替換 | 需 XML 轉(zhuǎn)換，圖表生成困難 | 純文本或簡單表格 |
??推薦方案??：優(yōu)先使用 ??poi-tl??（結(jié)合 JFreeChart 生成圖表），兼顧開發(fā)效率和功能完整性。
二、poi-tl 實現(xiàn)步驟（含表格與圖表）
1. 添加依賴
<!-- poi-tl 核心依賴 -->
<dependency>
<groupId>com.deepoove</groupId>
<artifactId>poi-tl</artifactId>
<version>1.12.2</version>
</dependency>
<!-- 圖表生成依賴 -->
<dependency>
<groupId>org.jfree</groupId>
<artifactId>jfreechart</artifactId>
<version>1.5.4</version>
</dependency>
2. 設(shè)計 Word 模板
??表格模板??：
{{userList}} 姓名 | 性別 | 年齡
---|---|---
[name] | [sex] | [age]
??圖表處理??：
使用 JFreeChart 生成圖表圖片，插入到 Word 指定位置（poi-tl 不支持直接生成圖表）。
3. 代碼實現(xiàn)
// 配置渲染策略（合并單元格、循環(huán)渲染）
Configure config = Configure.builder()
.useSpringEL()
.bind("list1", new LoopRowTableRenderPolicy()) // 行循環(huán)
.bind("tableList", new ReportDataPolicy()) // 自定義合并策略
.build();
// 加載模板并渲染數(shù)據(jù)
XWPFTemplate template = XWPFTemplate.compile("template.docx", config)
.render(dataMap);
// 輸出到響應(yīng)流（支持下載）
template.write(response.getOutputStream());
4. 自定義合并單元格策略
public class ReportDataPolicy extends DynamicTableRenderPolicy {
@Override
public void render(XWPFTable table, Object data) {
// 解析數(shù)據(jù)并動態(tài)插入行
List<BsReportData> list = JSON.parseArray(JSON.toJSONString(data), BsReportData.class);
for (BsReportData item : list) {
RowRenderData row = Rows.of(item.getField1(), item.getField2()).create();
table.insertNewTableRow().render(row);
}
}
}
三、Apache POI 直接操作方案
1. 核心代碼（表格生成）
XWPFDocument document = new XWPFDocument();
XWPFTable table = document.createTable(3, 3); // 3行3列
table.getRow(0).getCell(0).setText("標(biāo)題");
// 動態(tài)填充數(shù)據(jù)
for (int i=0; i<dataList.size(); i++) {
table.getRow(i+1).getCell(0).setText(dataList.get(i).getName());
}
2. 圖表生成（需結(jié)合 JFreeChart）
// 生成柱狀圖 JFreeChart chart = ChartFactory.createBarChart(...); // 轉(zhuǎn)換為 BufferedImage BufferedImage image = chart.createBufferedImage(400, 300); // 插入 Word XWPFParagraph paragraph = document.createParagraph(); XWPFRun run = paragraph.createRun(); run.addPicture(new ByteArrayInputStream(toByteArray(image)), XWPFDocument.PICTURE_TYPE_PNG, "chart.png", Units.toEMU(400), Units.toEMU(300));
四、模板設(shè)計最佳實踐
1.??占位符規(guī)范??
- 簡單變量：
{{fieldName}} - 循環(huán)列表：
{{listName}}+ 表頭占位符（如[name]）
2.復(fù)雜格式處理??
- 合并單元格：通過代碼動態(tài)操作
XWPFTableRow和XWPFTableCell - 樣式繼承：在 Word 模板中預(yù)定義樣式，避免代碼中硬編碼格式
3.??圖表兼容性??
- 優(yōu)先使用 SVG 格式（高分辨率）
- 測試不同 Office 版本的顯示效果
五、方案對比與選擇建議
| 場景 | 推薦方案 | 理由 |
|---|---|---|
| 快速原型開發(fā) | poi-tl | 模板直觀，開發(fā)周期短 |
| 高定制化需求 | Apache POI | 完全控制文檔結(jié)構(gòu)和樣式 |
| 純文本/簡單表格 | Freemarker | 模板編寫簡單，無需處理二進(jìn)制流 |
六、常見問題解決
1.??圖表顯示異常??
- 確保圖片分辨率 ≥ 300dpi
- 使用
XWPFRun.addPicture()時指定正確 MIME 類型
2.??模板變量不生效??
- 檢查占位符語法是否與代碼中的鍵名一致
- 使用
Configure.builder().useSpringEL()啟用 SpEL 表達(dá)式支持
3.??大文件內(nèi)存溢出??
- 使用
SXSSFWorkbook替代XSSFWorkbook - 分頁寫入數(shù)據(jù)，避免一次性加載全部內(nèi)容
通過上述方案，可靈活實現(xiàn)包含動態(tài)表格、圖表等復(fù)雜格式的 Word 導(dǎo)出功能。推薦優(yōu)先采用 ??poi-tl?? 方案平衡開發(fā)效率與功能完整性，復(fù)雜場景可結(jié)合 Apache POI 進(jìn)行深度定制。
到此這篇關(guān)于SpringBoot根據(jù)Word模板導(dǎo)出復(fù)雜格式的文檔的文章就介紹到這了,更多相關(guān)SpringBoot根據(jù)Word模板導(dǎo)出文檔內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
您可能感興趣的文章:
- SpringBoot如何基于POI-tl和word模板導(dǎo)出龐大的Word文件
- SpringBoot集成EasyPoi實現(xiàn)Excel模板導(dǎo)出成PDF文件
- Springboot+Easyexcel將數(shù)據(jù)寫入模板文件并導(dǎo)出Excel的操作代碼
- SpringBoot后臺使用EasyExcel實現(xiàn)數(shù)據(jù)報表導(dǎo)出(含模板、樣式、美化)
- Springboot使用jxls實現(xiàn)excel模板導(dǎo)出excel方式
- SpringBoot快速集成jxls-poi(自定義模板,支持本地文件導(dǎo)出,在線文件導(dǎo)出)
相關(guān)文章
本文主要介紹了淺談Java安全之C3P0鏈利用與分析，文中通過示例代碼介紹的非常詳細(xì)，具有一定的參考價值，感興趣的小伙伴們可以參考一下2022-01-01
java Date裝成英文String后，無法再轉(zhuǎn)回Date的解決方案
本文介紹了java Date裝成英文String后，無法再轉(zhuǎn)回Date的解決方案。具有一定的參考價值，下面跟著小編一起來看下吧2017-01-01
如何解決springmvc文件下載,內(nèi)容損壞的問題
這篇文章主要介紹了解決springmvc文件下載，內(nèi)容損壞的問題，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2021-06-06
這篇文章主要介紹了java實現(xiàn)樹形查詢方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-07-07
這篇文章主要介紹了解決springboot啟動報錯bean找不到原因,本文給大家分享完美解決方案，通過圖文相結(jié)合給大家介紹的非常詳細(xì)，需要的朋友可以參考下2023-03-03
Minio是一個開源的分布式對象存儲系統(tǒng),它允許用戶在存儲服務(wù)上存儲和檢索數(shù)據(jù),下面這篇文章主要給大家介紹了關(guān)于Java大文件分片上傳(minio版)的相關(guān)資料,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下2024-08-08
Zuul作為網(wǎng)關(guān)服務(wù)，是其他各服務(wù)對外中轉(zhuǎn)站，通過Zuul進(jìn)行請求轉(zhuǎn)發(fā)。這篇文章主要介紹了詳解SpringCloud Zuul過濾器返回值攔截，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2018-06-06
JAXB命名空間及前綴_動力節(jié)點Java學(xué)院整理
這篇文章主要給大家介紹了關(guān)于JAXB命名空間及前綴的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧。2017-08-08
SpringCloud負(fù)載均衡spring-cloud-starter-loadbalancer解讀
這篇文章主要介紹了SpringCloud負(fù)載均衡spring-cloud-starter-loadbalancer使用方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-03-03
Spring?Data?JPA系列QueryByExampleExecutor使用詳解
這篇文章主要為大家介紹了Spring?Data?JPA系列QueryByExampleExecutor使用示例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2022-09-09