com.supermap.data

类 Recordset

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


  • public class Recordset
    extends java.lang.Object

    记录集类。

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

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

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

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

    Example:
    以下代码示范如何删除一条记录以及添加记录。假设打开一个工作空间 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 类的内部类,主要提供记录的批量更新的功能。
    • 方法概要

      所有方法 实例方法 具体方法 
      限定符和类型 方法和说明
      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。
        返回:
        记录集是否已经关闭。
        Default:
        默认值为 false,即记录集尚未关闭。
      • edit

        public boolean edit()
        锁定并编辑记录集的当前记录,成功则返回 true。 用该方法编辑后,一定要用 update() 方法更新记录集,而且在 update() 之前不能移动当前记录的位置,否则编辑失败,记录集也可能被损坏。
        返回:
        编辑成功返回 true,否则返回 false。
      • isBOF

        public boolean isBOF()
        判断当前记录的位置是否在记录集中第一条记录的前面(当然第一条记录的前面是没有数据的),如果是返回 true;否则返回 false。
        返回:
        当前记录是否在第一条记录的前面。
        另请参阅:
        Recordset
        Example:
        请参见 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
        Example:
        请参见 Recordset 类的示例。
      • addNew

        public boolean addNew(Geometry geometry,
                              java.util.Map<java.lang.String,java.lang.Object> values)
        添加几何对象及设置相关的字段值。

        在使用该方法之后,需要调用 update方法来提交修改,保存结果。

        参数:
        geometry - 需要添加的几何对象
        values - 需要设置的属性值,键为字段名称,值为对应字段的值。注:如果所自定的字段名称在记录集中不存在,或对应的值与字段类型不一致,对应的值就忽略。
        返回:
        一个布尔值,添加成功返回 true,否则返回 false。
        Example:
        请参见 Recordset.BatchEditor 类的示例。
      • cancelUpdate

        public boolean cancelUpdate()
        用于取消在调用 update方法前对当前记录或新记录所做的任何更改。成功则返回 true。
        返回:
        成功则返回 true,否则返回 false。
      • update

        public boolean update()
        用于提交对记录集的修改,包括添加、编辑记录、修改字段值的操作。对记录集做修改之后,都需要使用 update() 来提交修改。每对一条记录做完修改就需要调用一次 update() 来提交修改。
        返回:
        更新成功返回 true,否则返回 false。
        另请参阅:
        Recordset
        Example:
        请参见 Recordset 类的示例。
      • close

        public void close()
        用于关闭记录集。使用记录集以后应及时关闭。
      • delete

        public boolean delete()
        用于删除数据集中的当前记录,成功则返回 true。

        当记录为只读时,该方法不可用。

        返回:
        删除成功则返回 true,否则返回 false。
        另请参阅:
        Recordset
        Example:
        请参见 Recordset 类的示例。
      • deleteAll

        public boolean deleteAll()
        物理性删除指定记录集中的所有记录,即把记录从计算机的物理存储介质上删除,无法恢复。

        当记录为只读时,该方法不可用。

        返回:
        删除成功则返回 true,否则返回 false。
      • getFieldValue

        public java.lang.Object getFieldValue(int index)
        根据字段序号指定字段,返回数据集的属性数据表中当前记录相应字段的值。
        参数:
        index - 要取其值的字段的序号。
        返回:
        当前记录中某一字段的值。
        Example:
        请参见 QueryParameter 的示例。
      • getFieldValue

        public java.lang.Object getFieldValue(java.lang.String name)
        根据字段名指定字段,返回数据集的属性数据表中当前记录该字段的值。
        参数:
        name - 要取其值的字段的名称。
        返回:
        当前记录中某一字段的值。
      • getGeometry

        public Geometry getGeometry()
        用于返回数据集的属性数据表中当前记录对应的几何对象。
        返回:
        若成功返回几何对象,否则返回 null。
        另请参阅:
        Recordset
        Example:
        请参见 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
        Example:
        请参见 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