Recordset

java.lang.Object
- com.supermap.data.Recordset

public class Recordset
extends java.lang.Object

记录集类。

通过此类，可以实现对矢量数据集中的数据进行操作。

数据源有文件型,在文件型数据中空间几何信息和属性信息是分别存储的，记录集的应用可能比较让人费解，实际上，操作时是将数据都看成是一个空间信息和属性信息一体化存储的表，而记录集是从其中取出的用来操作的一个子集。记录集中的一条记录，即一行，对应着一个要素，包含该要素的空间几何信息和属性信息。记录集中的一列对应一个字段的信息。

记录集可通过两种方式获得：在地图控件中选中若干个几何对象形成一个选择集，然后把选择集转换为记录集；或者从矢量数据集中获得一个记录集，有两种方法：用户可以通过 DatasetVector.getRecordset() 方法直接从矢量数据集中返回记录集，也可以通过查询语句返回记录集，所不同的是前者得到的记录集包含该类集合的全部空间几何信息和属性信息，而后者得到的是经过查询语句条件过滤的记录集。

注意：用户得到 Recordset 对象后，当执行完系列操作后，需要对该对象进行释放。

示例:

以下代码示范如何删除一条记录以及添加记录。假设打开一个工作空间 workspace 对象，工作空间中存在一个数据源 datasource 对象

 public void recordsetTest() {
        // 从中取出名为“World”（面数据集）的矢量数据集 dataset_world，和名为“Example”（面数据集）的矢量数据集 dataset
        DatasetVector dataset_world = (DatasetVector) datasource.getDatasets().get("World");
        DatasetVector dataset = (DatasetVector) datasource.getDatasets().get("Example");
 
        // 得到“Example”对应的所有记录集以及“World”中 SmID=1 的记录
        Recordset recordset = dataset.getRecordset(false, CursorType.DYNAMIC);
        QueryParameter parameter = new QueryParameter();
        parameter.setAttributeFilter("SmID=1");
        parameter.setCursorType(CursorType.STATIC);
        Recordset recordset_world = dataset_world.query(parameter);
 
        // 将记录位置移到第一位
        recordset.moveFirst();
 
        // 将当前记录删除
        recordset.delete();
 
        // 将“World”中 SmID=1 的记录添加到 recordset 中并提交
        Geometry geometry = recordset_world.getGeometry();
        recordset.update();
        recordset.addNew(geometry);
        recordset.update();
 
        // 关闭记录集，释放几何对象、记录集
        recordset.close();
        geometry.dispose();
        recordset.dispose();
        recordset_world.dispose();
 }

嵌套类概要

嵌套类
限定符和类型类和说明

class Recordset.BatchEditor
该类作为 Recordset 类的内部类，主要提供记录的批量更新的功能。

