自定义数据集

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

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

接口类介绍

自定义的类应该由程序员自己实现，并且此类必须继承IDataSetFactory接口，IDataSetFactory接口只定义了一个方法：

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

自定义类必须实现此方法，并返回一个DataSet对象，以下是对本方法的说明：

 

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

参数说明： 

Parameters:ctx - 报表运行上下文

dsc - 数据集配置

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

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

Returns  :    数据集对象

 

createDataSet()方法由系统调用，我们不用去关心怎么调用它，而关心的是如何利用已有的方法参数，根据需要实现这个方法。

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  :     参数值

调用举例：    略