DataSet- 数据集对象

阅读(3389) 标签: 自定义数据集, 数据,

数据集对象,存放报表运算所需的原始数据。原始数据可以来自数据库、数据文件,如TextXML等,也可以是由用户自定义的数据存储对象,最终将抽取的数据用一定的格式在DataSet中存储,既所谓数据集对象。

数据集从本质上是一张虚拟的二维表,第一行定义为“字段名”,第一行后全为数据行。

 

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

 

l  构造函数

类名:com.raqsoft.report.dataset.DataSet

public DataSet(int initRowCap,int colCount,java.lang.String dataSetName) //构造一个指定初始行列及数据集名的数据集

Parameters: 

initRowCap - 初始行数

colCount - 列数

dataSetName - 数据集名称

 

public DataSet(int colCount,java.lang.String dataSetName) //构造一个指定初始列及数据集名的数据集

Parameters: 

colCount - 列数

dataSetName- 数据集名

 

public DataSet(java.lang.String dataSetName) //只给定数据集名,构造空数据集

ParametersdataSetName- 数据集名

 

l  可用方法

addCol

  法:    public void addCol(java.lang.String colName)

参数说明:    colName - 列名,可以理解成在表达式中引用的字段名

功能说明:    添加列,注意,增加列的操作需要在增加行之前完成

Returns  :    

调用举例:     dataSet.addCol(“name”);

 

addRowData

  法:    public java.lang.Object[] addRowData(boolean b)

参数说明:    b - 是否返回新行

功能说明:    添加数据集的行数

Returns  :     返回所加行的数据组

调用举例:    

 

addRowData

  法:    public java.lang.Object[] addRowData()

功能说明:    添加数据集的行数

Returns  :     返回所加行的数据组

调用举例:    

 

addRow

  法:    public Row addRow()

功能说明:    添加行

Returns  :     返回新行

调用举例:     Row row = dataSet.addRow();

 

caseSensitive

  法:    public boolean caseSensitive()

功能说明:    取大小写是否敏感

Returns  :     返回数据集中大小写是否敏感

调用举例:    

 

getDataSetName

  法:    public java.lang.String getDataSetName()

功能说明:    获取数据集名称

Returns  :     数据集名称,如ds1

调用举例:     String dataSetName = dataSet. getDataSetName ();

 

getColCount

  法:    public int getColCount()

功能说明:    取得数据集的列数

Returns  :     数据集的列数

调用举例:     int colCount = dataSet. getColCount ();

 

getColNames

  法:    public java.lang.String[] getColNames()

功能说明:    取列名集

Returns  :     列名集

调用举例:     String[] colNames = dataSet. getColNames ();

 

setColNames

  法:    public void setColNames(java.lang.String[] colNames)

参数说明:    colNames - 列名集

功能说明:    设列名集

Returns  :    

调用举例:     String[] colNames = {“id”,”name”,”age”,”sex”}

        dataset.setColNames(colNames);

isColName

  法:    public boolean isColName(java.lang.String colName)

参数说明:    colName - 指定的列名称

功能说明:    判断某字符串是否列名

Returns  :     判断结果,true或者false

调用举例:    

 

getColName

  法:    public java.lang.String getColName(int colNo)

参数说明:    colNo - 列号

功能说明:    通过列号取列名

Returns  :     指定列号的列名

调用举例:     String colName = dataset.getColName(3);

 

getColNo

  法:    public int getColNo(java.lang.String colName)

参数说明:    colName - 列名

功能说明:    取指定列名的列号

Returns  :     返回列号,如果没有此列名则返回-1

调用举例:     int colNo = dataset.getColNo(“name”);

 

getColTitles

  法:    public java.lang.String[] getColTitles()

功能说明:    取列标题集

Returns  :     返回列标题集

调用举例:    

 

setColTitles

  法:    public void setColTitles(java.lang.String[] colTitles)

参数说明:    colTitles - 列标题集,字符串组

功能说明:    设列标题集,设置时注意要与colNames对应

Returns  :    

调用举例:    

 

setCaseSensitive

  法:    public void setCaseSensitive(boolean sensitive)

参数说明:    sensitive - 大小写是否敏感

功能说明:    设大小写是否敏感

Returns  :    

调用举例:    

 

isColTitle

  法:    public boolean isColTitle(java.lang.String title)

参数说明:    title - 初判断的列标题

功能说明:    判断某列标题是否存在

Returns  :     判断结果,为true或者false

