Jasperreports+jaspersoft studio学习教程（一）- JasperReports简单示例

### 如何在Spring Boot中集成和使用JasperReports #### 集成步骤概述 为了在Spring Boot项目中成功集成并使用JasperReports，需要完成几个关键配置。这些配置涉及依赖管理、资源文件设置以及控制器逻辑编写。 --- #### 添加Maven依赖 首先，在`pom.xml`文件中引入必要的依赖项以支持JasperReports的功能[^2]： ```xml <dependency> <groupId>net.sf.jasperreports</groupId> <artifactId>jasperreports</artifactId> <version>6.17.0</version> <!-- 版本号可以根据实际需求调整 --> </dependency> <!-- 如果需要PDF导出功能，则还需要以下依赖 --> <dependency> <groupId>org.apache.pdfbox</groupId> <artifactId>pdfbox</artifactId> <version>2.0.27</version> </dependency> ``` --- #### 创建报表模板 创建`.jrxml`文件作为报表设计的基础。可以通过[Jaspersoft Studio](https://community.jaspersoft.com/project/jaspersoft-studio)工具来设计此文件，并将其放置于`src/main/resources/reports/`目录下[^2]。 假设有一个名为`exampleReport.jrxml`的文件，其内容定义了一个简单的表格结构用于显示数据。 编译该`.jrxml`文件为`.jasper`格式以便运行时加载： ```bash mvn jasper:jasp ``` 或者手动通过Jaspersoft Studio进行编译。 --- #### JasperReports扩展属性配置 如果遇到字体缺失或其他渲染问题，可以在项目的`resources`路径下新增一个`jasperreports_extension.properties`文件，并按照以下方式填写相关内容[^3]： ```properties net.sf.jasperreports.awt.ignore.missing.font=true net.sf.jasperreports.extension.registry.factory.simple.font.families=net.sf.jasperreports.engine.fonts.SimpleFontExtensionsRegistryFactory net.sf.jasperreports.extension.simple.font.families.dejavu=fonts/fonts.xml ``` 这一步有助于解决某些复杂场景下的字体兼容性问题。 --- #### 编写服务层代码 接下来开发Java类处理业务逻辑部分。下面是一段示例代码片段展示如何动态填充参数到报告中去[^2]: ```java import net.sf.jasperreports.engine.*; import java.util.HashMap; import javax.servlet.http.HttpServletResponse; @Service public class ReportService { public void exportReport(HttpServletResponse response, String reportName, HashMap<String, Object> params) throws Exception { // 加载预编译好的 .jasper 文件 InputStream inputStream = getClass().getResourceAsStream("/reports/" + reportName); JasperPrint jasperPrint = JasperFillManager.fillReport(inputStream, params, new JREmptyDataSource()); byte[] data = JasperExportManager.exportReportToPdf(jasperPrint); response.setContentType("application/pdf"); response.setHeader("Content-disposition", "inline; filename=" + reportName.replace(".jasper", ".pdf")); response.getOutputStream().write(data); } } ``` 上述方法接受HTTP响应对象、目标报表名称及其关联参数列表作为输入参数；最终返回已生成完毕的PDF文档流给客户端浏览器下载或在线查看。 --- #### 控制器接口实现 最后构建RESTful API端点供外部调用访问报表生成功能: ```java @RestController @RequestMapping("/api/report") public class ReportController { private final ReportService reportService; @Autowired public ReportController(ReportService reportService){ this.reportService = reportService; } @GetMapping(value="/generate/{reportName}", produces="application/pdf") public void generate(@PathVariable String reportName, HttpServletResponse response)throws Exception{ Map<String,Object> parameters=new HashMap<>(); parameters.put("paramKey","value"); reportService.exportReport(response,reportName+".jasper",parameters); } } ``` 当用户请求特定URL地址时（例如 `/api/report/generate/exampleReport`），服务器会依据指定条件自动生成对应类型的电子档资料回馈至前端界面呈现出来。 --- #### 测试与验证 启动应用后尝试发送GET请求测试API是否正常运作。推荐利用Postman之类的调试工具来进行初步检验工作流程准确性。 ---