SpringBoot JasperReports

### Spring Boot 中集成和使用 JasperReports 进行报表生成

#### 项目依赖设置
为了在 Spring Boot 应用程序中集成 JasperReports，需要向 `pom.xml` 文件添加必要的 Maven 依赖项。这包括核心库以及任何特定于模板设计工具的附加组件。

<dependencies>
    <!-- Other dependencies -->

    <dependency>
        <groupId>net.sf.jasperreports</groupId>
        <artifactId>jasperreports</artifactId>
        <version>6.18.0</version>
    </dependency>

    <!-- If using JDBC data source -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>
    
    <!-- Optional: For PDF export support -->
    <dependency>
        <groupId>org.apache.pdfbox</groupId>
        <artifactId>pdfbox</artifactId>
        <version>2.0.27</version>
    </dependency>
</dependencies>

#### 创建控制器类处理请求并返回报告文件流
定义 RESTful Web Service 来接收参数、编译 .jrxml 文件为 .jasper 编译后的二进制格式，并填充数据源以生成最终文档对象实例化输出流给客户端下载[^1]。

import net.sf.jasperreports.engine.*;
import javax.servlet.http.HttpServletResponse;
import java.io.InputStream;

@RestController
@RequestMapping("/api/reports")
public class ReportController {

    @GetMapping(value = "/generate", produces = "application/pdf")
    public void generateReport(HttpServletResponse response) throws Exception {
        // Load compiled template from resources folder
        InputStream inputStream = getClass().getResourceAsStream("/templates/your_report.jrxml");
        
        // Compile jrxml file into jasper object
        JasperReport jasperReport = JasperCompileManager.compileReport(inputStream);
        
        // Create parameters map and datasource as needed
        Map<String, Object> params = new HashMap<>();
        JRDataSource dataSource = /* your implementation */;
        
        // Fill report with actual values
        JasperPrint jp = JasperFillManager.fillReport(jasperReport, params, dataSource);

        // Export generated document directly to HTTP output stream
        byte[] pdfBytes = JasperExportManager.exportReportToPdf(jp);
        response.setContentType("application/pdf");
        response.setHeader("Content-Disposition", "attachment; filename=report.pdf");
        IOUtils.copy(new ByteArrayInputStream(pdfBytes), response.getOutputStream());
        response.flushBuffer();
    }
}

#### 设计 `.jrxml` 报表模板并与数据库连接
利用 iReport 或 Jaspersoft Studio 工具创建自定义布局的 XML 描述符文件（`.jrxml`），该文件描述了页面结构、字段映射和其他样式属性。如果要基于 SQL 查询获取动态内容，则需指定合适的查询语句来检索所需的数据记录集合[^4]。

对于上述提到的设计好的 `.jrxml` 文件应放置于项目的资源目录下以便加载读取；而关于如何建立与 MySQL 数据库之间的联系已经在第二个参考资料中有提及到相关内容[^2]。