ireport 56入门教程之参数(Parameters)

ireport 56入门教程之参数(Parameters) ireport5.6入门教程之参数(Parameters)ireport5.6入门教程之参数(Parameters)Parameters通常是用来在打印的时候从程序里传值到报表里。 也就是说parameters通常的是起参数传递的作用。 他们可以被用在一些特定的场合(比如应用中SQL查询的条件),如report中任何一个需要从外部传入的变量等(如一个Image对象所包括的char或报表title的字符串)。 和使用Fields一样,parameters也需要在创建的时候定义它的数据类型。 parameters的数据类型是标准的java的Object。 在ireport中，Parameters的机制是允许用户通过应用程序传递参数致报表当中。 在jasperreort中的某个对象中的expression可以通过下面的语法来访问一个当前ireport中存在的parameter:$Pparameter name。 如果应用程序没有为报表中定义的parameter赋值，那么parameter将会取我们在定义它的时候设置的default value的值。 parameters是一个JavaObject,所以如果它的类型是Object类型，我们在其default value里写下面的表达式就是错误的:0.123你必须要创建一个Object,如:New Double(0.123)这种写法就是正确的。 在查询中使用ParametersParameters可以用来做SQL查询的条件参数的传递。 如果你想根据部门编号(dept_id)得到客户的详细信息(设计的时候我们是不知道这个部门编号的具体值是多少的).此时我们可以这样组织查询语句:select*from employeewhere dept_id=$PdeptId此时SQL查询引擎将会采用PreparedStatement来处理传入的deptId值以此作为查询条件参数。 如果你想直接通过parameter值来作为SQL语句的一部分,那么你可以使用下面的特殊语法:$P!parameter name。 这种写法允许你在查询时用parameter的值来替换parameter name。 例如,如果我们有一个参数名为MyWhere其值为:where dept_id=D11,查询写法如下:Select*from employee$P!MyWhere查询时实际提交的字符串是:Select*from employeewhere dept_id=D11在程序里使用Parameters在应用程序里，如果想把某个值传递到我们的报表中parameters时，我们可以把相关的值放入一个扩展java.util.Map接口类里，然后传入到ireport里。 如下面的代码:.Map hm=new HashMap();.JasperPrint print=JasperFillManager.fillReport(fileName,hm,newJREmptyDataSource();fillReport是一个关键的方法,它允许你通过一个文件名,一个参数集来传递到我们要调用的报表当中。 例-如通过下面的处理方法我们可以让一个处部的传入值作为我们报表的title。 下面的是一个例子a).声明一个parameter.这个parameter是java.lang.String类型，名字为name_report:b).将这个parameter拖到page中的title band.修改上面的程序代码如下HashMap hm=new HashMap();hm.put(“name_report”,”report title”);.JasperPrint print=JasperFillManager.fillReport(fileName,hm,new JREmptyDataSource();运行时效果如下一般情况下，我们不需要为报表中的每一个parameters传递一个值，除非某一个parameter一定要从外部程序传入时我们才需为一个parameter设置一个值。 如果一个parameter外部门程序没有为其赋值那么ireport将使用Default ValueExpression来对一个parameter进行初始化，如果连DefaultValue Expression没有设置那么它的值就是null。 事实上，对于一个parameters我们不仅仅可以传递一个String,Integer,Boolean等java中小的对象，同时我们还可以利用parameters来传递一些足够大足够复杂的对象,比如一个图像（java.awt.Image）,或者通过一个parameters来为一个为子报表提供的datasource连接等。 在用Map类型传递参数时我们要注意传递的参数要与report里的parameters类型保持一致，否则会抛出ClassCastException。 ireport内嵌的Parametersireport提供了一些内建的parameters，这些parameters对于用户来说是只读的。 内嵌的parameters列表如下参数名说明REPORT_PARAMETERS_MAP它是一个java.util.Map类型的对象，可以通过它来传给填充报表去填充报表里所有的parameters，在这个参数里还包含用户定义的parameters.REPORT_CONNECTION一个JDBC的Connection参数，报表可以根据传入的JDBC Connection来获到相应的数据REPORT_DATASOURCE为报表中的Connection提供一个DataSource。 外部传入的时候类型也要是DataSource类型REPORT_SCRIPTLET报表生成时使用的Scriptlet实例，如果没有指定ScriptLet，那么这个parameters将使用.sf.jasperreports.engine.JRDefaultScriptlet.IS_IGNORE_PAGINATION通过这个参数你可以控制分页功能是打开还是关闭。 默认情况下，分页是打开的。 但是如果导出为HTML或EXCEL时不进行分页处理。 REPORT_LOCALE它被用来设置报表所处的地区。 如果没有提供地区，那么将采用系统默认的地区。 REPORT_TIME_ZONE设置报表的时区，如果没提供的话采用系统默认的。 REPORT_RESOURCE_BOUNDLE为报表指定要加载的资源文件，在国际化一章中介绍了如何使用资源文件来构建报表。 同为比较常用的java报表生成工具，FineReport对参数的解读和使用方法与ireport有所不同，具体实现思路和步骤如下，供ireport使用者借鉴在大多数情况下，我们并不需要报表把数据库中所有的数据都呈现出来，而是要根据一些条件来过滤出我们想要的数据，这就是参数查询。 FineReport报表中就是使用参数来动态的过滤数据的，实现用户和数据的实时交互，如下图注鼠标移至参数界面的中间区域会出现收缩按钮，折叠或展开参数查询界面。 如何实现参数查询如何实现参数查询几乎所有的统计报表都会有类似上图的统计条件，传统的做法是使用如ext、html等编程实现，工作量大且维护成本高。 Finereport报表只需要通过参数的定义，添加参数控件绑定数据、参数过滤和参数面板样式三个步骤便可以轻松实现参数查询，零代码，维护简单。 实现步骤实现步骤FR报表提供了参数界面的概念，让用户快速制作出参数表单界面，制作参数查询界面的步骤如下参数定义设置参数名称，添加参数，根据实际情况的不同添加不同种类的参数，详细请查看参数的种类与区别。 添加控件绑定数据FineReport参数查询，是在参数面板中添加控件，使控件名字与参数名称一样，通过该控件将其控件值传递给参数，实现动态修改参数值得效果，可为控件绑定数据，直接选择；参数面板样式设定设置参数界面中控件的位置，参数面板的位置，背景等等。 参数应用实例之参数应用实例之URL给参数传递中文值给参数传递中文值虽然我们建议模板名称、参数变量名称都用英文，但是对于中国式的复杂报表，参数肯定有中文情况。 使用ie浏览器通过url给参数赋值为中文时，会发现中文值会出现乱码，如下图所示问题原因问题原因因为浏览器编码与服务器编码不一致，导致中文url输入会产生乱码，无法被正常识别。 解决方案解决方案通过url给参数赋值一般应用在报表已经集成到项目中，希望点击某个链接将某个值传递给报表；而在浏览器中直接给参数赋值呢，一般是做测试使用的，此时可以将浏览器换成火狐或者谷歌。 集成