嵌套类
限定符和类型	类和说明
`class`	`Recordset.BatchEditor` 该类作为 Recordset 类的内部类，主要提供记录的批量更新的功能。

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`boolean`	`addNew(Geometry geometry)` 用于在记录集中添加一条记录。
`boolean`	`addNew(Geometry geometry, java.util.Map<java.lang.String,java.lang.Object> values)` 添加几何对象及设置相关的字段值。
`boolean`	`cancelUpdate()` 用于取消在调用 update方法前对当前记录或新记录所做的任何更改。
`void`	`close()` 用于关闭记录集。
`boolean`	`delete()` 用于删除数据集中的当前记录，成功则返回 true。
`boolean`	`deleteAll()` 物理性删除指定记录集中的所有记录，即把记录从计算机的物理存储介质上删除，无法恢复。
`void`	`dispose()` 释放该对象所占用的资源。
`boolean`	`edit()` 锁定并编辑记录集的当前记录，成功则返回 true。
`boolean`	`fromGeoJSON(java.lang.String geoJSON)` 从GeoJSON中的字符串中获取几何对象，及其所以属性值，并将其更新到数据集支持的几何对象类型包括：点、线、面、多线
`Recordset.BatchEditor`	`getBatch()` 返回批量更新对象。
`boolean`	`getBoolean(int index)` 用于返回数据集的属性数据表中当前记录为“布尔”类型字段的值。
`boolean`	`getBoolean(java.lang.String name)` 用于返回数据集的属性数据表中当前记录为“布尔”类型字段的值。
`Rectangle2D`	`getBounds()` 返回记录集的属性数据表中所有记录对应的几何对象的外接矩形。
`byte`	`getByte(int index)` 用于返回数据集的属性数据表中当前记录为“字节”类型字段的值。
`byte`	`getByte(java.lang.String name)` 用于返回数据集的属性数据表中当前记录为“字节”类型字段的值。
`DatasetVector`	`getDataset()` 返回记录集对应的数据集。
`java.util.Date`	`getDateTime(int index)` 用于返回数据集的属性数据表中当前记录为“日期”类型字段的值。
`java.util.Date`	`getDateTime(java.lang.String name)` 用于获得数据集的属性数据表中当前记录为“日期”类型字段的值。
`double`	`getDouble(int index)` 用于返回数据集的属性数据表中当前记录为“双精度”类型字段的值。
`double`	`getDouble(java.lang.String name)` 用于返回数据集的属性数据表中当前记录为“双精度”类型字段的值。
`int`	`getFieldCount()` 返回记录集中字段（Field）的数目。
`FieldInfos`	`getFieldInfos()` 返回记录集里的字段信息集合对象。
`java.lang.Object`	`getFieldValue(int index)` 根据字段序号指定字段，返回数据集的属性数据表中当前记录相应字段的值。
`java.lang.Object`	`getFieldValue(java.lang.String name)` 根据字段名指定字段，返回数据集的属性数据表中当前记录该字段的值。
`Geometry`	`getGeometry()` 用于返回数据集的属性数据表中当前记录对应的几何对象。
`int`	`getID()` 用于返回数据集的属性表中当前记录对应的几何对象的 ID 号（即 SmID 字段的值）。
`short`	`getInt16(int index)` 用于返回数据集的属性数据表中当前记录为“16位整型”类型字段的值。
`short`	`getInt16(java.lang.String name)` 用于返回数据集的属性数据表中当前记录为“16位整型”类型字段的值。
`int`	`getInt32(int index)` 用于返回数据集的属性数据表中当前记录为“32位整型”类型字段的值。
`int`	`getInt32(java.lang.String name)` 用于返回数据集的属性数据表中当前记录“32位整型”类型字段的值。
`long`	`getInt64(int index)` 用于返回数据集的属性数据表中当前记录为“64位整型”类型字段的值。
`long`	`getInt64(java.lang.String name)` 用于返回数据集的属性数据表中当前记录“64位整型”类型字段的值。
`byte[]`	`getLongBinary(int index)` 用于返回数据集的属性数据表中当前记录为“二进制”类型字段的值。
`byte[]`	`getLongBinary(java.lang.String name)` 用于返回数据集的属性数据表中当前记录为“二进制”类型字段的值。
`QueryParameter`	`getQueryParameter()` 得到当前记录集对应的查询参数,返回一个副本。
`int`	`getRecordCount()` 返回记录集中的记录数。
`float`	`getSingle(int index)` 用于返回数据集的属性数据表中当前记录为“单精度”类型字段的值。
`float`	`getSingle(java.lang.String name)` 用于返回数据集的属性数据表中当前记录为“单精度”类型字段的值。
`java.lang.String`	`getString(int index)` 用于返回数据集的属性数据表中当前记录为“文本”类型字段的值。
`java.lang.String`	`getString(java.lang.String name)` 用于返回数据集的属性数据表中当前记录为“文本”类型字段的值。
`boolean`	`isBOF()` 判断当前记录的位置是否在记录集中第一条记录的前面（当然第一条记录的前面是没有数据的），如果是返回 true；否则返回 false。
`boolean`	`isClosed()` 判断记录集是否已经关闭。
`boolean`	`isEOF()` 判断当前记录的位置是否在记录集中的最后一条记录的后面，如果是，返回 true；否则返回 false。
`boolean`	`isReadOnly()` 返回记录集是否是只读的，如果是只读的，则返回 true，表示记录集中的信息将不可被修改。
`boolean`	`move(int count)` 将当前记录位置移动 count 行，将该位置的记录设置为当前记录。
`boolean`	`moveFirst()` 用于移动当前记录位置到第一条记录，使第一条记录成为当前记录。
`boolean`	`moveLast()` 用于移动当前记录位置到最后一条记录，使最后一条记录成为当前记录。
`boolean`	`moveNext()` 移动当前记录位置到下一条记录，使该记录成为当前记录。
`boolean`	`movePrev()` 移动当前记录位置到上一条记录，使该记录成为当前记录。
`boolean`	`moveTo(int position)` 用于移动当前记录位置到指定的位置，将该指定位置的记录作为当前记录。
`boolean`	`seekID(int id)` 在记录中搜索指定 ID 号的记录，并定位该记录为当前记录。
`boolean`	`setBoolean(int index, boolean value)` 用于设置记录集中某一字段的值，成功则返回 true。
`boolean`	`setBoolean(java.lang.String name, boolean value)` 用于设定记录集中某一字段的值，成功则返回 true。
`boolean`	`setByte(int index, byte value)` 用于设置记录集中当前记录某一字段的值，设置成功则返回 true。
`boolean`	`setByte(java.lang.String name, byte value)` 用于设置记录集中当前记录某一字段的值，设置成功则返回 true。
`boolean`	`setDateTime(int index, java.util.Date value)` 用于设置记录集中某一字段的值，成功则返回 true。
`boolean`	`setDateTime(java.lang.String name, java.util.Date value)` 用于设置记录集中某一字段的值，成功则返回 true。
`boolean`	`setDouble(int index, double value)` 用于设置记录集中某一字段的值，成功则返回 true。
`boolean`	`setDouble(java.lang.String name, double value)` 用于设置记录集中某一字段的值，成功则返回 true。
`boolean`	`setFieldValue(int index, java.lang.Object value)` 根据要修改的字段的序号，设定记录集中相应字段的值。
`boolean`	`setFieldValue(java.lang.String name, java.lang.Object value)` 根据要修改的字段的名称，设定记录集中相应字段的值。
`boolean`	`setFieldValueNull(int index)` 根据字段序号，设定记录集中相应字段的值为 null，成功则返回 true。
`boolean`	`setFieldValueNull(java.lang.String name)` 根据字段名称，设定记录集中相应字段的值为 null，成功则返回 true。
`boolean`	`setGeometry(Geometry geometry)` 用于修改记录集当前位置的几何对象，覆盖原来的几何对象，成功则返回true。
`boolean`	`setInt16(int index, short value)` 用于设置记录集中当前记录某一“16位整型”类型字段的值，设置成功则返回 true。
`boolean`	`setInt16(java.lang.String name, short value)` 用于设置记录集中当前记录某一“16位整型”类型字段的值，设置成功则返回 true。
`boolean`	`setInt32(int index, int value)` 用于设置记录集中某一字段的值，成功则返回 true。
`boolean`	`setInt32(java.lang.String name, int value)` 用于设置记录集中某一字段的值，成功则返回 true。
`boolean`	`setInt64(int index, long value)` 用于设置记录集中某一字段的值，成功则返回 true。
`boolean`	`setInt64(java.lang.String name, long value)` 用于设置记录集中某一字段的值，成功则返回 true。
`boolean`	`setLongBinary(int index, byte[] value)` 用于设置记录集中某一字段的值，成功则返回 true。
`boolean`	`setLongBinary(java.lang.String name, byte[] value)` 用于设置记录集中某一字段的值，成功则返回 true。
`boolean`	`setSingle(int index, float value)` 用于设置记录集中某一字段的值，成功则返回 true。
`boolean`	`setSingle(java.lang.String name, float value)` 用于设置记录集中某一字段的值，成功则返回 true。
`boolean`	`setString(int index, java.lang.String value)` 用于设置记录集中某一字段的值，成功则返回 true。
`boolean`	`setString(java.lang.String name, java.lang.String value)` 用于设定记录集中某一字段的值，成功则返回 true。
`double`	`statistic(int fieldIndex, StatisticMode mode)` 对指定字段进行诸如最大值、最小值、平均值，总和，标准差和方差等方式的统计。
`double`	`statistic(java.lang.String fieldName, StatisticMode mode)` 对指定字段进行诸如最大值、最小值、平均值，总和，标准差和方差等方式的统计。
`java.lang.String`	`toGeoJSON(boolean hasAttributte, int count)` 从当前记录起，将数据集中的指定数目的记录转换成GeoJSON格式的字符串支持的几何对象类型包括：点、线、面、多线，该方法最多支持获取包含连续10条记录的GeoJSON串.hasAttributte为true时，返回Feature类型的字符串；hasAttributte为false时，返回只含几何对象的Geometry类型的字符串
`boolean`	`update()` 用于提交对记录集的修改，包括添加、编辑记录、修改字段值的操作。

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - getBounds
```
public Rectangle2D getBounds()
```
    返回记录集的属性数据表中所有记录对应的几何对象的外接矩形。
    
    返回:
    
    记录集的属性数据表中所有记录对应的几何对象的外接矩形。
  - getDataset
