com.supermap.data
类 DatasetVectorInfo

java.lang.Object
  com.supermap.data.DatasetVectorInfo

public class DatasetVectorInfo
extends java.lang.Object

矢量数据集信息类。

包括了矢量数据集的信息，如矢量数据集的名称，数据集的类型，编码方式，是否选用文件缓存等。文件缓存只针对图幅索引而言。

示例:

以下代码示范如何根据给定的矢量数据集信息，创建矢量数据集。

 public void datasetVectorInfoTest() {
        // 假设打开一个工作空间 workspace 对象，工作空间中存在一个数据源 datasource 对象
        // 以下代码示范通过矢量数据集信息创建矢量数据集
        Datasets datasets = datasource.getDatasets();
        String name = datasets.getAvailableDatasetName("河流");

        // 设置矢量数据集的信息
        DatasetVectorInfo datasetVectorInfo = new DatasetVectorInfo();
        datasetVectorInfo.setType(DatasetType.LINE);
        datasetVectorInfo.setEncodeType(EncodeType.NONE);
        datasetVectorInfo.setFileCache(true);
        datasetVectorInfo.setName(name);
        System.out.println("矢量数据集的信息为：" + datasetVectorInfo.toString());

        // 创建矢量数据集
        DatasetVector datasetVector = datasets.create(datasetVectorInfo);
        if (datasetVector != null) {
            System.out.println(datasetVector.getName() + "创建成功！");
        }

        // 释放资源
        datasetVectorInfo.dispose();
        datasetVector.close();
    }
 

构造方法摘要

DatasetVectorInfo()
构造一个新的 DatasetVectorInfo 对象。

DatasetVectorInfo(DatasetVectorInfo datasetVectorInfo)
根据给定的 DatasetVectorInfo 对象构造一个与其完全相同的新对象。

DatasetVectorInfo(java.lang.String name, DatasetType type)
根据指定的参数来构造一个 DatasetVectorInfo 的新对象。

DatasetVectorInfo(java.lang.String name, DatasetVector templateDataset)
根据指定的参数来构造一个 DatasetVectorInfo 的新对象。

方法摘要

void	dispose() 释放该对象所占用的资源。
java.lang.String	getBlobTablespaceName() 返回SmGeometry所属表空间的名称。
DatasetIDType	getDatasetIDType() 返回数据集 ID 标识符类型。
EncodeType	getEncodeType() 返回数据集的压缩编码方式。
java.lang.String	getName() 返回矢量数据集的名称。
DatasetType	getType() 返回矢量数据集类型。
boolean	isFileCache() 返回是否使用文件形式的缓存。
void	setBlobTablespaceName(java.lang.String strTablespaceName) 设置SmGeometry所属表空间。
void	setDatasetIDType(DatasetIDType type) 设置数据集 ID 标识符类型。
void	setEncodeType(EncodeType value) 设置数据集的压缩编码方式。
void	setFileCache(boolean value) 设置是否使用文件形式的缓存。
void	setName(java.lang.String value) 设置矢量数据集的名称。
void	setType(DatasetType value) 设置矢量数据集类型。
java.lang.String	toString() 输出矢量数据集的信息。

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

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

DatasetVectorInfo

public DatasetVectorInfo()

构造一个新的 DatasetVectorInfo 对象。

DatasetVectorInfo

public DatasetVectorInfo(java.lang.String name,
                         DatasetType type)

根据指定的参数来构造一个 DatasetVectorInfo 的新对象。

参数：

name - 数据集的名称。

type - 数据集的类型。

DatasetVectorInfo

public DatasetVectorInfo(DatasetVectorInfo datasetVectorInfo)

根据给定的 DatasetVectorInfo 对象构造一个与其完全相同的新对象。

参数：

datasetVectorInfo - 指定的 DatasetVectorInfo 对象。

DatasetVectorInfo

public DatasetVectorInfo(java.lang.String name,
                         DatasetVector templateDataset)

根据指定的参数来构造一个 DatasetVectorInfo 的新对象。

参数：

name - 指定的名称。

templateDataset - 指定的模板数据集。

方法详细信息

getName

public java.lang.String getName()

返回矢量数据集的名称。

数据集的名称限制：数据集名称的长度限制为30个字符（也就是可以为30个英文字母或者15个汉字），组成数据集名称的字符可以为字母、汉字、数字和下划线，数据集名称不可以用数字和下划线开头，如果用字母开头，数据集名称不可以和数据库的保留关键字冲突，数据库保留关键字见保留关键字表。