调用举例:    

 

getColNoFromTitle

  法:    public int getColNoFromTitle(java.lang.String title)

参数说明:    title - 列标题

功能说明:    取某列标题的列号

Returns  :     返回列号

调用举例:     int colon = dataset.getColNoFromTitle(“name”);

 

getTitle

  法:    public java.lang.String getTitle(int colNo)

参数说明:    colNo - 列号

功能说明:    取某列的标题

Returns  :     返回列标题

调用举例:     String colTitle = dataset. getTitle (3);

 

setColType

  法:    public void setColType(int[] types)

参数说明:    types - 列类型,与java的数据类型同

功能说明:    设定列类型,只有生成参数表单时使用

Returns  :    

调用举例:    

 

getColType

  法:    public int[] getColType()

功能说明:    获取列类型,只有生成参数表单时使用

Returns  :     数据集的各字段类型

调用举例:    

 

getRowCount

  法:    public int getRowCount()

功能说明:    取数据集行数

Returns  :     行数

调用举例:     int rowNum = dataset.getRowCount();

 

setData

  法:    public void setData(int row,int col, java.lang.Object value)

参数说明:   

row - 行号

col - 列号

value - 位置数据

功能说明:    设定某位置数据

Returns  :    

调用举例:     dataSet.setData(1,2,Integer(100));

 

getData

  法:    public java.lang.Object getData(int row, int col)

参数说明:   

row - 行号

col - 列号

功能说明:    获得某位置数据

Returns  :     某位置的数据

调用举例:     Integer value = dataSetgetData(1,2);

 

getRowData

  法:    public java.lang.Object[] getRowData(int rowNo)

参数说明:    row - 行号

功能说明:    取行数据组

Returns  :     返回行数据组

调用举例:    

 

setDataSetName

  法:    public void setDataSetName(java.lang.String name)

参数说明:    name – 参数名

功能说明:    设置数据集名称

Returns  :     数据集名称

调用举例:    

 

getNullGroup

  法:    public Group getNullGroup()

功能说明:    取空组

Returns  :     空组

调用举例:    

 

getNullRow

  法:    public Group getNullRow()

功能说明:    取空行

Returns  :     空行

调用举例:    

 

setColInfoList

  法:    public void setColInfoList(java.util.ArrayList cil)

功能说明:    设置列信息列表,列信息中不包含0列的列号列,0列开始是正常列信息就行

参数说明:     cil-列信息列表

调用举例:    

 

getColInfoList

  法:    public java.util.ArrayList getColInfoList()

功能说明:    设置列信息列表,获取的列信息中不包含0列的列号列,0列开始是正常列信息

Returns  :     列信息列表

调用举例:    

 

addColInfo

  法:    public void addColInfo(ColInfo ci)

参数说明:    ci - 普通列信息

功能说明:    添加列信息

调用举例:   

 

addColInfo

      public void addColInfo(int colNo,ColInfo ci)

参数说明:    colNo - 列号,从0开始

ci - 普通列信息

功能说明:    按列号添加普通列

调用举例:   

 

getColInfo

  法:    public ColInfo getColInfo(int colNo)

参数说明:    colNo - 列号,从0开始

功能说明    按列号取普通列信息

Returns      普通列信息

调用举例:   

 

getTitles

  法:    public java.lang.String[] getTitles ()

功能说明    取所有列的列标题,无列标题则使用列名,不包括行号列的标题

Returns      列标题组

调用举例:   

 

getTitle

  法:    public java.lang.String getTitles (java.lang.String colName)

功能说明    取某列名的列标题

参数说明:  colName – 列名

Returns      列标题

调用举例:   

 

createGroup

  法:    public Group createGroup ()

功能说明    新建组

Returns      新组

调用举例:   

 

setCurrent

  法:    public void setCurrent(DsValue g, boolean isleftTop)

功能说明    设置当前组

参数说明:  g-dsValue, isleftTop

调用举例:   

 

isLeftTop

  法:    public boolean isLeftTop()

功能说明    是否左上

调用举例:   

 

getCurrent

  法:    public DsValue getCurrent()

功能说明    获取当前组

Returns  :  当前组

调用举例:   

 

getRootGroup

  法:    public Group getRootGroup()

功能说明    RootGroup

Returns  :  RootGroup

调用举例:   

 

clone

  法:     public java.lang.Object clone ()

功能说明    复制本数据集

Returns  :  新数据集

调用举例: