JasperReport动态添加子报表、数据库存储及子报表填充方法问询

1. 如何在JasperReport中动态添加子报表？ #

要动态添加子报表，核心思路是把编译好的子报表对象通过参数传递给主报表，具体步骤如下：

• 从数据库（或你的存储源）读取子报表的XML字节内容，编译为JasperReport对象
• 将这些子报表对象存入参数Map——可以是单独的参数（每个子报表一个参数），也可以用一个统一的Map来管理所有子报表
• 在主报表的子报表元素配置中，通过表达式引用对应的参数或Map中的子报表

你代码里的subReports.forEach循环就是处理子报表的关键位置，具体实现看后面的完整代码示例。

2. 是否可创建包含两个子报表的报表并将所有文件存入数据库？ #

当然可以！完全不需要依赖本地文件系统，你可以把主报表和所有子报表的XML内容都存在数据库的BLOB字段里。使用时直接从数据库读取字节流，加载、编译成JasperReport对象即可，所有报表模板都在数据库中统一管理，非常方便。

3. 在主报表中填充子报表的方法是什么？是否需要将子报表存入临时文件并传递路径？ #

绝对不需要临时文件！这是很多新手容易走的弯路——JasperReports原生支持直接使用内存中的JasperReport对象来填充子报表，不用生成临时文件再传路径。

推荐两种常用的实现方式：

• 单独参数传递：给每个子报表定义一个专属参数（比如SUBREPORT_INVOICE），把编译后的子报表对象直接放入参数Map，主报表里的子报表元素直接引用该参数
• 全局子报表Map：使用JasperReports内置的JRParameter.REPORT_SUBREPORTS参数，这是一个Map<String, JasperReport>，把所有子报表按自定义名称存入这个Map，主报表里通过$P{REPORT_SUBREPORTS}.get("子报表名称")来引用

下面是修改后的完整代码，已经包含子报表的编译和传递逻辑：

try (Connection conexao = dataSource.getConnection()) { 
    FinanceiroTransacao transacao = financeiroTransacaoService.findGatewayIdTransacaoByBoletoAndCartorio(boletoId, cns); 
    JasperReport jasperReport; 
    // 从数据库加载主报表XML并编译
    jasperReport = JasperCompileManager.compileReport(JRXmlLoader.load(new ByteArrayInputStream(relatorioBase.getConteudo()))); 
    Map<String, Object> params = new HashMap<>(); 
    params.put("pedidoId", pedidoId); 
    params.put("boletoId", boletoId); 
    params.put("cartorio",cns); 
    params.put("totalTransacao", transacao.getValorCredito()); 
    params.put("idTransferencia", transacao.getGatewayPagamentoTransacaoId()); 
    params.forEach((s, o) -> log.debug("paramentro {} , valor {}", s, o)); 

    // 处理子报表：编译并存入全局Map
    Map<String, JasperReport> subReportMap = new HashMap<>();
    subReports.forEach(subReport -> {
        try {
            // 从数据库加载子报表XML并编译
            JasperReport compiledSubReport = JasperCompileManager.compileReport(
                JRXmlLoader.load(new ByteArrayInputStream(subReport.getConteudo()))
            );
            // 用子报表的唯一标识（比如ID）作为Map的key，方便主报表精准引用
            String subReportKey = "subReport_" + subReport.getId();
            subReportMap.put(subReportKey, compiledSubReport);
            log.debug("已编译并添加子报表：{}", subReportKey);
        } catch (JRException e) {
            log.error("编译子报表失败", e);
            throw new RuntimeException("编译子报表出错: " + e.getMessage());
        }
    });
    // 将子报表Map传入主报表的内置参数
    params.put(JRParameter.REPORT_SUBREPORTS, subReportMap);

    JasperPrint jasperPrint = JasperFillManager.fillReport(jasperReport, params, conexao); 
    JRPdfExporter pdfExporter = new JRPdfExporter(); 
    pdfExporter.setExporterInput(new SimpleExporterInput(jasperPrint)); 
    ByteArrayOutputStream pdfReportStream = new ByteArrayOutputStream(); 
    pdfExporter.setExporterOutput(new SimpleOutputStreamExporterOutput(pdfReportStream)); 
    pdfExporter.exportReport(); 
    String retorno = Base64.getEncoder().encodeToString(pdfReportStream.toByteArray()); 
    pdfReportStream.close(); 
    return retorno; 
} catch (Exception e) { 
    e.printStackTrace(); 
    throw new RuntimeException("erro: "+ e.getMessage()); 
}

主报表配置注意事项

在JasperSoft Studio设计主报表时，选中子报表元素，在Subreport Expression中填写如下格式的表达式（要和代码中Map的key对应）：

$P{REPORT_SUBREPORTS}.get("subReport_1")

内容的提问来源于stack exchange，提问作者Fabio Ebner