com.supermap.data

类 Datasets

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


  • public class Datasets
    extends java.lang.Object

    数据集集合类。

    提供对数据集的管理功能,如创建、删除、重命名等操作。一个数据源中所有的数据集对象都由一个数据集集合对象来管理。

    数据集集合可以包含一种或多种类型的数据集,可以是矢量数据集,栅格数据集或影像数据集。 目前版本支持的数据集类型有:纯属性数据集(tabular dataset),点数据集(point dataset),线数据集(line dataset),面数据集(region dataset),文本数据集(text dataset)和影像数据集(image dataset)。

    数据集对象所属的数据源的 isReadOnly() 返回值为 true 时,则不允许创建和删除数据集。

    • 方法概要

      所有方法 实例方法 具体方法 
      限定符和类型 方法和说明
      boolean contains(java.lang.String name)
      检查当前数据源中是否包含指定名称的数据集。
      DatasetVector create(DatasetVectorInfo datasetInfo)
      根据指定的矢量数据集信息来创建矢量数据集。
      Dataset createDatasetFromTemplate(java.lang.String name, Dataset desdataset)
      根据模板数据集创建数据集
      boolean delete(int index)
      用于删除指定序号的数据集。
      boolean delete(java.lang.String name)
      用于删除指定名称的数据集。
      Dataset get(int index)
      返回指定序号的数据集。
      Dataset get(java.lang.String name)
      返回指定名称的数据集。
      java.lang.String getAvailableDatasetName(java.lang.String name)
      返回一个数据源中未被使用的数据集的名称。
      int getCount()
      返回数据集集合中数据集的个数。
      int indexOf(java.lang.String name)
      返回给定数据集名称对应的数据集在数据集集合中所处的索引值。
      boolean isAvailableDatasetName(java.lang.String name)
      判断用户传进来的数据集的名称是否合法。
      • 从类继承的方法 java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • 方法详细资料

      • getCount

        public int getCount()
        返回数据集集合中数据集的个数。
        返回:
        数据集集合中数据集的个数。
      • delete

        public boolean delete(java.lang.String name)
        用于删除指定名称的数据集。

        该方法是线程安全的,线程安全级别为 level2。有关线程安全的详细说明请参考《多线程技术文档》。

        参数:
        name - 指定的数据集的名称。
        返回:
        如果删除成功,返回值为 true,否则为 false。
      • isAvailableDatasetName

        public boolean isAvailableDatasetName(java.lang.String name)
        判断用户传进来的数据集的名称是否合法。创建数据集时应检查其名称的合法性。

        数据集的名称限制:数据集名称的长度限制为30个字符(也就是可以为30个英文字母或者15个汉字),组成数据集名称的字符可以为字母、汉字、数字和下划线 ,数据集名称不可以用数字和下划线开头,数据集名称不可以和数据库的保留关键字冲突。

        参数:
        name - 待检查的数据集名称。
        返回:
        如果数据集名称合法,返回 true;否则,返回 false。
      • contains

        public boolean contains(java.lang.String name)
        检查当前数据源中是否包含指定名称的数据集。
        参数:
        name - 数据集名称。
        返回:
        如果该数据源中包含指定名称的数据集,返回值为 true,如果不包含,返回值为 false。
      • getAvailableDatasetName

        public java.lang.String getAvailableDatasetName(java.lang.String name)
        返回一个数据源中未被使用的数据集的名称。创建数据集时,数据集名称在同一个数据源文件中必须唯一,否则不能创建新的数据集, 可以使用该方法返回一个合法的名称,但是该方法得到的名称不能保证一定符合您的最佳要求。

        数据集的名称限制:数据集名称的长度限制为30个字符(也就是可以为30个英文字母或者15个汉字),组成数据集名称的字符可以为字母、汉字、数字和下划线 ,数据集名称不可以用数字和下划线开头,数据集名称不可以和数据库的保留关键字冲突。

        参数:
        name - 数据集名称。
        返回:
        一个字符串,该字符串可以用作数据集名称。
      • delete

        public boolean delete(int index)
        用于删除指定序号的数据集。

        该方法是线程安全的,线程安全级别为 level2。有关线程安全的详细说明请参考《多线程技术文档》。

        参数:
        index - 指定的数据集的序号。
        返回:
        如果删除成功,返回值为 true,否则为 true。
      • get

        public Dataset get(java.lang.String name)
        返回指定名称的数据集。
        参数:
        name - 指定的数据集的名称。
        返回:
        指定名称的数据集。
      • get

        public Dataset get(int index)
        返回指定序号的数据集。
        参数:
        index - 指定数据集的序号。
        返回:
        指定序号的数据集。
      • create

        public DatasetVector create(DatasetVectorInfo datasetInfo)
        根据指定的矢量数据集信息来创建矢量数据集。

        该方法是线程安全的,线程安全级别为 level2。有关线程安全的详细说明请参考《多线程技术文档》。

        参数:
        datasetInfo - 矢量数据集信息。
        返回:
        新创建的矢量数据集对象。
      • createDatasetFromTemplate

        public Dataset createDatasetFromTemplate(java.lang.String name,
                                                 Dataset desdataset)
        根据模板数据集创建数据集
        参数:
        name - 新建数据集名称
        desdataset - 模板数据集
        返回:
        数据集
      • indexOf

        public int indexOf(java.lang.String name)
        返回给定数据集名称对应的数据集在数据集集合中所处的索引值。
        参数:
        name - 数据集名称
        返回:
        表示与给定数据集名称相同的数据集所处的位置。