com.supermap.services

类 DataUploadService

java.lang.Object

com.supermap.services.ServiceBase

com.supermap.services.DataUploadService

public class DataUploadService
extends ServiceBase

数据上传类，用于将本地数据上传到iServer服务器 用户需要设置相应回调函数setResponseCallback，通过该回调函数获取操作结果和服务器响应等。

构造器概要

构造器

构造器和说明
DataUploadService(java.lang.String url) 根据指定的url构造一个新的 DataUploadService 对象。

方法概要

限定符和类型	方法和说明
void	addDataset(java.lang.String fullUrl, java.lang.String datasetName, DatasetType datasetType) 向指定的数据源，添加数据集。
void	addDataset(java.lang.String serviceName, java.lang.String datasourceName, java.lang.String datasetName, DatasetType datasetType) 根据指定的数据集名称和数据类型添加数据集。
void	addDataset(java.lang.String serviceName, java.lang.String datasourceName, java.lang.String destDatasetName, java.lang.String srcDatasourceName, java.lang.String srcDatasetName) 通过复制指定数据源中的指定数据集向服务中添加数据集。
void	addFeature(java.lang.String fullUrl, Feature feature) 向指定的数据服务地址添加对象。
void	addFeature(java.lang.String serviceName, java.lang.String datasourceName, java.lang.String datasetName, Feature feature) 向iServer服务器中添加对象。
void	addRecordset(java.lang.String fullUrl, Recordset recordset) 向指定的数据地址下添加记录集。
boolean	addRecordset(java.lang.String serviceName, java.lang.String datasourceName, java.lang.String datasetName, Recordset recordset) 向指定服务指定数据源中的指定数据集中添加记录集。
void	commitDataset(java.lang.String urlDataset, DatasetVector dataset) 将本地数据集中修改、删除、新增的数据提交到服务器上对应的数据集中。
void	deleteDataset(java.lang.String fullUrl) 删除数据集
void	deleteDataset(java.lang.String serviceName, java.lang.String datasourceName, java.lang.String datasetName) 删除数据集。
void	deleteFeature(java.lang.String featureUri) 根据指定的资源定位符删除iServer服务器中的对象。
void	deleteFeature(java.lang.String fullUrl, int[] featureIDs) 删除指定数据服务地址下的对象。
void	deleteFeature(java.lang.String serviceName, java.lang.String datasourceName, java.lang.String datasetName, int[] featureIDs) 根据指定的对象ID数组删除iServer服务器中的对象。
void	modifyFeature(java.lang.String fullUrl, int featureID, Feature feature) 修改指定地址下的对象。
void	modifyFeature(java.lang.String serviceName, java.lang.String datasourceName, java.lang.String datasetName, int featureID, Feature feature) 根据指定的ID修改对象。

从类继承的方法 com.supermap.services.ServiceBase

getResponseCallback, getUrl, setResponseCallback, setServerName, setUrl

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

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

构造器详细资料

DataUploadService

public DataUploadService(java.lang.String url)

根据指定的url构造一个新的 DataUploadService 对象。

参数:

url - 指定的url。

方法详细资料

addFeature

public void addFeature(java.lang.String serviceName,
                       java.lang.String datasourceName,
                       java.lang.String datasetName,
                       Feature feature)

向iServer服务器中添加对象。

参数:

serviceName - 服务名称。

datasourceName - 数据源名。

datasetName - 数据集名。

feature - 添加对象。

示例:

以下代码示范如何上传数据到服务端。

 public void UpService() {
                        //假设http://192.168.170.59:8090地址服务器上已发布数据Rest服务，服务名称为data-testmap/rest，该数据服务中包含数据源testmap，含点数据集point。
                        DataUploadService uploadService = new DataUploadService("http://192.168.170.59:8090");
                        String serviceName = "data-testmap/rest";
                        String datasourceName = "testmap";
                        String datasetName = "point";
                        uploadService.setResponseCallback(new ResponseCallback() {
                                
                                @Override
                                public void requestSuccess() {
                                        // TODO Auto-generated method stub
                                        System.out.println("上传requestSuccess"); 
                                }
                                
                                @Override
                                public void requestFailed(String arg0) {
                                        // TODO Auto-generated method stub
                                        System.out.println("上传requestFailed");
                                }
                                
                                @Override
                                public void receiveResponse(FeatureSet featureSet) {
                                        // TODO Auto-generated method stub
                                        System.out.println("上传receiveResponse");
                                }
                        });
                        String[] fieldNames = {"Name4","Name6"};
                        String[] fieldValues = {"名字4","名字6"};
                        GeoPoint geopoint = new GeoPoint();
                        Feature feature = new Feature(fieldNames, fieldValues, geopoint);
                        uploadService.addFeature(serviceName, datasourceName, datasetName, feature);
    }
 

addFeature

public void addFeature(java.lang.String fullUrl,
                       Feature feature)

向指定的数据服务地址添加对象。

参数:

fullUrl - 指定的数据服务地址，如：http://192.168.120.1:8090/iserver/services/data-world/rest/data/datasources/World/datasets/Lakes。

feature - 待添加对象。

deleteFeature

public void deleteFeature(java.lang.String serviceName,
                          java.lang.String datasourceName,
                          java.lang.String datasetName,
                          int[] featureIDs)

根据指定的对象ID数组删除iServer服务器中的对象。

参数:

serviceName - 服务名称。

datasourceName - 数据源名。

datasetName - 数据集名。

featureIDs - 对象ID数组。

deleteFeature

public void deleteFeature(java.lang.String fullUrl,
                          int[] featureIDs)

删除指定数据服务地址下的对象。

参数:

fullUrl - 指定数据服务地址，如:http://192.168.120.1:8090/iserver/services/data-world/rest/data/datasources/World/datasets/Lakes。

featureIDs - 对象ID数组。

deleteFeature

public void deleteFeature(java.lang.String featureUri)

根据指定的资源定位符删除iServer服务器中的对象。

参数:

featureUri - 指定的资源定位符。

modifyFeature

public void modifyFeature(java.lang.String serviceName,
                          java.lang.String datasourceName,
                          java.lang.String datasetName,
                          int featureID,
                          Feature feature)

根据指定的ID修改对象。

参数:

serviceName - 服务名称。

datasourceName - 数据源名。

datasetName - 数据集名。

featureID - 要修改的对象ID。

feature - 结果对象。

modifyFeature

public void modifyFeature(java.lang.String fullUrl,
                          int featureID,
                          Feature feature)

修改指定地址下的对象。

参数:

fullUrl - 要修改的对象地址，如：http://192.168.120.1:8090/iserver/services/data-world/rest/data/datasources/World/datasets/Lakes。

featureID - 要修改的对象ID。

feature - 修改的值。

addRecordset

public boolean addRecordset(java.lang.String serviceName,
                            java.lang.String datasourceName,
                            java.lang.String datasetName,
                            Recordset recordset)

向指定服务指定数据源中的指定数据集中添加记录集。

参数:

serviceName - 服务名称。

datasourceName - 数据源名。

datasetName - 数据集名。

recordset - 待添加的记录集。

返回:

一个布尔值，指示记录集是否添加成功，添加成功则返回 true，否则返回 false。

addRecordset

public void addRecordset(java.lang.String fullUrl,
                         Recordset recordset)

向指定的数据地址下添加记录集。

参数:

fullUrl - 指定的数据地址，如：http://192.168.120.1:8090/iserver/services/data-world/rest/data/datasources/World/datasets/Lakes。

recordset - 要添加的记录集。

addDataset

public void addDataset(java.lang.String serviceName,
                       java.lang.String datasourceName,
                       java.lang.String datasetName,
                       DatasetType datasetType)

根据指定的数据集名称和数据类型添加数据集。

参数:

serviceName - 服务名称。

datasourceName - 数据源名。

datasetName - 数据集名。

datasetType - 数据类型。

addDataset

public void addDataset(java.lang.String serviceName,
                       java.lang.String datasourceName,
                       java.lang.String destDatasetName,
                       java.lang.String srcDatasourceName,
                       java.lang.String srcDatasetName)

通过复制指定数据源中的指定数据集向服务中添加数据集。

参数:

serviceName - 服务名称。

datasourceName - 数据源名。

destDatasetName - 目标数据集名。

srcDatasourceName - 源数据源名。

srcDatasetName - 源数据集名。

addDataset

public void addDataset(java.lang.String fullUrl,
                       java.lang.String datasetName,
                       DatasetType datasetType)

向指定的数据源，添加数据集。

参数:

fullUrl - 指定的数据源的地址，如：http://192.168.120.1:8090/iserver/services/data-world/rest/data/datasources/World。

datasetName - 数据集名。

datasetType - 数据类型。

deleteDataset

public void deleteDataset(java.lang.String serviceName,
                          java.lang.String datasourceName,
                          java.lang.String datasetName)

删除数据集。

参数:

serviceName - 服务名称。

datasourceName - 数据源名。

datasetName - 源数据集名。

deleteDataset

public void deleteDataset(java.lang.String fullUrl)

删除数据集

参数:

fullUrl - 要删除的数据集地址，如：http://192.168.120.1:8090/iserver/services/data-world/rest/data/datasources/World/datasets/Lakes。

commitDataset

public void commitDataset(java.lang.String urlDataset,
                          DatasetVector dataset)

将本地数据集中修改、删除、新增的数据提交到服务器上对应的数据集中。提交时要求本地和服务器上都存在该数据集及其对应的属性数据集（属性数据集用于记录被修改和被删除的记录）。 同时本地数据集的版本不得高于服务器上的版本（即本地的Max[SmUserID]不大于服务器上的Max[SMID]），否则不能提交，需要先进行更新。目前数据集的类型支持点、线、面数据集。 如果提交失败，将调用ResponseCallback中的requestFaild（）方法；如果成功，将调用requestSuccess()方法。

参数:

urlDataset - dataset在服务器上的地址。

dataset - 本地数据集，可以使点、线、面数据集。

urlDataset示例：http://192.168.0.131:8090/iserver/services/data-changchun/rest/data/datasources/Changchun/datasets/Edit_Line。