com.supermap.services.components.spi

接口 DataProvider

所有已知实现类:

AggregationDataProvider, ArcGISRestDataProvider, GeoPackageDataProvider, RestDataProvider, UGCDataProvider, WFSDataProvider

public interface DataProvider

数据服务提供者。

数据服务提供者是一类 GIS 服务提供者，获取并封装了与数据相关的 GIS 功能。

方法概要

方法

限定符和类型	方法和说明
EditResult	addFeatures(java.lang.String datasourceName, java.lang.String datasetName, java.util.List<Feature> targetFeatures) 在指定数据集中增加一组同类型的要素。
boolean	clearFeatures(java.lang.String datasourceName, java.lang.String datasetName) 清空指定数据集的要素。
boolean	containsDataset(java.lang.String datasourceName, java.lang.String datasetName) 判断指定数据源是否包含指定的数据集。
boolean	copyDataset(java.lang.String srcDatasourceName, java.lang.String srcDatasetName, java.lang.String destDatasourceName, java.lang.String destDatasetName) 复制数据集。
boolean	createDataset(java.lang.String datasourceName, DatasetInfo datasetInfo) 在指定的数据源中，根据数据集信息创建一个新的数据集。
boolean	deleteDataset(java.lang.String datasourceName, java.lang.String datasetName) 删除指定数据源中的指定数据集。
EditResult	deleteFeatures(java.lang.String datasourceName, QueryParameter parameters) 指定数据源中通过sql删除要素。
EditResult	deleteFeatures(java.lang.String datasourceName, java.lang.String datasetName, int[] ids) 在指定的数据集中删除一组要素。
DatasetGroupInfo	getDatasetGroupInfo(java.lang.String datasourceName, java.lang.String datasetGroupName)
java.util.List<java.lang.String>	getDatasetGroupNames(java.lang.String datasourceName) 获取指定数据源的所有数据集组的名称
DatasetInfo	getDatasetInfo(java.lang.String datasourceName, java.lang.String datasetName) 获取指定数据源的指定数据集信息。
java.util.List<DatasetInfo>	getDatasetInfos(java.lang.String datasourceName) 获取指定数据源的所有数据集的信息。
java.util.List<java.lang.String>	getDatasetNames(java.lang.String datasourceName) 获取当前数据源的所有数据集名称。
DatasourceInfo	getDatasourceInfo(java.lang.String datasourceName) 获取指定数据源的信息。
java.util.List<DatasourceInfo>	getDatasourceInfos() 获取当前数据服务提供者对应的所有数据源信息。
java.util.List<DomainInfo>	getDomainInfos(java.lang.String datasourceName, java.lang.String datasetName) 获取指定数据集的所有值域信息
GetFeatureResult	getFeature(GetFeatureParameters parameters) 查询并返回要素结果。
java.util.List<Feature>	getFeature(java.lang.String datasourceName, QueryParameter queryParam) 通过 SQL 查询条件获取要素。
java.util.List<Feature>	getFeature(java.lang.String datasourceName, QueryParameter queryParam, int maxFeatures) 通过 SQL 查询条件获取要素。
java.util.List<Feature>	getFeature(java.lang.String datasourceName, QueryParameter queryParam, int maxFeatures, int fromIndex, int toIndex) 通过 SQL 查询条件获取要素。
java.util.List<Feature>	getFeature(java.lang.String datasourceName, java.lang.String datasetName, Geometry geometry, double distance, java.lang.String attributeFilter, java.lang.String[] fields) 获取落在指定空间对象的缓冲区内，并满足一定属性过滤条件的要素。
java.util.List<Feature>	getFeature(java.lang.String datasourceName, java.lang.String datasetName, Geometry geometry, SpatialQueryMode spatialQueryMode, java.lang.String attributeFilter, java.lang.String[] fields) 获取与指定几何对象具有特定空间查询模式，并满足指定属性过滤条件的要素。
java.util.List<Feature>	getFeature(java.lang.String datasourceName, java.lang.String datasetName, Geometry geometry, SpatialQueryMode spatialQueryMode, java.lang.String attributeFilter, java.lang.String[] fields, int fromIndex, int toIndex) 获取与指定几何对象具有特定空间查询模式，并满足指定属性过滤条件的要素。
java.util.List<Feature>	getFeature(java.lang.String datasourceName, java.lang.String datasetName, int[] ids, java.lang.String[] fields) 根据指定要素 ID 获取指定数据集中的要素。
java.util.List<Feature>	getFeature(java.lang.String datasourceName, java.lang.String datasetName, int[] ids, java.lang.String[] fields, int fromIndex, int toIndex) 以支持分页的方式，根据指定要素 ID获取指定数据集中的要素。
java.util.List<Feature>	getFeature(java.lang.String datasourceName, java.lang.String datasetName, Rectangle2D bounds, java.lang.String attributeFilter, java.lang.String[] fields) 获取在指定空间范围内，并满足一定属性过滤条件的要素。
java.util.List<FieldInfo>	getFieldInfos(java.lang.String datasourceName, java.lang.String datasetName) 获取指定数据集的所有字段信息。
EditResult	modelingByRules(java.lang.String datasourceName, java.lang.String datasetName, java.util.List<ModelingByRulesPostParameter> ruleParams) 根据各项参数规则建模
boolean	renameDataset(java.lang.String datasourceName, java.lang.String oldName, java.lang.String newName) 修改指定数据集的名称。
double	statistic(java.lang.String datasourceName, java.lang.String datasetName, int fieldIndex, StatisticMode statisticMode) 在指定的数据集中，根据指定的统计方法对指定字段进行统计计算。
double	statistic(java.lang.String datasourceName, java.lang.String datasetName, java.lang.String fieldName, StatisticMode statisticMode) 在指定的数据集中，根据指定的统计方法对指定字段进行统计计算。
void	updateDatasetInfo(java.lang.String datasourceName, java.lang.String datasetName, DatasetInfo newDatasetInfo) 在指定的数据源中，更新指定数据集的信息。
void	updateDatasourceInfo(java.lang.String datasourceName, DatasourceInfo newDatasourceInfo) 用新的数据源信息更新原来的数据源信息。
EditResult	updateFeatures(java.lang.String datasourceName, java.lang.String datasetName, java.util.List<Feature> targetFeatures) 在指定的数据集中，更新一组要素。
void	updateFieldInfos(java.lang.String datasourceName, java.lang.String datasetName, java.util.List<FieldInfo> newFieldInfos) 更新指定数据集的字段信息。
boolean	updateModelTextures(java.lang.String datasourceName, java.lang.String datasetName, java.lang.String modelID, java.util.List<java.lang.String> textureNames, java.util.List<byte[]> modelTextures) 更新指定模型纹理

