使用eclipse在jsp上显示水晶报表（六）参数

这个够呛，花了我整整三天时间。

一. 把参数完全交过水晶报表

打开报表文件.rpt，在字段资源管理器里，右击参数－》新建

在下面的选项属性里可以设置参数的名称，类型，提示文本，是否允许多个值，值范围类型（如果是字符串用离散，日期或数字用范围）

注意：上面都是比填的，如果参数是用来对应某个字段的，类型必需跟该字段一样。

在值属性里可以建一个值的列表，点上去，然后点右边的按钮就进入值列表编辑框了；是否提示时仅显示说明；编辑掩码，可以给参数的指定一定的格式；最小长度；最大长度；

现在你可以给这个报表创建一个查看器jsp，加viewer标签的就行了。

注意这个jsp的页面编码设置为UTF-8.

二. 参数所需包跟相关对象

1. 需要的java类和包

com.crystaldecisions.sdk.occa.report.data.*

com.crystaldecisions.reports.sdk.DataDefController

2. 创建一个存储参数字段的 Fields 对象。 参数对象都是放在这个里面，通过Fields对象可以添加、删除和查找参数对象

Fields fields = new Fields();

3. ParameterField 参数字段对象。

ParameterField paramField1 = new ParameterField();
4. 为想设置的每个参数字段创建一个 Values 对象。Values对象是用来存储ParameterFieldDiscreteValue 对象或 ParameterFieldRangeValue 对象
Values newVals1 = new Values();
5. 离散值对象ParameterFieldDiscreteValue 对象
ParameterFieldDiscreteValue newDiscVal1 = new ParameterFieldDiscreteValue();
ParameterFieldDiscreteValue[ ] newDiscVals = new ParameterFieldDiscreteValue[ ];
范围值对象ParameterFieldRangeValue 对象
ParameterFieldRangeValue newRangeVal1 = new ParameterFieldRangeValue();
ParameterFieldRangeValue[ ] newRangeVals = new ParameterFieldRangeValue[ ];
他们的大概关系：一个Fields－》多个ParameterField
一个ParameterField－》一个Values
一个Values－》多个ParameterFieldDiscreteValue 或ParameterFieldRangeValue
三. 后台设置参数
1. 参数的管理都是通过 报表DataDefController 来控制的。
DataDefController dataDefController ＝ new DataDefController();
对于主报表 dataDefController = reportClientDoc.getDataDefController();
对于子报表
dataDefController = clientDoc.getSubreportController().getSubreport(reportName).getDataDefController();
2. 参数的设置信息是通过 IDataDefinition 来获取的。
IDataDefinition dataDefinition = dataDefController.getDataDefinition();
如:Fields fields = dataDefController.getDataDefinition().getParameterFields() ;
而对参数的设置改动是通过 ParameterFieldController 来控制的
ParameterFieldController paramfieldcontroller= dataDefController.getParameterFieldController( );
如: 给主报表参数字段设置单个值
paramFieldController.setCurrentValue("", "StringParam", new String("Hello")); //字符串类型
paramFieldController.setCurrentValue("", "BooleanParam", new Boolean(true)); //布尔类型
paramFieldController.setCurrentValue("", "CurrencyParam", new Double(123.45));//货币类型
paramFieldController.setCurrentValue("", "NumberParam", new Integer(123)); //数字类型
给某个参数字段设置多个离散值
Object [] multiVals = {"String1", "String2", "String3"}; //注意要对应参数字段的类型
paramFieldController.setCurrentValues("", "StringMultiParam", multiVals);

