強大！SpringBoot幾行代碼生成word文檔
環境：SpringBoot3.2.5
1. 簡介
Yet Another Report Generator (YARG) 是一款開源 Java 報表庫。它允許創建大多數常見格式（.doc、.docs、.xls、.xlsx、.html、.ftl、.csv）或自定義文本格式的模板，并填充由 SQL、Groovy 或 JSON 加載的數據。在本篇文章中，我將演示如何使用 Spring @RestController 輸出使用 JSON 加載數據的 .docx 文檔。
該開源庫的使用非常簡單，主要分為以下幾步：
- 準備模板
word模板中我們可以通過${xxx}占位符。
- 加載模板
加載模板對模板進行基本的配置。
- 準備數據
根據你的需要你可以準備由JSON，SQL或者Groovy加載的數據。
- 定義數據組
在上一步中準備完數據后，接下來就是這些數據應該如何對應到word模板中的占位符。
- 生成報告
根據上面的準備，最后就是將上面的數據組織在一起生成報告。
2. 實戰案例
2.1 引入依賴
<dependency>
<groupId>com.haulmont.yarg</groupId>
<artifactId>yarg</artifactId>
<version>2.2.14</version>
</dependency>
<repositories>
<repository>
<snapshots>
<enabled>false</enabled>
</snapshots>
<id>repo-cuba-platform-work</id>
<name>repo</name>
<url>https://repo.cuba-platform.com/content/groups/work</url>
</repository>
</repositories>有了上面的依賴無需進行其它的配置，直接可以在代碼中編寫非常少的代碼就能完成word報告的生成。
2.2 設計word模板
圖片
以上的${xxx}是我們將要填充的占位符數據。注意這里的R在接下來你將看到這里代表什么意思。
2.3 加載模板
我這里將模板放入到classpath/templates中，如下：
圖片
接下來就是加載該day.docx模板，代碼如下：
ReportBuilder reportBuilder = new ReportBuilder();
ReportTemplateBuilder reportTemplateBuilder = new ReportTemplateBuilder()
.documentPath(new ClassPathResource("templates/day.docx").getURI().getPath())
.documentName("day.docx")
.outputType(ReportOutputType.docx)
.readFileFromPath() ;
reportBuilder.template(reportTemplateBuilder.build()) ;以上代碼非常的簡單，就是對模板的加載及簡單的配置。
2.4 準備數據
這里為了演示的簡單，使用的靜態數據
Map<String, Object> data = Map.of(
"date", "2018-12-20", "p1", 234, "p2", 123,
"p3", 489, "p4", 789, "p5", 127, "p6", 489) ;
// 將該map數據生成json字符串形式
String jsonStr = new ObjectMapper().writeValueAsString(data) ;注意，這里的屬性都是要和word模板占位符對應的。
2.5 定義數據組
數據組是個抽象的概念，簡單理解就是在上一步中定義的數據如何能正確的替換word模板中的占位符。
BandBuilder bandBuilder = new BandBuilder() ;
ReportBand r = bandBuilder.name("R")
.query("R", "parameter=p$", "json")
.build() ;
reportBuilder.band(r) ;這里這里的name("R")，也就是在word模板中使用的R；接著是定義了如何從json中查詢數據query，parameter=p這里是定義查詢查詢參數p，而這個p一會在最后生成報表時你將看到這里的p；$表示json-path的根路徑，從根路徑查找每一個屬性值。
2.6 生成報告
Report report = reportBuilder.build() ;
Reporting reporting = new Reporting() ;
reporting.setFormatterFactory(new DefaultFormatterFactory());
reporting.setLoaderFactory(new DefaultLoaderFactory().setJsonDataLoader(new JsonDataLoader()));
response.setContentType("application/vnd.openxmlformats-officedocument.wordprocessingml.document");
reporting.runReport(new RunParams(report).param("p", jsonStr), response.getOutputStream());上面param("p", jsonStr)，分別就是上面我們的查詢參數parameter=p，jsonStr就是我們準備的json數據。
完成代碼如下：
圖片
以上是生成一個word報告所有流程及全部代碼。接下來進行測試，訪問上面的接口，將下載word文件，最終內容如下：
圖片
成功生成報告。
