自定义数据集

阅读(6633) 标签: 数据来源, 自定义类, 接口,

功能及用途:如果报表的数据来源比较特殊,需要程序员自己处理,可以采用自定义数据集的方式,此时选择数据集的类型为自定义,然后在编辑界面中输入类名和需要用到的参数。报表运算时,就会自动执行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  :     参数值

调用举例: