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 - 数据集名称
    
    返回:
    
    表示与给定数据集名称相同的数据集所处的位置。

类 Datasets

方法概要

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

方法详细资料

getCount

delete

isAvailableDatasetName

contains

getAvailableDatasetName

delete

get

get

create

createDatasetFromTemplate

indexOf