3. 取得Fields
Fields fields = dataDefController.getDataDefinition().getParameterFields() ;
4. 对已经建立的参数字段，通过Fields的在知道名字的情况下通过Find方法取得
ParameterField paramField = (ParameterField)dataDefController.getDataDefinition().getParameterFields().findField(parameterName, FieldDisplayNameType.fieldName, Locale.getDefault());
参数字段七个基本类型
布尔(Boolean) 、货币(Double)、数字(Integer)、字符串(String)、日期、日期时间、时间(Date)
参数的值必须跟参数的类型符合才行.
5. 如果是新建的参数字段，那必需设置参数字段的报表名称设置为与参数关联的报表名称。如果参数字段用于主报表，则使用空白字符串 ("")。使用 setReportName 方法设置报表名称。
paramField1.setName("Country"); //设置名字
paramField1.setReportName(""); //如果为 " "就是用于主报表,如果子报表，要设置字报表名
如果是已经在rpt中存在的参数，就不用设置名字和报表名称了，也不用添加到Fields中。
newDiscVal1.setValue("China"); //设置离散值，后面将添加到参数值列表中
newDiscVal1.setDescription("The country is China.");//这个要不要都没关系
将参数字段值添加到 Values 集合对象。
newVals1.add(newDiscVal1); //可以添加多个
为参数字段设置 Values 集合。
pfield1.setCurrentValues(vals1);
向 Fields 对象添加每个参数字段。 Fields 对象现在可用于查看器
fields.add(pfield1); //非新建参数不用
下面是重点啦。虽然很简单，但是折磨了我三天
6. 改动查看报表JSP页面的参数字段离散值列表或范围值列表
先用取得paramField对象，这个前面有说怎么取得，这里不多说了
要添加的离散值
ParameterFieldDiscreteValue newDiscValue = new ParameterFieldDiscreteValue();
newDiscValue.setValue(newValue);
取得原来的Values集合，在把Values集合克隆到一个新的Values集合。我原来是用paramField.getValues()，不知道是JRC中出错还是什么，这个方法竟然完全没用，paramField.getDefaultValues().才能真正的取得参数对象的Values集合
Values newVals = (Values)paramField.getDefaultValues().clone(true);
在原来的离散值中再添加多个离散值
newVals.add(newDiscValue);
为参数字段设置新的Values集合。这里原来是用paramField.setCurrentValues(newVals)，也是不行，要用下面的 paramField.setDefaultValues(newVals);
paramField.setDefaultValues(newVals);
7. 禁用用户提示，自动使用设置的参数字段值。这在以下情况中特别有用：所设置的参数字段值对于用户为未知（例如系统生成的参数）。
　通过boolean multiValue = paramField.getAllowMultiValue();判断报表是否允许多值。

　不允许多值的情况下：
　　clientDoc.getDataDefController().getParameterFieldController().setCurrentValue(reportName, parameterName , newValue);
　　如果是用于主报表,reportName为" ",否则为子报表名称。
　　允许多值的情况下：
　　①如果不考虑原来的离散值列表
　　 String[] newValues = new String[]{"China","USA",..........};
　　clientDoc.getDataDefController().getParameterFieldController().setCurrentValues(reportName, parameterName ,newValues);
　
　　②在原来离散值列表的基础上添加新的离散值，并设置
DataDefController dataDefController = null;
if(reportName.equals(""))
dataDefController = clientDoc.getDataDefController();
else
dataDefController = clientDoc.getSubreportController().getSubreport (reportName).getDataDefController();

ParameterField paramField = (ParameterField)dataDefController.getDataDefinition().getParameterFields().findField(parameterName, FieldDisplayNameType.fieldName, Locale.getDefault());
ParameterFieldDiscreteValue newDiscValue = new ParameterFieldDiscreteValue();
newDiscValue.setValue(newValue);
Values newVals = (Values)paramField.getDefaultValues().clone(true);
newVals.add(newDiscValue);
clientDoc.getDataDefController().getParameterFieldController().setCurrentValue(reportName, parameterName ,newVals);
查看器的设置
crystalReportPageViewer.setParameterFields(fields);//这个感觉用不用都没关系
crystalReportPageViewer.setEnableParameterPrompt(false);
报表的参数设置好后，则调用查看器的刷新方法以应用新的参数。
if(session.getAttribute("refresh")==null){
crystalReportPageViewer.refresh();
session.setAttribute("refresh","true");
}
调用 processHttpRequest 方法以在当前的浏览器窗口中启动此查看器。
crystalReportPageViewer.processHttpRequest(request, response, getServletConfig().getServletContext(), null);
注意不要在查看器里面设置刷新按钮，一按就会丢失参数设置。页面编码UTF-8。如果不行就tomcat profect－》reload this context

唉，刚才写的一大段，唰一下就没了，最近的ｂｌｏｇ系统不稳定啊