```
public DatasetVector getDataset()
```
    返回记录集对应的数据集。
    
    返回:
    
    记录集对应的数据集。
  - getFieldInfos
```
public FieldInfos getFieldInfos()
```
    返回记录集里的字段信息集合对象。字段信息集合类的详细信息参见 FieldInfos 类。
    
    返回:
    
    一个 Fieldinfos 的副本。
  - getFieldCount
```
public int getFieldCount()
```
    返回记录集中字段（Field）的数目。
    
    返回:
    
    字段（Field）的数目。
  - isClosed
```
public boolean isClosed()
```
    判断记录集是否已经关闭。记录集已经关闭返回 true，否则返回 false。
    
    返回:
    
    记录集是否已经关闭。
    
    默认值:
    
    默认值为 false，即记录集尚未关闭。
  - edit
```
public boolean edit()
```
    锁定并编辑记录集的当前记录，成功则返回 true。用该方法编辑后，一定要用 update() 方法更新记录集，而且在 update() 之前不能移动当前记录的位置，否则编辑失败，记录集也可能被损坏。
    
    返回:
    
    编辑成功返回 true，否则返回 false。
  - isBOF
```
public boolean isBOF()
```
    判断当前记录的位置是否在记录集中第一条记录的前面（当然第一条记录的前面是没有数据的），如果是返回 true；否则返回 false。
    
    返回:
    
    当前记录是否在第一条记录的前面。
    
    另请参阅:
    
    Recordset
    
    示例:
    
    请参见 Recordset 类的示例。
  - isEOF
