自定义数据集

功能及用途：如果报表的数据来源比较特殊，需要程序员自己处理，可以采用自定义数据集的方式，此时选择数据集的类型为自定义，然后在编辑界面中输入类名和需要用到的参数。报表运算时，就会自动执行createDataSet()方法来取得报表运算所需要的数据集。

◆ 实例请参考API实例 / 自定义类 / 自定义数据集

接口类介绍

IDataSetFactory是自定义数据集工厂接口，接口本身不可以实例化，用户可以自定义类实现IDataSetFactory接口中的方法。本接口提供了生成自定义数据集、监控数据集数据量的相关方法，如创建数据集、创建带监控的数据集、获取增量值总数等。

 

l  方法介绍

createDataSet

语  法：  public DataSet createDataSet(Context ctx, DataSetConfig dsc, boolean retrieve)

参数说明： 

Parameters:ctx - 报表运行上下文

dsc - 数据集配置

retrieve - 是否检索出数据，若为false则不取出数据只产生数据集的结构

功能说明：  生成自定义数据集

Returns  :    数据集对象

 

createDataSetM

语  法：  public DataSet createDataSetM(Context ctx, DataSetConfig dsc, boolean retrieve, boolean monitor)

参数说明： 

Parameters:ctx - 报表运行上下文

dsc - 数据集配置

retrieve - 是否检索出数据，若为false则不取出数据只产生数据集的结构

monitor - 是否监测数据集的值总数

功能说明：  生成自定义数据集，可以监控数据集的总行数，只在Engine中调用

Returns  :    数据集对象

 

getIncreasedValueNum

语  法：  public int getIncreasedValueNum()

功能说明：  获取监控中增加的数据集值总数，只在Engine中调用

Returns  :    增加数据集值总数

 

CustomDataSetConfig 用户自定义数据集类

l  类说明

CustomDataSetConfig 是用户自定义数据集类，它继承了DataSetConfig类，本类可以实现用户自定义数据集，可以获得和设置自定义数据集的工厂类名，获取和设置自定义数据集的参数名和参数值等等。

 

l  构造函数

类名：com.raqsoft.report.usermodel.CustomDataSetConfig

public CustomDataSetConfig()

 

l  可用方法

getFactoryClass

语  法：    public java.lang.String getFactoryClass()

功能说明：    取数据集工厂类名

Returns  ：    数据集工厂类名

调用举例：    略

 

setFactoryClass

语  法：    public void setFactoryClass(java.lang.String factoryClass)

参数说明：    factoryClass - 数据集工厂类名，必须实现IDataSetFactory接口

功能说明：    设数据集工厂类名

调用举例：    略

 

setArgNames

语  法：    public void setArgNames(java.lang.String[] argNames)

参数说明：    argNames - 参数名

功能说明：    设参数名

调用举例：    略

 

getArgNames

语  法：    public java.lang.String[] getArgNames()

功能说明：    取参数名

Returns  :     参数名

调用举例：    略

 

setArgValues

语  法：    public void setArgValues(java.lang.String[] argValues)

参数说明：    argValues - 参数值

功能说明：    设参数值

调用举例：    略

 

getArgValue

语  法：    public java.lang.String[] getArgValue()

功能说明：    取参数值

Returns  :     参数值

调用举例：    略