玩转 Jasper Report(2) 从零开始设计动态报表模板

1. 从静态到动态：理解报表模板的核心概念

上一篇文章我们聊了怎么安装Jaspersoft Studio，并且导出了一个简单的PDF。那个例子其实是个“静态”报表，里面的内容，比如那个“从前有座山”的故事，是直接写死在模板里的。这就像你打印一份固定的通知，每份都一样。但在真实项目里，我们需要的报表往往是“动态”的。比如，你要给每个员工生成一份工资条，员工姓名、工号、各项工资明细都是变化的；或者你要生成一份销售报表，日期范围、产品类别、销售数据都需要根据查询条件实时变化。

这就是我们今天要深入探讨的：如何设计一个动态报表模板。动态报表的灵魂在于“数据驱动”，模板本身只是一个框架和样式定义，具体的内容（数据）是在程序运行时“灌”进去的。Jasper Report实现动态报表，主要依靠三大法宝：参数（Parameters）、字段（Fields） 和 变量（Variables）。你可以把它们想象成模板里的“占位符”。

参数 是最常用的，它用于接收从你的Java程序（或其他调用端）传递进来的外部数据。比如，报表的标题、查询的起止日期、当前登录的用户名，这些一次性的、独立于数据集的信息，通常定义为参数。在模板里，你用 $P{参数名} 来引用它。

字段 则与你的数据源（比如数据库查询结果集、JavaBean集合）紧密绑定。每一条数据记录都包含一系列字段，比如员工姓名、销售额、产品单价。在模板的Detail区域，你会循环展示每一条记录的字段值，用 $F{字段名} 来引用。这是实现列表数据展示的关键。

变量 稍微复杂一点，它用于在报表生成过程中进行计算和存储中间结果。比如，计算某一列数据的合计、平均值，或者进行页码计数。变量可以基于参数、字段或其他变量进行运算，用 $V{变量名} 引用。

理解了这三个核心概念，你就掌握了动态报表设计的钥匙。接下来，我们就手把手在Jaspersoft Studio里，把这些概念变成可视化的操作。我会用一个贴近实际的例子贯穿全文：假设我们要为一个简单的电商系统设计一个“订单明细报表”，这个报表需要能根据选择的日期范围动态生成，并且展示订单列表及统计总金额。

2. 实战第一步：定义数据与参数，搭建报表骨架

打开Jaspersoft Studio，按照上一篇文章的步骤，创建一个新的JasperReports项目，比如叫 EcommerceReport，然后新建一个空白A4模板，命名为 OrderDetailReport。创建时，在数据源选择那一步，我们先选“One Empty Record”，这表示我们先不连接真实数据库，专注于模板设计。真实数据填充我们留到代码里去做。

创建好后，我们先来规划一下这个订单报表需要哪些动态内容。首先，肯定需要从外部传入两个日期参数：startDate（开始日期）和 endDate（结束日期）。其次，我们的订单数据（数据集）会包含多个字段，比如 orderId（订单号）、customerName（客户名）、productName（商品名）、quantity（数量）、unitPrice（单价）、totalPrice（总价=数量*单价）。

现在，我们在Studio里定义它们。在界面左侧的“Report In