```
public boolean isEOF()
```
    判断当前记录的位置是否在记录集中的最后一条记录的后面，如果是，返回 true；否则返回 false。
    
    返回:
    
    当前记录是否在最后一条记录的后面。
  - isReadOnly
```
public boolean isReadOnly()
```
    返回记录集是否是只读的，如果是只读的，则返回 true，表示记录集中的信息将不可被修改。
    
    返回:
    
    记录集是否只读。
  - getRecordCount
```
public int getRecordCount()
```
    返回记录集中的记录数。
    
    返回:
    
    记录集中的记录数。
  - addNew
```
public boolean addNew(Geometry geometry)
```
    用于在记录集中添加一条记录。
    - 对于只读打开的数据源，其数据集的记录集的此方法不可用；
    - 在新增记录的时候，不能对记录集进行锁定并编辑（edit），否则 Recordset.addNew() 方法会失败；
    - 当传入的参数为空时，只有记录集所在的数据集为属性数据集时该方法才可用，如果是其他类型的数据集，调用 Recordset.addNew() 方法会失败。
    参数:
    
    geometry - 要追加的记录对应的几何对象，可以是点、线、面、注记等几何对象。该参数可以为 null。
    
    返回:
    
    添加成功，返回值为 true，否则返回 false。
    
    另请参阅:
    
    Recordset
    
    示例:
    
    请参见 Recordset 类的示例。
  - addNew
```
public boolean addNew(Geometry geometry,
                      java.util.Map<java.lang.String,java.lang.Object> values)
```
    添加几何对象及设置相关的字段值。
    在使用该方法之后，需要调用 update方法来提交修改，保存结果。
    
    参数:
    
    geometry - 需要添加的几何对象
    
    values - 需要设置的属性值，键为字段名称，值为对应字段的值。注：如果所自定的字段名称在记录集中不存在，或对应的值与字段类型不一致，对应的值就忽略。
    
    返回:
    
    一个布尔值，添加成功返回 true，否则返回 false。
    
    示例:
    
    请参见 Recordset.BatchEditor 类的示例。
  - cancelUpdate
```
public boolean cancelUpdate()
```
    用于取消在调用 update方法前对当前记录或新记录所做的任何更改。成功则返回 true。
    
    返回:
    
    成功则返回 true,否则返回 false。
  - update
```
public boolean update()
```
    用于提交对记录集的修改，包括添加、编辑记录、修改字段值的操作。对记录集做修改之后，都需要使用 update() 来提交修改。每对一条记录做完修改就需要调用一次 update() 来提交修改。
    
    返回:
    
    更新成功返回 true，否则返回 false。
    
    另请参阅:
    
    Recordset
    
    示例:
    
    请参见 Recordset 类的示例。
  - close
```
public void close()
```
    用于关闭记录集。使用记录集以后应及时关闭。
  - delete
```
public boolean delete()
```
    用于删除数据集中的当前记录，成功则返回 true。
    当记录为只读时，该方法不可用。
    
    返回:
    
    删除成功则返回 true，否则返回 false。
    
    另请参阅:
    
    Recordset
    
    示例:
    
    请参见 Recordset 类的示例。
  - deleteAll
```
public boolean deleteAll()
```
    物理性删除指定记录集中的所有记录，即把记录从计算机的物理存储介质上删除，无法恢复。
    当记录为只读时，该方法不可用。
    
    返回:
    
    删除成功则返回 true，否则返回 false。
  - getFieldValue
```
public java.lang.Object getFieldValue(int index)
```
    根据字段序号指定字段，返回数据集的属性数据表中当前记录相应字段的值。
    
    参数:
    
    index - 要取其值的字段的序号。
    
    返回:
    
    当前记录中某一字段的值。
    
    示例:
    
    请参见 QueryParameter 的示例。
  - getFieldValue
```
public java.lang.Object getFieldValue(java.lang.String name)
```
    根据字段名指定字段，返回数据集的属性数据表中当前记录该字段的值。
    
    参数:
    
    name - 要取其值的字段的名称。
    
    返回:
    
    当前记录中某一字段的值。
  - getGeometry
```
public Geometry getGeometry()
```
    用于返回数据集的属性数据表中当前记录对应的几何对象。
    
    返回:
    
    若成功返回几何对象，否则返回 null。
    
    另请参阅:
    
    Recordset
    
    示例:
    
    请参见 Recordset 类的示例。
  - getID
```
public int getID()
```
    用于返回数据集的属性表中当前记录对应的几何对象的 ID 号（即 SmID 字段的值）。
    
    返回:
    
    几何对象的 ID 号。
  - move
```
public boolean move(int count)
```
    将当前记录位置移动 count 行，将该位置的记录设置为当前记录。成功返回 true。count 小于0表示向前移，大于0表示向后移动，等于0时不移动。如果移动的行数太多，超出了 Recordset 的范围，将会返回 false，当前记录不移动。
    
    参数:
    
    count - 移动的记录数。
    
    返回:
    
    移动成功返回 true，否则返回 false。
  - moveFirst
```
public boolean moveFirst()
```
    用于移动当前记录位置到第一条记录，使第一条记录成为当前记录。成功则返回 true。
    
    返回:
    
    移动成功返回 true，否则返回 false。
    
    另请参阅:
    
    Recordset
    
    示例:
    
    请参见 Recordset 类的示例。
  - moveLast
```
public boolean moveLast()
```
    用于移动当前记录位置到最后一条记录，使最后一条记录成为当前记录。成功则返回 true。
    
    返回:
    
    移动成功返回 true，否则返回 false。
  - moveNext
```
public boolean moveNext()
```
    移动当前记录位置到下一条记录，使该记录成为当前记录。成功则返回 true。若当前记录已经为最后一条记录则返回 false。
    
    返回:
    
    移动成功返回 true，否则返回 false。
  - movePrev
```
public boolean movePrev()
```
    移动当前记录位置到上一条记录，使该记录成为当前记录。成功则返回 true。若当前记录已经为第一条记录则返回 false。
    
    返回:
    
    移动成功返回 true，否则返回 false。
  - moveTo
```
public boolean moveTo(int position)
```
    用于移动当前记录位置到指定的位置，将该指定位置的记录作为当前记录。成功则返回 true。
    
    参数:
    
    position - 移动到的位置，即第几条记录。位置从零开始，moveTo(0) 和 moveFirst()等效。
    
    返回:
    
    移动成功返回 true，否则返回 false。
  - seekID
```
public boolean seekID(int id)
```
    在记录中搜索指定 ID 号的记录，并定位该记录为当前记录。
    
    参数:
    
    id - 要搜索的 ID 号。
    
    返回:
    
    成功则返回 true，否则返回 false。
  - setFieldValue
```
public boolean setFieldValue(int index,
                             java.lang.Object value)
```
    根据要修改的字段的序号，设定记录集中相应字段的值。成功则返回 true。在对某一字段赋值的时候，需先调用 edit() 锁定要修改的记录，修改之后需调用 update() 进行提交。
    
    参数:
    
    index - 要修改的字段的序号。
    
    value - 新字段值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - setFieldValue
```
public boolean setFieldValue(java.lang.String name,
                             java.lang.Object value)
```
    根据要修改的字段的名称，设定记录集中相应字段的值。成功则返回 true。在对某一字段赋值的时候，需先调用 edit() 锁定要修改的记录，修改之后需调用 update() 进行提交。
    
    参数:
    
    name - 要修改的字段的名称。
    
    value - 新字段值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - setFieldValueNull
```
public boolean setFieldValueNull(int index)
```
    根据字段序号，设定记录集中相应字段的值为 null，成功则返回 true。
    
    参数:
    
    index - 要设定的字段的序号。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - setFieldValueNull
```
public boolean setFieldValueNull(java.lang.String name)
```
    根据字段名称，设定记录集中相应字段的值为 null，成功则返回 true。
    
    参数:
    
    name - 要设定的字段的名称。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - setGeometry
```
public boolean setGeometry(Geometry geometry)
```
    用于修改记录集当前位置的几何对象，覆盖原来的几何对象，成功则返回true。
    
    修改前先调用 edit()，修改记录的几何对象时，系统自动修改与对象有关的系统字段的值，如多边形对象的面积，线段对象的长度等。
    
    参数:
    
    geometry - 用来覆盖原几何对象的新几何对象。
    
    返回:
    
    设置成功返回 true，否则返回 false。
    
    抛出:
    
    java.lang.NullPointerException - 如果传入的参数为null，则抛出 NullPointerException。
    
    java.lang.IllegalArgumentException - 如果属性表数据集调用此接口，且传入参数不为 null 时，则抛出 IllegalArgumentException 。
  - getQueryParameter
```
public QueryParameter getQueryParameter()
```
    得到当前记录集对应的查询参数,返回一个副本。具体查询参数信息参见 QueryParameter 类型。
    
    返回:
    
    查询的记录集。
    
    另请参阅:
    
    QueryParameter
  - getByte
```
public byte getByte(int index)
```
    用于返回数据集的属性数据表中当前记录为“字节”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“字节”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 待返回其值的指定字段的索引。
    
    返回:
    
    数据集的属性数据表中当前记录为“字节”类型字段的值。
  - getByte
```
public byte getByte(java.lang.String name)
```
    用于返回数据集的属性数据表中当前记录为“字节”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“字节”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 待返回其值的指定字段的名称。
    
    返回:
    
    数据集的属性数据表中当前记录为字节类型字段的值。
  - setByte
```
public boolean setByte(int index,
                       byte value)
```
    用于设置记录集中当前记录某一字段的值，设置成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“字节”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 要设置其值的指定字段的索引。
    
    value - 要设置的字节值。
    
    返回:
    
    一个布尔值，设定成功返回true，否则返回 false。
  - setByte
```
public boolean setByte(java.lang.String name,
                       byte value)
```
    用于设置记录集中当前记录某一字段的值，设置成功则返回 true。
    设置已知字段类型的值，如果字段类型不是字节类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 要设置其值的指定字段的名称。
    
    value - 要设置的 byte 值。
    
    返回:
    
    一个布尔值，设定成功返回 true，否则返回 false。
  - getInt16
```
public short getInt16(int index)
```
    用于返回数据集的属性数据表中当前记录为“16位整型”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“16位整型”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 待返回其值的指定字段的索引。
    
    返回:
    
    数据集的属性数据表中当前记录为“16位整型”类型字段的值。
  - getInt16
```
public short getInt16(java.lang.String name)
```
    用于返回数据集的属性数据表中当前记录为“16位整型”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“16位整型”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 待返回其值的指定字段的名称。
    
    返回:
    
    数据集的属性数据表中当前记录“16位整型”类型字段的值。
  - setInt16
```
public boolean setInt16(int index,
                        short value)
```
    用于设置记录集中当前记录某一“16位整型”类型字段的值，设置成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“16位整型”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 要设置其值的指定字段的索引。
    
    value - 要设置的 short 值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - setInt16
```
public boolean setInt16(java.lang.String name,
                        short value)
```
    用于设置记录集中当前记录某一“16位整型”类型字段的值，设置成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“16位整型”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 要设置其值的指定字段的名称。
    
    value - 要设置的 short 值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - getInt32
```
public int getInt32(int index)
```
    用于返回数据集的属性数据表中当前记录为“32位整型”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“32位整型”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 待返回其值的指定字段的索引。
    
    返回:
    
    数据集的属性数据表中当前记录“32位整型”类型字段的值。
  - getInt32
```
public int getInt32(java.lang.String name)
```
    用于返回数据集的属性数据表中当前记录“32位整型”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“32位整型”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 待返回其值的指定字段的名称。
    
    返回:
    
    数据集的属性数据表中当前记录“32位整型”类型字段的值。
  - setInt32
```
public boolean setInt32(int index,
                        int value)
```
    用于设置记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“32位整型”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 待返回其值的指定字段的索引。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - setInt32
```
public boolean setInt32(java.lang.String name,
                        int value)
```
    用于设置记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“32位整型”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 待返回其值的指定字段的名称。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回true，否则返回False。
  - getInt64
```
public long getInt64(int index)
```
    用于返回数据集的属性数据表中当前记录为“64位整型”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“64位整型”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 待返回其值的指定字段的索引。
    
    返回:
    
    数据集的属性数据表中当前记录“64位整型”类型字段的值。
  - getInt64
```
public long getInt64(java.lang.String name)
```
    用于返回数据集的属性数据表中当前记录“64位整型”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“64位整型”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 待返回其值的指定字段的名称。
    
    返回:
    
    数据集的属性数据表中当前记录“64位整型”类型字段的值。
  - setInt64
