com.supermap.services

类 DataDownloadService

java.lang.Object

com.supermap.services.ServiceBase

com.supermap.services.DataDownloadService

public class DataDownloadService
extends ServiceBase

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

构造器概要

构造器

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

方法概要

限定符和类型	方法和说明
void	download(java.lang.String fullUrl, int fromIndex, int toIndex) 获取指定的数据服务地址下对象集合。
void	download(java.lang.String serviceName, java.lang.String datasourceName, java.lang.String datasetName, int fromIndex, int toIndex) 从iServer服务器上下载对象集合。
void	downloadAll(java.lang.String fullUrl) 获取指定的数据服务地址下所有对象集合。
void	downloadAll(java.lang.String serviceName, java.lang.String datasourceName, java.lang.String datasetName) 从iServer服务器上下载所有对象集合。
void	downloadDataset(java.lang.String urlDataset, Datasource datasource) 从服务器上下载一个数据集（支持点、线、面数据集），且在本地数据源中不存在与被下载的数据集同名的数据集，同时会在本地和服务器上创建一个同步属性数据集， 用于记录所下载的数据集在本地被修改的情况。
void	updateDataset(java.lang.String urlDataset, DatasetVector dataset) 从服务器上更新本地数据集（支持点、线、面数据集），且要求本地存在同步数据集，服务器上存在要下载的数据集及其同步属性数据集。

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

getResponseCallback, getUrl, setResponseCallback, setServerName, setUrl

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

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

构造器详细资料

DataDownloadService

public DataDownloadService(java.lang.String url)

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

参数:

url - 指定的url。

方法详细资料

downloadAll

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

从iServer服务器上下载所有对象集合。

参数:

serviceName - 服务名称。

datasourceName - 数据源名。

datasetName - 数据集名。

示例:

以下代码示范如何从服务器上下载数据。

 public void DownService() {
                //假设http://192.168.170.59:8090地址服务器上已发布数据Rest服务，服务名称为data-testmap/rest，该数据服务中包含数据源testmap，含数据集Rivers。
                DataDownloadService downloadService = new DataDownloadService("http://192.168.170.59:8090");
                String serviceName = "data-testmap/rest";
                String datasourceName = "testmap";
                String datasetName = "Rivers";
                downloadService.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 arg0) {
                                // TODO Auto-generated method stub
                                System.out.println("下载receiveResponse");
                                if (arg0 instanceof FeatureSet) {
                                        FeatureSet featureSet = (FeatureSet)arg0;
                                        featureSet.moveFirst();
                                        while (!featureSet.isEOF()) {           
                                                Geometry geo = featureSet.getGeometry();
                                                if (geo == null) {
                                                        featureSet.moveNext();
                                                        continue;
                                                }
                                                featureSet.moveNext();
                                        }               
                                        System.out.println("要素集合中要素的个数是 " + featureSet.getFeatureCount());                                      }                               
                                }
                        }       
                });
                downloadService.download(serviceName, datasourceName, datasetName, 1, 15);      
        }
 

download

public void download(java.lang.String serviceName,
                     java.lang.String datasourceName,
                     java.lang.String datasetName,
                     int fromIndex,
                     int toIndex)

从iServer服务器上下载对象集合。

参数:

serviceName - 服务名称。

datasourceName - 数据源名。

datasetName - 数据集名。

fromIndex - 起始下标。

toIndex - 结束下标。

download

public void download(java.lang.String fullUrl,
                     int fromIndex,
                     int toIndex)

获取指定的数据服务地址下对象集合。

参数:

fullUrl - 数据服务的地址，如：http://127.0.0.1:8090/iserver/services/data-China400/rest/data/datasources/China400/datasets/City_R。

fromIndex - 起始下标。

toIndex - 结束下标。

downloadAll

public void downloadAll(java.lang.String fullUrl)

获取指定的数据服务地址下所有对象集合。

参数:

fullUrl - 数据服务的地址，如：http://127.0.0.1:8090/iserver/services/data-China400/rest/data/datasources/China400/datasets/City_R。

downloadDataset

public void downloadDataset(java.lang.String urlDataset,
                            Datasource datasource)

从服务器上下载一个数据集（支持点、线、面数据集），且在本地数据源中不存在与被下载的数据集同名的数据集，同时会在本地和服务器上创建一个同步属性数据集， 用于记录所下载的数据集在本地被修改的情况。同步数据集的名称为被下载的数据集名加上后缀“_Table”。如果下载失败，将调用ResponseCallback中的requestFaild（）方法；如果成功，将调用requestSuccess()方法。

参数:

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

datasource - 本地数据源。

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

updateDataset

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

从服务器上更新本地数据集（支持点、线、面数据集），且要求本地存在同步数据集，服务器上存在要下载的数据集及其同步属性数据集。 如果更新失败，将调用ResponseCallback中的requestFaild（）方法；如果成功，将调用requestSuccess()方法。

参数:

urlDataset - 数据集在服务器上的地址。

dataset - 本地数据集。

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