返回：

矢量数据集的名称。

默认值:

默认值为 "UntitledDatasetVector"。

setName

public void setName(java.lang.String value)

设置矢量数据集的名称。

数据集的名称限制：数据集名称的长度限制为30个字符（也就是可以为30个英文字母或者15个汉字），组成数据集名称的字符可以为字母、汉字、数字和下划线，数据集名称不可以用数字和下划线开头，如果用字母开头，数据集名称不可以和数据库的保留关键字冲突，数据库保留关键字见保留关键字表。

参数：

value - 矢量数据集的名称。

getType

public DatasetType getType()

返回矢量数据集类型。在 SuperMap 中有十八种类型的数据集，但目前版本支持的矢量数据集主要有点数据集，线数据集，面数据集，文本数据集，复合数据集。数据集类型详细信息参见 DatasetType 类。

返回：

矢量数据集类型。

另请参见：

DatasetType

默认值:

默认值为 POINT 类型。

setType

public void setType(DatasetType value)

设置矢量数据集类型。在 SuperMap 中有十八种类型的数据集，但目前版本支持的矢量数据集主要有点数据集，线数据集，面数据集，文本数据集，复合数据集。数据集类型详细信息参见 DatasetType 类型。

参数：

value - 矢量数据集类型。

另请参见：

DatasetType

getDatasetIDType

public DatasetIDType getDatasetIDType()

返回数据集 ID 标识符类型。

返回：

成功返回标识符类型，失败返回空值。

setDatasetIDType

public void setDatasetIDType(DatasetIDType type)

设置数据集 ID 标识符类型。

getEncodeType

public EncodeType getEncodeType()

返回数据集的压缩编码方式。对矢量数据集，支持四种压缩编码方式，即单字节，双字节，三字节和四字节编码方式；对栅格数据集，可以采用三种压缩编码方式，即DCT，SGL和LZW。压缩编码方式详见 EncodeType 类型。

注意：

1. 对于某些编码方式，系统有可能会将其改变为更适合该数据集存储时的编码方式；
2. 目前只有二维线数据集（DatasetType.LINE）和二维面数据集（DatasetType.REGION）支持使用编码的方式，其它数据集不支持，即只支持 EncodeType.NONE。

返回：

数据集的压缩编码方式。

另请参见：

EncodeType

默认值:

默认值为 NONE 类型。

setEncodeType

public void setEncodeType(EncodeType value)

设置数据集的压缩编码方式。对矢量数据集，支持四种压缩编码方式，即单字节，双字节，三字节和四字节编码方式；对栅格数据集，可以采用三种压缩编码方式，即 DCT，SGL和LZW。压缩编码方式详见 EncodeType 类型。

注意：

1. 对于某些编码方式，系统有可能会将其改变为更适合该数据集存储时的编码方式；
2. 目前只有二维线数据集（DatasetType.LINE）和二维面数据集（DatasetType.REGION）支持使用编码的方式，其它数据集不支持，即只支持 EncodeType.NONE。

参数：

value - 数据集的压缩编码方式。

另请参见：

EncodeType

isFileCache

public boolean isFileCache()

返回是否使用文件形式的缓存。文件形式的缓存只针对图幅索引有用。

返回：

是否使用文件形式的缓存，如果使用文件形式的缓存为 true，否则为 false，

默认值:

默认值为 false。

setFileCache

public void setFileCache(boolean value)

设置是否使用文件形式的缓存。文件形式的缓存只针对图幅索引有用。

参数：

value - 是否使用文件形式的缓存。

setBlobTablespaceName

public void setBlobTablespaceName(java.lang.String strTablespaceName)

设置SmGeometry所属表空间。

参数：

strTablespaceName - 表空间名称。

getBlobTablespaceName

public java.lang.String getBlobTablespaceName()

返回SmGeometry所属表空间的名称。

返回：

表空间名称。

toString

public java.lang.String toString()

输出矢量数据集的信息。包括矢量数据集的名称，类型，编码方式和是否使用文件形式的缓存。输出的格式为 {Name=””,Type=,EncodeType=,IsMemoryCache=,IsFileCache=}。

覆盖：

类 java.lang.Object 中的 toString

返回：

输出矢量数据集的信息。

dispose

public void dispose()

释放该对象所占用的资源。当调用该方法之后，此对象不再可用。