```
public boolean setInt64(int index,
                        long value)
```
    用于设置记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“64位整型”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 待返回其值的指定字段的索引。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - setInt64
```
public boolean setInt64(java.lang.String name,
                        long value)
```
    用于设置记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“64位整型”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 待返回其值的指定字段的名称。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回true，否则返回False。
  - getSingle
```
public float getSingle(int index)
```
    用于返回数据集的属性数据表中当前记录为“单精度”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“单精度”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 要取其值的字段的索引。
    
    返回:
    
    数据集的属性数据表中当前记录“单精度”类型字段的值。
  - getSingle
```
public float getSingle(java.lang.String name)
```
    用于返回数据集的属性数据表中当前记录为“单精度”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“单精度”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 要取其值的字段的名称。
    
    返回:
    
    数据集的属性数据表中当前记录为“单精度”类型字段的值。
  - setSingle
```
public boolean setSingle(int index,
                         float value)
```
    用于设置记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“单精度”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 要取其值的字段的索引。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - setSingle
```
public boolean setSingle(java.lang.String name,
                         float value)
```
    用于设置记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“单精度”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 要取其值的字段的名称。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - getDouble
```
public double getDouble(int index)
```
    用于返回数据集的属性数据表中当前记录为“双精度”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“双精度”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 要取其值的字段的索引。
    
    返回:
    
    数据集的属性数据表中当前记录为“双精度”类型字段的值。
  - getDouble
```
public double getDouble(java.lang.String name)
```
    用于返回数据集的属性数据表中当前记录为“双精度”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“双精度”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 要取其值的字段的名称。
    
    返回:
    
    数据集的属性数据表中当前记录“双精度”类型字段的值。
  - setDouble
```
public boolean setDouble(int index,
                         double value)
```
    用于设置记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“双精度”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 要取其值的字段的索引。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - setDouble
```
public boolean setDouble(java.lang.String name,
                         double value)
```
    用于设置记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“双精度”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 要取其值的字段的名称。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - getLongBinary
```
public byte[] getLongBinary(int index)
```
    用于返回数据集的属性数据表中当前记录为“二进制”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“二进制”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 要取其值的字段的索引。
    
    返回:
    
    数据集的属性数据表中当前记录为“二进制”类型字段的值。
  - getLongBinary
```
public byte[] getLongBinary(java.lang.String name)
```
    用于返回数据集的属性数据表中当前记录为“二进制”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“二进制”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 要取其值的字段的名称。
    
    返回:
    
    数据集的属性数据表中当前记录为“二进制”类型字段的值。
  - setLongBinary
```
public boolean setLongBinary(int index,
                             byte[] value)
```
    用于设置记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“二进制”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 要取其值的字段的索引。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - setLongBinary
```
public boolean setLongBinary(java.lang.String name,
                             byte[] value)
```
    用于设置记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“二进制”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    该方法只对二进制类型的字段有效，若字段为其他类型，则返回 false。
    
    参数:
    
    name - 要取其值的字段的名称。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - getBoolean
```
public boolean getBoolean(int index)
```
    用于返回数据集的属性数据表中当前记录为“布尔”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“布尔”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 要取其值的字段的索引。
    
    返回:
    
    数据集的属性数据表中当前记录为“布尔”类型字段的值。
  - getBoolean
```
public boolean getBoolean(java.lang.String name)
```
    用于返回数据集的属性数据表中当前记录为“布尔”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“布尔”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 要取其值的字段的名称。
    
    返回:
    
    数据集的属性数据表中当前记录为“布尔”类型字段的值。
  - setBoolean
```
public boolean setBoolean(int index,
                          boolean value)
```
    用于设置记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“布尔”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 要取其值的字段的索引。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - setBoolean
```
public boolean setBoolean(java.lang.String name,
                          boolean value)
```
    用于设定记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“布尔”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 要取其值的字段的名称。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - getString
```
public java.lang.String getString(int index)
```
    用于返回数据集的属性数据表中当前记录为“文本”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“文本”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 要取其值的字段的索引。
    
    返回:
    
    数据集的属性数据表中当前记录为“文本”类型字段的值。
  - getString
```
public java.lang.String getString(java.lang.String name)
```
    用于返回数据集的属性数据表中当前记录为“文本”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“文本”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 要取其值的字段的名称。
    
    返回:
    
    数据集的属性数据表中当前记录为“文本”类型字段的值。
  - setString
```
public boolean setString(int index,
                         java.lang.String value)
```
    用于设置记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“文本”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 要取其值的字段的索引。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - setString
