方法详细资料

• createDataset

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

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

  参数:

  datasourceName - 数据源名称。

  datasetInfo - 数据集信息。

  返回:

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

  抛出:

  DataException - 数据服务组件异常信息。

• deleteDataset

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

  在指定的数据源中，根据指定的数据集信息删除一个数据集。

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  返回:

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

  抛出:

  DataException - 数据服务组件异常信息。

• copyDataset

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

  复制数据集。

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

  参数:

  srcDatasourceName - 源数据源名称。

  srcDatasetName - 源数据集名称。

  destDatasourceName - 目标数据源名称。

  destDatasetName - 目标数据集名称。

  返回:

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

  抛出:

  DataException - 数据服务组件异常信息。

• renameDataset

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

  修改指定数据集的名称。

  参数:

  datasourceName - 数据源名称。

  oldName - 旧数据集名称。

  newName - 新数据集名称。

  返回:

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

  抛出:

  DataException - 数据服务组件异常信息。

• containsDataset

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  返回:

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

  抛出:

  DataException - 数据服务组件异常信息。

• addFeatures

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

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

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

  返回:

  编辑结果。

  抛出:

  DataException - 数据服务组件异常信息。

• batchAddFeatures

  void batchAddFeatures(java.lang.String datasourceName,
                      java.lang.String datasetName,
                      java.util.List<Feature> targetFeatures)
                        throws DataException
  

  批量添加要素，添加大量要素时性能优于addFeatures接口，但当某些情况下，某些要素添加失败时无法知道具体失败的要素ID。

  参数:

  datasourceName -

  datasetName -

  targetFeatures -

  抛出:

  DataException

  从以下版本开始:

  6.1.3

• deleteFeatures

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

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

  返回:

  编辑结果。

  抛出:

  DataException - 数据服务组件异常信息。

• deleteFeatures

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

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

  返回:

  编辑结果。

  抛出:

  DataException - 数据服务组件异常信息。

• deleteFeatures

  EditResult deleteFeatures(java.lang.String datasourceName,
                          QueryParameter queryParameter)
                            throws DataException
  

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

  参数:

  datasourceName - 数据源名称。

  queryParameter - 查询参数。

  返回:

  编辑结果。

  抛出:

  DataException - 数据服务组件异常信息。

  从以下版本开始:

  8.0.1

• updateFeatures

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

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

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

  返回:

  编辑结果。

  抛出:

  DataException - 数据服务组件异常信息。

• clearFeatures

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

  清空指定数据集中的要素。

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  返回:

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

  抛出:

  DataException - 数据服务组件异常信息。

• getFeature

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  ids - 要素 ID。

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

  返回:

  要素列表。

  抛出:

  DataException - 数据服务组件异常信息。

• getFeature

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  ids - 要素 ID。

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

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

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

  返回:

  要素列表。

  抛出:

  DataException - 数据服务组件异常信息。

  从以下版本开始:

  8.1.1

• getFeature

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

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

  参数:

  datasourceName - 数据源名称

  datasetName - 数据集名称

  ids - 要素ID

  fields - 到返回的字段数组，为null时，返回所有的字段

  返回:

  要素列表

  抛出:

  DataException - 服务组件异常信息

  从以下版本开始:

  9.1.0

• getFeature

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  bounds - 指定的查询范围。

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

  返回:

  要素列表。

  抛出:

  DataException - 数据服务组件异常信息。

• getFeature

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  bounds - 指定的查询范围。

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

  返回:

  要素列表。

  抛出:

  DataException

• getFeature

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

  获取落在指定几何对象的缓冲区内的要素。

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  geometry - 几何对象。

  bufferDistance - 缓冲区的半径，单位同当前数据集坐标单位（coordUnit）。

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

  返回:

  要素列表。

  抛出:

  DataException - 数据服务组件异常信息。

• getFeature

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  geometry - 几何对象。

  bufferDistance - 缓冲区的半径，单位同当前数据集坐标单位（coordUnit）。

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

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

  返回:

  要素列表

  抛出:

  DataException - 数据服务组件异常信息。

• getFeature

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

  获取与指定几何对象具有特定空间查询模式的要素。

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  geometry - 几何对象。

  spatialQueryMode - 空间查询模式。

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

  返回:

  要素列表。

  抛出:

  DataException - 数据服务组件异常信息。

• 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)
                                     throws DataException
  

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  geometry - 几何对象。

  spatialQueryMode - 空间查询模式。

  attributeFilter - 属性过滤条件。

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

  返回:

  要素列表。

  抛出:

  DataException - 数据服务组件异常信息。

• getFeature

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  geometry - 几何对象。

  spatialQueryMode - 空间查询模式。

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

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

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

  返回:

  要素列表。

  抛出:

  DataException - 数据服务组件异常信息。

• 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)
                                     throws DataException
  

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  geometry - 几何对象。

  spatialQueryMode - 空间查询模式。

  attributeFilter - 属性过滤条件。

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

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

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

  返回:

  要素列表。

  抛出:

  DataException - 数据服务组件异常信息。

• getFeature

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

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

  参数:

  datasourceName - 数据源名称。

  queryParam - 查询参数。

  返回:

  要素列表。

  抛出:

  DataException - 数据服务组件异常信息。

• getFeature

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

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

  参数:

  datasourceName - 数据源名称。

  queryParam - 查询参数。

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

  返回:

  要素列表。

  抛出:

  DataException - 数据服务组件异常信息。

• getFeature

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

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

  参数:

  datasourceName - 数据源名称。

  queryParam - 查询参数。

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

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

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

  返回:

  要素列表。

  抛出:

  DataException - 数据服务组件异常信息。

• getFeature

  GetFeatureResult getFeature(GetFeatureParameters parameters)
                              throws DataException
  

  查询并返回要素结果。

  参数:

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

  返回:

  抛出:

  DataException

• getDatasourceInfos

  java.util.List<DatasourceInfo> getDatasourceInfos()
                                                    throws DataException
  

  获取所有数据源的信息。

  返回:

  数据源信息列表。

  抛出:

  DataException - 数据服务组件异常信息。

• getDatasourceInfo

  DatasourceInfo getDatasourceInfo(java.lang.String datasourceName)
                                   throws DataException
  

  获取指定的某个数据源的信息。

  参数:

  datasourceName - 数据源名称。

  返回:

  数据源信息。

  抛出:

  DataException - 数据服务组件异常信息。

• updateDatasourceInfo

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

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

  参数:

  datasourceName - 数据源名称。

  newDatasourceInfo - 新的数据源信息。

  抛出:

  DataException - 数据服务组件异常信息。

• getDatasetInfos

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

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

  参数:

  datasourceName - 数据源名称。

  返回:

  数据集信息列表。

  抛出:

  DataException - 数据服务组件异常信息。

• getDatasetNames

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

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

  参数:

  datasourceName - 数据源名称。

  返回:

  数据集名称的列表。

  抛出:

  DataException

• getDatasetInfo

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  返回:

  数据集信息。

  抛出:

  DataException - 数据服务组件异常信息。

• updateDatasetInfo

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

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

  参数:

  datasourceName - 数据源名称。

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

  newDatasetInfo - 新的数据集信息。

  抛出:

  DataException - 数据服务组件异常信息。

• getDomainInfos

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

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

  参数:

  datasourceName - 数据源名称

  datasetName - 数据集名称

  返回:

  值域信息列表

  抛出:

  DataException

• getFieldInfos

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  返回:

  字段信息列表。

  抛出:

  DataException - 数据服务组件异常信息。

• updateFieldInfos

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

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

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

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

  抛出:

  DataException - 数据服务组件异常信息。

• statistic

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  fieldIndex - 字段序号。

  statisticMode - 统计方法。

  返回:

  统计结果。

  抛出:

  DataException - 数据服务组件异常信息。

• statistic

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

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

  参数:

  datasourceName - 数据源名称。

  datasetName - 数据集名称。

  fieldName - 字段名称。

  statisticMode - 统计方法。

  返回:

  统计结果。

  抛出:

  DataException - 数据服务组件异常信息。

• getGridValue

  GridValue getGridValue(java.lang.String datasourceName,
                       java.lang.String datasetName,
                       Point2D point2D)
                         throws DataException
  

  获取栅格数据集的指定坐标位置的栅格值。

  参数:

  datasoruceName -

  datasetName -

  point2D -

  返回:

  抛出:

  DataException

  从以下版本开始:

  8.1.1

• getGridValues

  GridValues getGridValues(java.lang.String datasourceName,
                         java.lang.String datasetName,
                         Geometry geometry)
                           throws DataException
  

  根据指定范围,获取栅格值矩阵.

  参数:

  datasourceName -

  datasetName -

  geometry -

  返回:

  抛出:

  DataException

• getImageValue

  ImageValue getImageValue(java.lang.String datasourceName,
                         java.lang.String datasetName,
                         Point2D point2D)
                           throws DataException
  

  获取影像数据集的指定坐标位置的影像信息。

  参数:

  datasoruceName -

  datasetName -

  point2D -

  index - 指定波段

  返回:

  抛出:

  DataException

  从以下版本开始:

  8.1.1

• getImageValues

  ImageValues getImageValues(java.lang.String datasourceName,
                           java.lang.String datasetName,
                           Geometry geometry)
                             throws DataException
  

  根据指定的矩形范围,获取矩形框内的影像值矩阵.

  参数:

  datasourceName -

  datasetName -

  geometry -

  返回:

  抛出:

  DataException

• coordtransfer

  java.util.List<Geometry> coordtransfer(Geometry[] geometrys,
                                       PrjCoordSys sourcePrjCoorSys,
                                       PrjCoordSys targetPrjCoordSys)
                                         throws DataException
  

  根据目标坐标系进行几何对象集合坐标系转换

  参数:

  geometrys -

  sourcePrjCoorSys -

  targetPrjCoordSys -

  返回:

  抛出:

  DataException

  从以下版本开始:

  8.1.1

• isDisableQueryCache

  boolean isDisableQueryCache()
  

  数据查询时是否启用缓存

  返回:

• 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 -

  textureNames -

  modelTextures -

  返回:

  从以下版本开始:

  11.1.1

• getDatasetGroupNames

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

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

  参数:

  datasourceName - 数据源名称

  返回:

  数据集组的名称

  抛出:

  DataException - 数据服务组件异常信息

• getDatasetGroupInfo

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

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

  参数:

  datasourceName - 数据源名称。

  datasetGroupName - 数据集组名称。

  返回:

  数据集组信息。

  抛出:

  DataException - 数据服务组件异常信息。