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)先的開源報(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)目開發(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)文章
這篇文章主要介紹了Java常用注解擴(kuò)展對(duì)比的相關(guān)資料,提供了豐富的代碼示例,并總結(jié)了最佳實(shí)踐建議,幫助開發(fā)者更好地理解和應(yīng)用這些注解,需要的朋友可以參考下2025-03-03
java將指定目錄下文件復(fù)制到目標(biāo)文件夾的幾種小方法
在Java中有多種方法可以實(shí)現(xiàn)文件的復(fù)制,這篇文章主要給大家介紹了關(guān)于java將指定目錄下文件復(fù)制到目標(biāo)文件夾的幾種小方法,文中通過(guò)代碼介紹的非常詳細(xì),需要的朋友可以參考下2024-01-01
關(guān)于Java中的繼承和組合的一個(gè)錯(cuò)誤使用的例子
這篇文章主要介紹了關(guān)于Java中的繼承和組合的一個(gè)錯(cuò)誤使用的例子,需要的朋友可以參考下2016-08-08
關(guān)于Gateway網(wǎng)關(guān)中配置跨域的三種方案
文章總結(jié)：介紹了三種處理跨域請(qǐng)求的方法：在Controller類上添加注解、通過(guò)配置類實(shí)現(xiàn)重寫WebMvcConfigurer接口和在配置文件中統(tǒng)一設(shè)置,希望這些方法能幫助讀者解決跨域問(wèn)題2024-11-11
今天小編就為大家分享一篇關(guān)于Java中的接口回調(diào)實(shí)例，小編覺得內(nèi)容挺不錯(cuò)的，現(xiàn)在分享給大家，具有很好的參考價(jià)值，需要的朋友一起跟隨小編來(lái)看看吧2019-01-01
本文主要介紹了Maven依賴作用域和依賴傳遞的使用，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2023-06-06
springboot開啟mybatis駝峰命名自動(dòng)映射的三種方式
這篇文章給大家總結(jié)springboot開啟mybatis駝峰命名自動(dòng)映射的三種方式,文章并通過(guò)代碼示例給大家介紹的非常詳細(xì),具有一定的參考價(jià)值,需要的朋友可以參考下2024-02-02
Java?中很好用的數(shù)據(jù)結(jié)構(gòu)(你絕對(duì)沒用過(guò))
今天跟大家介紹的就是?java.util.EnumMap，也是?java.util?包下面的一個(gè)集合類,同樣的也有對(duì)應(yīng)的的?java.util.EnumSet，對(duì)java數(shù)據(jù)結(jié)構(gòu)相關(guān)知識(shí)感興趣的朋友一起看看吧2022-05-05
這篇文章主要介紹了mybatis使用xml進(jìn)行增刪改查代碼解析，分享了相關(guān)配置和代碼示例，小編覺得還是挺不錯(cuò)的，具有一定借鑒價(jià)值，需要的朋友可以參考下2018-02-02
這篇文章主要介紹了MyBatis如何使用(三)的相關(guān)資料,非常不錯(cuò)，具有參考借鑒價(jià)值，需要的朋友可以參考下2016-07-07