CRomputer-罗军1. 项目概述
iReport作为一款开源的报表设计工具，在数据可视化领域已经服务了开发者十余年。虽然JasperReports Studio等新工具逐渐成为主流，但仍有大量传统系统依赖iReport进行报表开发。最近在给某金融客户做系统迁移时，我发现他们80%的定制报表仍在使用iReport维护，其中参数配置是最常被咨询的问题。
报表参数就像SQL查询中的变量，允许用户动态过滤数据。但不同于编程语言中的变量声明，iReport的参数系统有其独特的运作机制。本教程将基于5.6.0版本，从参数创建到高级用法，手把手带你掌握这个看似简单却暗藏玄机的功能模块。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 参数基础配置
2.1 参数创建流程
在iReport中创建参数，远不止在界面上填几个字段那么简单。点击"Parameters"文件夹右键选择"Add Parameter"后，需要关注以下核心属性：
- Name：遵循Java变量命名规范，建议用下划线连接语义化词汇（如start_date）
- Parameter Class：这决定了参数的数据类型，常见选择包括：
- java.lang.String（默认）
- java.util.Date（日期型）
- java.lang.Integer（整型）
- java.math.BigDecimal（高精度数值）
注意：Class类型必须与SQL查询或Java代码中的使用场景严格匹配，类型不匹配是参数失效的常见原因。
- Default Value Expression：通过这里可以设置动态默认值，例如：
java复制new java.util.Date() // 当前日期 "ALL" // 固定字符串 $P{parent_param} + "_suffix" // 引用其他参数
2.2 参数传递机制
iReport支持三种参数传递方式，对应不同的使用场景：
| 传递方式 | 适用场景 | 配置要点 |
|---|