```
public boolean setString(java.lang.String name,
                         java.lang.String value)
```
    用于设定记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“文本”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 要取其值的字段的名称。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - getDateTime
```
public java.util.Date getDateTime(int index)
```
    用于返回数据集的属性数据表中当前记录为“日期”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“日期”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 要取其值的字段的索引。
    
    返回:
    
    数据集的属性数据表中当前记录为“日期”类型字段的值。
  - getDateTime
```
public java.util.Date getDateTime(java.lang.String name)
```
    用于获得数据集的属性数据表中当前记录为“日期”类型字段的值。
    返回已知字段类型的值，如果字段类型不是“日期”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 要取其值的字段的名称。
    
    返回:
    
    数据集的属性数据表中当前记录为“日期”类型字段的值。
  - setDateTime
```
public boolean setDateTime(int index,
                           java.util.Date value)
```
    用于设置记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是“日期”类型，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    index - 要取其值的字段的索引。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - setDateTime
```
public boolean setDateTime(java.lang.String name,
                           java.util.Date value)
```
    用于设置记录集中某一字段的值，成功则返回 true。
    设置已知字段类型的值，如果字段类型不是 DateTime，可能会产生数据变化、精度丢失甚至返回失败等问题。
    
    参数:
    
    name - 要取其值的字段的名称。
    
    value - 要设置的值。
    
    返回:
    
    设定成功返回 true，否则返回 false。
  - dispose
```
public void dispose()
```
    释放该对象所占用的资源。当调用该方法之后，此对象不再可用。
  - statistic
```
public double statistic(int fieldIndex,
                        StatisticMode mode)
```
    对指定字段进行诸如最大值、最小值、平均值，总和，标准差和方差等方式的统计。
    
    参数:
    
    fieldIndex - 字段的索引
    
    mode - 统计模式
    
    返回:
    
    统计值
  - statistic
```
public double statistic(java.lang.String fieldName,
                        StatisticMode mode)
```
    对指定字段进行诸如最大值、最小值、平均值，总和，标准差和方差等方式的统计。
    
    参数:
    
    fieldName - 字段名称
    
    mode - 统计模式
    
    返回:
    
    统计值
  - getBatch
```
public Recordset.BatchEditor getBatch()
```
    返回批量更新对象。
    EngineType 中的可写文件型引擎和数据库型引擎类型数据源均支持批量更新操作。
    
    返回:
    
    批量更新对象。
  - fromGeoJSON
```
public boolean fromGeoJSON(java.lang.String geoJSON)
```
    从GeoJSON中的字符串中获取几何对象，及其所以属性值，并将其更新到数据集
    支持的几何对象类型包括：点、线、面、多线
    
    参数:
    
    geoJSON - GeoJSON格式的字符串，其中可以包含一个几何对象，也可以是包含多个对象的集合
    
    返回:
    
    获取到所有几何对象，并更新成功，返回true；否则，返回false
  - toGeoJSON
```
public java.lang.String toGeoJSON(boolean hasAttributte,
                                  int count)
```
    从当前记录起，将数据集中的指定数目的记录转换成GeoJSON格式的字符串
    支持的几何对象类型包括：点、线、面、多线，该方法最多支持获取包含连续10条记录的GeoJSON串.hasAttributte为true时，返回Feature类型的字符串；hasAttributte为false时，返回只含几何对象的Geometry类型的字符串
    
    参数:
    
    hasAttributte - 是否包含属性值
    
    count - 需要获取的记录条数
    
    返回:
    
    返回获取到的GeoJSON格式字符串，若没有结果，返回null

类 Recordset

嵌套类概要

方法概要

从类继承的方法 java.lang.Object

方法详细资料

getBounds

getDataset

getFieldInfos

getFieldCount

isClosed

edit

isBOF

isEOF

isReadOnly

getRecordCount

addNew

addNew

cancelUpdate

update

close

delete

deleteAll

getFieldValue

getFieldValue

getGeometry

getID

move

moveFirst

moveLast

moveNext

movePrev

moveTo

seekID

setFieldValue

setFieldValue

setFieldValueNull

setFieldValueNull

setGeometry

getQueryParameter

getByte

getByte

setByte

setByte

getInt16

getInt16

setInt16

setInt16

getInt32

getInt32

setInt32

setInt32

getInt64

getInt64

setInt64

setInt64

getSingle

getSingle

setSingle

setSingle

getDouble

getDouble

setDouble

setDouble

getLongBinary

getLongBinary

setLongBinary

setLongBinary

getBoolean

getBoolean

setBoolean

setBoolean

getString

getString

setString

setString

getDateTime

getDateTime

setDateTime

setDateTime

dispose