数据集对象,存放报表运算所需的原始数据。原始数据可以来自数据库、数据文件,如Text、XML等,也可以是由用户自定义的数据存储对象,最终将抽取的数据用一定的格式在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) //只给定数据集名,构造空数据集
Parameters:dataSetName- 数据集名
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 : 新数据集
调用举例: 略