方法详细资料

createDataset

boolean createDataset(java.lang.String datasourceName,
                    DatasetInfo datasetInfo)

在指定的数据源中，根据数据集信息创建一个新的数据集。

参数:

datasourceName - 数据源名称。

datasetInfo - 数据集信息。

返回:

数据集创建成功返回 true，否则返回 false。

deleteDataset

boolean deleteDataset(java.lang.String datasourceName,
                    java.lang.String datasetName)

删除指定数据源中的指定数据集。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

返回:

数据集删除成功返回 true， 否则返回 false。

containsDataset

boolean containsDataset(java.lang.String datasourceName,
                      java.lang.String datasetName)

判断指定数据源是否包含指定的数据集。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

返回:

如果包含指定的数据集，则返回 true， 否则返回 false。

renameDataset

boolean renameDataset(java.lang.String datasourceName,
                    java.lang.String oldName,
                    java.lang.String newName)

修改指定数据集的名称。

参数:

datasourceName - 数据源名称。

oldName - 旧数据集名称。

newName - 新数据集名称。

返回:

数据集名称修改成功返回 true， 否则返回 false。

copyDataset

boolean copyDataset(java.lang.String srcDatasourceName,
                  java.lang.String srcDatasetName,
                  java.lang.String destDatasourceName,
                  java.lang.String destDatasetName)

复制数据集。

从指定的源数据源中，复制指定的源数据集到指定的目标数据源中的目标数据集。

参数:

srcDatasourceName - 源数据源的名称。

srcDatasetName - 源数据集的名称。

destDatasourceName - 目标数据源名。

destDatasetName - 目标数据集的名称。

返回:

数据集复制成功返回 true， 否则返回 false。

addFeatures

EditResult addFeatures(java.lang.String datasourceName,
                     java.lang.String datasetName,
                     java.util.List<Feature> targetFeatures)

在指定数据集中增加一组同类型的要素。

SuperMap 的每一个数据集都具有类型（DatasetType），可以是点数据集、线数据集、面数据集等等， 每一个数据集中的要素具有对应的类型，比如点数据集中存储的一定是点要素。因此，在向一个数据集中添加要素的时候， 添加的要素必须是同一种类型。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

targetFeatures - 待添加的要素列表，列表中的要素必须是同一种类型。

返回:

编辑结果。

deleteFeatures

EditResult deleteFeatures(java.lang.String datasourceName,
                        java.lang.String datasetName,
                        int[] ids)

在指定的数据集中删除一组要素。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

ids - 待删除要素的 ID 数组。

返回:

编辑结果。

deleteFeatures

EditResult deleteFeatures(java.lang.String datasourceName,
                        QueryParameter parameters)

指定数据源中通过sql删除要素。

参数:

datasourceName - 数据源名称。

parameters - 查询参数。

返回:

编辑结果。

getFeature

java.util.List<Feature> getFeature(java.lang.String datasourceName,
                                 java.lang.String datasetName,
                                 Rectangle2D bounds,
                                 java.lang.String attributeFilter,
                                 java.lang.String[] fields)

获取在指定空间范围内，并满足一定属性过滤条件的要素。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

bounds - 指定的查询范围。

attributeFilter - 属性查询过滤条件。如 fieldValue < 100，name like '%酒店%'

fields - 待返回的字段数组。当该参数为 null 时，返回全部字段。

返回:

要素列表。

updateFeatures

EditResult updateFeatures(java.lang.String datasourceName,
                        java.lang.String datasetName,
                        java.util.List<Feature> targetFeatures)

在指定的数据集中，更新一组要素。

参数 targetFeatures 是新要素列表，其要素 ID 与数据集中待更新的要素 ID 相同，根据 ID 查找到待更新的要素， 然后将原要素更新到新的要素。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

targetFeatures - 新要素列表。其 ID 与要更新的要素 ID 相同。

返回:

编辑结果。

clearFeatures

boolean clearFeatures(java.lang.String datasourceName,
                    java.lang.String datasetName)

清空指定数据集的要素。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

返回:

要素清除成功返回 true，否则返回 false。

getFeature

java.util.List<Feature> getFeature(java.lang.String datasourceName,
                                 java.lang.String datasetName,
                                 int[] ids,
                                 java.lang.String[] fields)

根据指定要素 ID 获取指定数据集中的要素。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

ids - 要素 ID。

fields - 待返回的字段数组。当该参数为 null 时，返回全部字段。

返回:

要素列表。

getFeature

java.util.List<Feature> getFeature(java.lang.String datasourceName,
                                 java.lang.String datasetName,
                                 int[] ids,
                                 java.lang.String[] fields,
                                 int fromIndex,
                                 int toIndex)

以支持分页的方式，根据指定要素 ID获取指定数据集中的要素。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

ids - 要素 ID。

fields - 待返回的字段数组。当该参数为 null 时，返回全部字段。

fromIndex - 分页结果的最小索引号

toIndex - 分页结果的最大索引号

返回:

要素列表。

从以下版本开始:

8.1.1

getFeature

java.util.List<Feature> getFeature(java.lang.String datasourceName,
                                 java.lang.String datasetName,
                                 Geometry geometry,
                                 double distance,
                                 java.lang.String attributeFilter,
                                 java.lang.String[] fields)

获取落在指定空间对象的缓冲区内，并满足一定属性过滤条件的要素。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

geometry - 几何对象。

distance - 缓冲区的半径。

attributeFilter - 属性查询过滤条件。如 fieldValue < 100，name like '%酒店%'

fields - 待返回的字段数组。当该参数为 null 时，返回全部字段。

返回:

要素列表。

getFeature

java.util.List<Feature> getFeature(java.lang.String datasourceName,
                                 java.lang.String datasetName,
                                 Geometry geometry,
                                 SpatialQueryMode spatialQueryMode,
                                 java.lang.String attributeFilter,
                                 java.lang.String[] fields)

获取与指定几何对象具有特定空间查询模式，并满足指定属性过滤条件的要素。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

geometry - 几何对象。

spatialQueryMode - 空间查询模式。

attributeFilter - 属性查询过滤条件。如 fieldValue < 100，name like '%酒店%'

fields - 待返回的字段数组。当该参数为 null 时，返回全部字段。

返回:

要素列表。

getFeature

java.util.List<Feature> getFeature(java.lang.String datasourceName,
                                 java.lang.String datasetName,
                                 Geometry geometry,
                                 SpatialQueryMode spatialQueryMode,
                                 java.lang.String attributeFilter,
                                 java.lang.String[] fields,
                                 int fromIndex,
                                 int toIndex)

获取与指定几何对象具有特定空间查询模式，并满足指定属性过滤条件的要素。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

geometry - 几何对象。

spatialQueryMode - 空间查询模式。

attributeFilter - 属性查询过滤条件。如 fieldValue < 100，name like '%酒店%'

fields - 待返回的字段数组。当该参数为 null 时，返回全部字段。

fromIndex - 分页结果的最小索引号

toIndex - 分页结果的最大索引号

返回:

要素列表。

getFeature

java.util.List<Feature> getFeature(java.lang.String datasourceName,
                                 QueryParameter queryParam)

通过 SQL 查询条件获取要素。

参数:

datasourceName - 数据源名称。

queryParam - 查询参数。

返回:

要素列表。

getFeature

java.util.List<Feature> getFeature(java.lang.String datasourceName,
                                 QueryParameter queryParam,
                                 int maxFeatures)

通过 SQL 查询条件获取要素。

参数:

datasourceName - 数据源名称。

queryParam - 查询参数。

maxFeatures - 最多可返回的要素数量。

返回:

要素列表。

getFeature

java.util.List<Feature> getFeature(java.lang.String datasourceName,
                                 QueryParameter queryParam,
                                 int maxFeatures,
                                 int fromIndex,
                                 int toIndex)

通过 SQL 查询条件获取要素。

参数:

datasourceName - 数据源名称。

queryParam - 查询参数。

maxFeatures - 最多可返回的要素数量。

fromIndex - 分页结果的最小索引号

toIndex - 分页结果的最大索引号

返回:

要素列表。

getFeature

GetFeatureResult getFeature(GetFeatureParameters parameters)

查询并返回要素结果。

参数:

parameters - 是对其它getFeature参数的封装。

返回:

getDatasourceInfos

java.util.List<DatasourceInfo> getDatasourceInfos()

获取当前数据服务提供者对应的所有数据源信息。

返回:

数据源信息列表。

getDatasourceInfo

DatasourceInfo getDatasourceInfo(java.lang.String datasourceName)

获取指定数据源的信息。

参数:

datasourceName - 数据源名称。

返回:

数据源信息。

updateDatasourceInfo

void updateDatasourceInfo(java.lang.String datasourceName,
                        DatasourceInfo newDatasourceInfo)

用新的数据源信息更新原来的数据源信息。

参数:

datasourceName - 数据源名称。

newDatasourceInfo - 新的数据源信息。

getDatasetInfos

java.util.List<DatasetInfo> getDatasetInfos(java.lang.String datasourceName)

获取指定数据源的所有数据集的信息。

参数:

datasourceName - 数据源名称。

返回:

数据集信息的列表。

getDatasetNames

java.util.List<java.lang.String> getDatasetNames(java.lang.String datasourceName)

获取当前数据源的所有数据集名称。

参数:

datasourceName数据源名称。 -

返回:

数据集名称的列表。

getDatasetInfo

DatasetInfo getDatasetInfo(java.lang.String datasourceName,
                         java.lang.String datasetName)

获取指定数据源的指定数据集信息。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

返回:

数据集信息。

updateDatasetInfo

void updateDatasetInfo(java.lang.String datasourceName,
                     java.lang.String datasetName,
                     DatasetInfo newDatasetInfo)

在指定的数据源中，更新指定数据集的信息。

参数:

datasourceName - 数据源名称。

datasetName - 待更新的数据集的名字。

newDatasetInfo - 新的数据集信息。

getDomainInfos

java.util.List<DomainInfo> getDomainInfos(java.lang.String datasourceName,
                                        java.lang.String datasetName)

获取指定数据集的所有值域信息

参数:

datasourceName - 数据源名称

datasetName - 数据集名称

返回:

值域信息列表

getFieldInfos

java.util.List<FieldInfo> getFieldInfos(java.lang.String datasourceName,
                                      java.lang.String datasetName)

获取指定数据集的所有字段信息。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

返回:

字段信息列表。

updateFieldInfos

void updateFieldInfos(java.lang.String datasourceName,
                    java.lang.String datasetName,
                    java.util.List<FieldInfo> newFieldInfos)

更新指定数据集的字段信息。

使用该方法来实现对字段的添加、删除、修改操作，即将整个数据集中的字段（除 SuperMap 系统字段）用新的字段替换掉。

如果使用的 SuperMap 数据，目前不支持更新 SuperMap 系统字段的别名。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

newFieldInfos - 新的字段信息。如果使用的 SuperMap 数据，新的字段信息列表不能包含 SuperMap 的系统字段。

statistic

double statistic(java.lang.String datasourceName,
               java.lang.String datasetName,
               int fieldIndex,
               StatisticMode statisticMode)

在指定的数据集中，根据指定的统计方法对指定字段进行统计计算。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

fieldIndex - 字段序号。

statisticMode - 统计方法。

返回:

统计结果。

statistic

double statistic(java.lang.String datasourceName,
               java.lang.String datasetName,
               java.lang.String fieldName,
               StatisticMode statisticMode)

在指定的数据集中，根据指定的统计方法对指定字段进行统计计算。

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

fieldName - 字段名称。

statisticMode - 统计方法。

返回:

统计结果。

modelingByRules

EditResult modelingByRules(java.lang.String datasourceName,
                         java.lang.String datasetName,
                         java.util.List<ModelingByRulesPostParameter> ruleParams)

根据各项参数规则建模

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

ruleParams - 建模参数列表.

返回:

建模结果

从以下版本开始:

11.1.1

updateModelTextures

boolean updateModelTextures(java.lang.String datasourceName,
                          java.lang.String datasetName,
                          java.lang.String modelID,
                          java.util.List<java.lang.String> textureNames,
                          java.util.List<byte[]> modelTextures)

更新指定模型纹理

参数:

datasourceName - 数据源名称。

datasetName - 数据集名称。

modelID - 模型ID。

textureNames - 纹理名称列表.

modelTextures - 纹理流列表.

返回:

更新是否成功

从以下版本开始:

11.1.1

getDatasetGroupNames

java.util.List<java.lang.String> getDatasetGroupNames(java.lang.String datasourceName)

获取指定数据源的所有数据集组的名称

参数:

datasourceName - 数据源名称

返回:

数据集组的名称

getDatasetGroupInfo

DatasetGroupInfo getDatasetGroupInfo(java.lang.String datasourceName,
                                   java.lang.String datasetGroupName)