Java使用JasperReport高效生成Word文檔指南
更新時(shí)間：2025年07月16日 09:36:18 作者：pengles
在當(dāng)今數(shù)據(jù)驅(qū)動(dòng)的商業(yè)環(huán)境中,企業(yè)每天都需要處理大量動(dòng)態(tài)文檔生成需求,本文主要為大家介紹了如何使用JasperReport高效生成Word文檔,感興趣的小伙伴可以了解下
引言
在當(dāng)今數(shù)據(jù)驅(qū)動(dòng)的商業(yè)環(huán)境中，企業(yè)每天都需要處理大量動(dòng)態(tài)文檔生成需求——從財(cái)務(wù)報(bào)表、銷售訂單到客戶合同和業(yè)務(wù)分析報(bào)告。傳統(tǒng)手動(dòng)制作方式不僅效率低下，而且難以保證數(shù)據(jù)準(zhǔn)確性和格式一致性。JasperReports作為業(yè)界領(lǐng)先的開(kāi)源報(bào)表引擎，為解決這一核心業(yè)務(wù)挑戰(zhàn)提供了專業(yè)級(jí)解決方案。
一、JasperReports核心架構(gòu)解析
JasperReports作為專業(yè)報(bào)表工具，其生成Word文檔的流程基于三大核心組件：
- 模板設(shè)計(jì)：使用JRXML定義布局和數(shù)據(jù)綁定
- 數(shù)據(jù)處理：連接多種數(shù)據(jù)源填充報(bào)表
- 導(dǎo)出引擎：支持多種格式輸出，包括DOCX
// 典型的三段式處理流程
JasperReport report = JasperCompileManager.compileReport("template.jrxml");
JasperPrint print = JasperFillManager.fillReport(report, params, dataSource);
JasperExportManager.exportReportToDocxFile(print, "output.docx");
二、模板設(shè)計(jì)深度實(shí)踐
2.1 可視化設(shè)計(jì)工具對(duì)比
| 工具名稱 | 特點(diǎn) | 適用場(chǎng)景 |
|---|---|---|
| iReport | 傳統(tǒng)設(shè)計(jì)器，功能全面 | 老項(xiàng)目維護(hù) |
| Jaspersoft Studio | Eclipse插件，官方維護(hù) | 新項(xiàng)目開(kāi)發(fā) |
| JasperSoft Online | 云服務(wù)，協(xié)作方便 | 團(tuán)隊(duì)協(xié)作項(xiàng)目 |
2.2 高級(jí)模板示例（JRXML）
<?xml version="1.0" encoding="UTF-8"?>
<jasperReport xmlns="http://jasperreports.sourceforge.net/jasperreports"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://jasperreports.sourceforge.net/jasperreports
http://jasperreports.sourceforge.net/xsd/jasperreport.xsd"
name="invoice_template" pageWidth="595" pageHeight="842">
<!-- 參數(shù)定義 -->
<parameter name="companyLogo" class="java.lang.String"/>
<parameter name="invoiceNumber" class="java.lang.String"/>
<!-- 數(shù)據(jù)源查詢 -->
<queryString>
<![CDATA[SELECT product_name, quantity, unit_price FROM order_items WHERE order_id = $P{orderId}]]>
</queryString>
<!-- 字段映射 -->
<field name="product_name" class="java.lang.String"/>
<field name="quantity" class="java.lang.Integer"/>
<field name="unit_price" class="java.math.BigDecimal"/>
<!-- 頁(yè)眉設(shè)計(jì) -->
<title>
<band height="100">
<image>
<reportElement x="20" y="20" width="150" height="50"/>
<imageExpression><![CDATA[$P{companyLogo}]]></imageExpression>
</image>
<staticText>
<reportElement x="400" y="30" width="150" height="20"/>
<text><![CDATA[發(fā)票編號(hào):]]></text>
</staticText>
<textField>
<reportElement x="500" y="30" width="80" height="20"/>
<textFieldExpression><![CDATA[$P{invoiceNumber}]]></textFieldExpression>
</textField>
</band>
</title>
<!-- 明細(xì)表格 -->
<detail>
<band height="20">
<textField>
<reportElement x="20" y="0" width="200" height="20"/>
<textFieldExpression><![CDATA[$F{product_name}]]></textFieldExpression>
</textField>
<textField>
<reportElement x="250" y="0" width="50" height="20"/>
<textFieldExpression><![CDATA[$F{quantity}]]></textFieldExpression>
</textField>
<textField>
<reportElement x="350" y="0" width="100" height="20"/>
<textFieldExpression><![CDATA["￥" + $F{unit_price}]]></textFieldExpression>
</textField>
</band>
</detail>
<!-- 頁(yè)腳匯總 -->
<summary>
<band height="50">
<staticText>
<reportElement x="350" y="10" width="100" height="20"/>
<text><![CDATA[合計(jì)金額:]]></text>
</staticText>
<textField>
<reportElement x="450" y="10" width="100" height="20"/>
<textFieldExpression><![CDATA["￥" + ($F{quantity}.intValue() * $F{unit_price})]]></textFieldExpression>
</textField>
</band>
</summary>
</jasperReport>
三、數(shù)據(jù)源集成方案
3.1 多數(shù)據(jù)源支持實(shí)現(xiàn)
// 數(shù)據(jù)庫(kù)數(shù)據(jù)源
JdbcDataSource dbDataSource = new JREmptyDataSource();
Connection conn = DriverManager.getConnection(DB_URL, USER, PASS);
JRDataSource dbDataSource = new JRResultSetDataSource(conn.createStatement()
.executeQuery("SELECT * FROM products"));
// JavaBean數(shù)據(jù)源
List<Employee> employees = getEmployeeList();
JRDataSource beanDataSource = new JRBeanCollectionDataSource(employees);
// Map集合數(shù)據(jù)源
List<Map<String, ?>> mapList = new ArrayList<>();
Map<String, Object> data = new HashMap<>();
data.put("name", "張三");
data.put("age", 30);
mapList.add(data);
JRDataSource mapDataSource = new JRMapCollectionDataSource(mapList);
// 多數(shù)據(jù)源合并
Map<String, JRDataSource> dataSources = new HashMap<>();
dataSources.put("dbDS", dbDataSource);
dataSources.put("beanDS", beanDataSource);
JasperFillManager.fillReportToFile("report.jasper", parameters, dataSources);
3.2 動(dòng)態(tài)參數(shù)傳遞
Map<String, Object> params = new HashMap<>();
params.put("reportTitle", "2023年度銷售報(bào)表");
params.put("startDate", Date.valueOf("2023-01-01"));
params.put("endDate", Date.valueOf("2023-12-31"));
params.put("minAmount", 10000);
params.put("companyLogo", "classpath:/images/logo.png");
// 條件參數(shù)傳遞
if (isExecutiveReport) {
params.put("showDetails", Boolean.TRUE);
params.put("includeSalary", Boolean.TRUE);
}
JasperPrint print = JasperFillManager.fillReport(report, params, dataSource);
四、Word導(dǎo)出高級(jí)配置
4.1 導(dǎo)出選項(xiàng)精細(xì)化控制
// 創(chuàng)建DOCX導(dǎo)出配置
SimpleDocxExporterConfiguration config = new SimpleDocxExporterConfiguration();
config.setFlexibleRowHeight(true);
config.setIgnoreHyperlink(false);
config.setPageMargins(PageMargins.builder()
.left(50).right(50).top(50).bottom(50).build());
// 執(zhí)行導(dǎo)出
JasperExportManager.exportReportToDocxFile(
print,
"report.docx",
config);
4.2 批量文檔生成方案
// 批量數(shù)據(jù)準(zhǔn)備
List<Customer> customers = customerService.findAll();
// 分頁(yè)參數(shù)配置
JRExporterParameter exporterParameter = new JRDocxExporterParameter();
exporterParameter.setParameter(JRExporterParameter.JASPER_PRINT_LIST,
customers.stream()
.map(c -> {
Map<String, Object> params = new HashMap<>();
params.put("customerId", c.getId());
return JasperFillManager.fillReport(report, params,
new JRBeanCollectionDataSource(c.getOrders()));
})
.collect(Collectors.toList()));
// 執(zhí)行批量導(dǎo)出
JasperExportManager.exportReportToDocxFile(
exporterParameter,
"customer_reports.docx");
五、企業(yè)級(jí)應(yīng)用解決方案
5.1 性能優(yōu)化策略
// 1. 預(yù)編譯模板
JasperReport compiledReport = JasperCompileManager.compileReportToFile(
"report.jrxml",
"report.jasper");
// 2. 使用緩存管理器
JasperReportsContext jasperReportsContext = DefaultJasperReportsContext.getInstance();
FileResolver fileResolver = new SimpleFileResolver(Collections.singletonList(new File("templates")));
jasperReportsContext.setValue(FileResolver.KEY, fileResolver);
// 3. 異步導(dǎo)出處理
ExecutorService executor = Executors.newFixedThreadPool(4);
Future<File> exportFuture = executor.submit(() -> {
JasperPrint print = JasperFillManager.fillReport(
compiledReport, params, dataSource);
File output = new File("async_report.docx");
JasperExportManager.exportReportToDocxFile(print, output);
return output;
});
// 獲取結(jié)果
File result = exportFuture.get(30, TimeUnit.SECONDS);
5.2 集群部署方案
<!-- Spring Boot集成配置 -->
<dependency>
<groupId>net.sf.jasperreports</groupId>
<artifactId>jasperreports</artifactId>
<version>6.20.0</version>
</dependency>
<dependency>
<groupId>com.jaspersoft.jasperreports</groupId>
<artifactId>jaspersoft-connection-pool</artifactId>
<version>1.0.0</version>
</dependency>
@Configuration
public class JasperConfig {
@Bean
public JasperReportsMultiFormatView jasperReportsView() {
JasperReportsMultiFormatView view = new JasperReportsMultiFormatView();
view.setUrl("classpath:/reports/template.jasper");
view.setReportDataKey("datasource");
return view;
}
@Bean
public ConnectionPoolService connectionPoolService() {
return new ConnectionPoolServiceImpl();
}
}
六、特殊場(chǎng)景解決方案
6.1 中文處理方案
<!-- 字體擴(kuò)展配置 -->
<extension name="com.jaspersoft.jasperreports.font"
class="com.jaspersoft.jasperreports.engine.fonts.SimpleFontExtension">
<fontFamily name="SimSun">
<normal>classpath:/fonts/simsun.ttf</normal>
<pdfEncoding>Identity-H</pdfEncoding>
<pdfEmbedded>true</pdfEmbedded>
</fontFamily>
</extension>
// 代碼中設(shè)置字體
JRStyle style = new JRStyle();
style.setName("chineseStyle");
style.setFontName("SimSun");
style.setPdfFontName("SimSun");
style.setPdfEncoding("Identity-H");
style.setPdfEmbedded(true);
// 應(yīng)用樣式
textField.setStyle(style);
6.2 復(fù)雜表格解決方案
// 動(dòng)態(tài)表格生成
JRDesignComponentElement tableComponent = new JRDesignComponentElement();
tableComponent.setComponentKey(new ComponentKey(
"http://jasperreports.sourceforge.net/jasperreports/components",
"jr",
"table"));
// 表格數(shù)據(jù)配置
DRDesignTable table = new DRDesignTable();
table.setDataSet(new JRDesignDataset(false));
table.addColumn(new DRDesignColumn());
table.addColumn(new DRDesignColumn());
// 動(dòng)態(tài)添加單元格
DRDesignCell cell = new DRDesignCell();
cell.setComponent(new DRDesignText());
((DRDesignText)cell.getComponent()).setTextExpression(
new JRDesignExpression("\"動(dòng)態(tài)內(nèi)容\""));
table.getDetailRow().addCell(0, cell);
// 添加到報(bào)表
tableComponent.setComponent(table);
band.addElement(tableComponent);
七、測(cè)試與驗(yàn)證體系
7.1 單元測(cè)試框架
public class ReportGeneratorTest {
@Test
public void testReportGeneration() throws Exception {
// 準(zhǔn)備測(cè)試數(shù)據(jù)
List<TestData> testData = Arrays.asList(
new TestData("Item1", 10, new BigDecimal("99.99")),
new TestData("Item2", 5, new BigDecimal("49.99"))
);
// 執(zhí)行報(bào)表生成
JasperReport report = JasperCompileManager.compileReport(
getClass().getResourceAsStream("/reports/test_template.jrxml"));
JasperPrint print = JasperFillManager.fillReport(
report,
new HashMap<>(),
new JRBeanCollectionDataSource(testData));
// 驗(yàn)證結(jié)果
assertNotNull(print);
assertEquals(1, print.getPages().size());
// 導(dǎo)出驗(yàn)證
ByteArrayOutputStream output = new ByteArrayOutputStream();
JasperExportManager.exportReportToPdfStream(print, output);
assertTrue(output.size() > 0);
}
static class TestData {
private String name;
private int quantity;
private BigDecimal price;
// 構(gòu)造方法和getter/setter省略
}
}
7.2 性能測(cè)試方案
@RunWith(SpringRunner.class)
@SpringBootTest
public class ReportPerformanceTest {
@Autowired
private ReportService reportService;
@Test
public void testLargeReportPerformance() {
// 準(zhǔn)備大數(shù)據(jù)集
List<LargeData> testData = generateTestData(10000);
// 執(zhí)行測(cè)試
long startTime = System.currentTimeMillis();
File result = reportService.generateLargeReport(testData);
long duration = System.currentTimeMillis() - startTime;
// 驗(yàn)證結(jié)果
assertTrue(result.exists());
assertTrue(duration < 10000, "生成時(shí)間超過(guò)10秒閾值");
// 輸出性能數(shù)據(jù)
System.out.printf("生成10,000條記錄的報(bào)表耗時(shí): %dms%n", duration);
}
private List<LargeData> generateTestData(int count) {
// 數(shù)據(jù)生成邏輯
}
}
八、最佳實(shí)踐總結(jié)
8.1 設(shè)計(jì)規(guī)范
模板管理：
- 按業(yè)務(wù)領(lǐng)域分類存儲(chǔ)模板
- 版本控制模板文件
- 建立模板元數(shù)據(jù)庫(kù)
命名約定：
/reports
├── sales
│ ├── monthly_sales_report.jrxml
│ └── customer_detail.jrxml
└── finance
├── invoice_template.jrxml
└── annual_report.jrxml
8.2 代碼規(guī)范
// 良好的報(bào)表服務(wù)封裝示例
public class ReportService {
private final JasperReportCache reportCache;
public ReportService(JasperReportCache reportCache) {
this.reportCache = reportCache;
}
public byte[] generateReport(String templateName,
Map<String, Object> parameters,
JRDataSource dataSource) {
try {
JasperReport report = reportCache.get(templateName);
JasperPrint print = JasperFillManager.fillReport(
report, parameters, dataSource);
ByteArrayOutputStream output = new ByteArrayOutputStream();
JasperExportManager.exportReportToPdfStream(print, output);
return output.toByteArray();
} catch (JRException e) {
throw new ReportGenerationException(
"Failed to generate report: " + templateName, e);
}
}
}
8.3 異常處理方案
@ControllerAdvice
public class ReportExceptionHandler {
@ExceptionHandler(ReportGenerationException.class)
public ResponseEntity<ErrorResponse> handleReportError(
ReportGenerationException ex) {
ErrorResponse error = new ErrorResponse(
"REPORT_ERROR",
ex.getMessage(),
System.currentTimeMillis());
return ResponseEntity
.status(HttpStatus.INTERNAL_SERVER_ERROR)
.body(error);
}
@ExceptionHandler(JRException.class)
public ResponseEntity<ErrorResponse> handleJasperError(
JRException ex) {
ErrorResponse error = new ErrorResponse(
"JASPER_ERROR",
"報(bào)表引擎處理錯(cuò)誤",
System.currentTimeMillis());
return ResponseEntity
.status(HttpStatus.BAD_REQUEST)
.body(error);
}
}
通過(guò)以上全面方案，企業(yè)可以構(gòu)建基于JasperReports的穩(wěn)健文檔生成系統(tǒng)，特別適合需要處理大量動(dòng)態(tài)數(shù)據(jù)的報(bào)表場(chǎng)景。雖然對(duì)原生Word格式支持有限，但其在數(shù)據(jù)驅(qū)動(dòng)型文檔生成方面具有無(wú)可比擬的優(yōu)勢(shì)。
以上就是Java使用JasperReport高效生成Word文檔指南的詳細(xì)內(nèi)容，更多關(guān)于Java JasperReport生成Word的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
這篇文章主要為大家詳細(xì)介紹了Java集合繼承體系，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2017-11-11
mybatis動(dòng)態(tài)SQL?if的test寫法及規(guī)則詳解
這篇文章主要介紹了mybatis動(dòng)態(tài)SQL?if的test寫法及規(guī)則詳解，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2022-01-01
SpringSecurity實(shí)現(xiàn)踢出指定用戶的示例
SpringSecurity中使用SessionRegistryImpl類可以獲取session信息并踢出用戶,這篇文章主要介紹了SpringSecurity實(shí)現(xiàn)踢出指定用戶的示例,需要的朋友可以參考下2025-03-03
Java數(shù)據(jù)結(jié)構(gòu)順序表的詳細(xì)講解
大家好，今天給大家?guī)?lái)的是順序表，我覺(jué)得順序表還是有比較難理解的地方的，于是我就把這一塊的內(nèi)容全部整理到了一起，希望能夠給剛剛進(jìn)行學(xué)習(xí)數(shù)據(jù)結(jié)構(gòu)的人帶來(lái)一些幫助，或者是已經(jīng)學(xué)過(guò)這塊的朋友們帶來(lái)更深的理解，我們現(xiàn)在就開(kāi)始吧2022-05-05
基于@RequestParam與@RequestBody使用對(duì)比
這篇文章主要介紹了@RequestParam與@RequestBody的使用對(duì)比，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2021-10-10
這篇文章主要介紹了Mybatis批量更新三種方式的實(shí)現(xiàn)，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2019-02-02
SpringBoot集成Dufs通過(guò)WebDAV實(shí)現(xiàn)文件管理方式
文章介紹了在SpringBoot應(yīng)用中集成Dufs文件服務(wù)器的方法,使用WebDAV協(xié)議實(shí)現(xiàn)文件管理功能,具體步驟包括添加項(xiàng)目依賴、配置類實(shí)現(xiàn)、服務(wù)層和控制器層的構(gòu)建,文章還詳細(xì)講解了大文件分塊上傳、異步操作和性能優(yōu)化措施2025-09-09
Java位運(yùn)算和邏輯運(yùn)算的區(qū)別實(shí)例
Java位運(yùn)算和邏輯運(yùn)算的區(qū)別實(shí)例，請(qǐng)參考下面代碼，希望對(duì)你有所幫助2013-02-02
Eclipse自定義啟動(dòng)畫面和圖標(biāo)的方法介紹
這篇文章主要介紹了Eclipse自定義啟動(dòng)畫面和圖標(biāo)的方法介紹，以及一些eclipse的快捷鍵，具有一定參考價(jià)值，需要的朋友可以了解下。2017-11-11
Spring循環(huán)依賴是指兩個(gè)或多個(gè)Bean相互依賴,形成閉環(huán),Spring通過(guò)三級(jí)緩存機(jī)制默認(rèn)支持setter注入的循環(huán)依賴,但不支持constructor注入的循環(huán)依賴（會(huì)拋異常）,本文介紹Spring循環(huán)依賴的解決方法,感興趣的朋友跟隨小編一起看看吧2026-03-03