@supermapgis/iclient-ol 11.2.0

package/services/DataFlowService.js

@@ -0,0 +1,119 @@
+/* Copyright© 2000 - 2024 SuperMap Software Co.Ltd. All rights reserved.
+ * This program are made available under the terms of the Apache License, Version 2.0
+ * which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
+import {ServiceBase} from './ServiceBase';
+import { DataFlowService as DataFlow } from '@supermapgis/iclient-common/iServer/DataFlowService';
+
+/**
+ * @class DataFlowService
+ * @category  iServer DataFlow
+ * @classdesc 数据流服务类。用于实现客户端与服务器之间实现低延迟和实时数据传输。数据流服务采用 WebSocket 协议，支持全双工、双向式通信。
+ * 服务器可将流数据服务的分析处理结果作为数据来源向客户端广播，客户端与数据流服务建立连接后，即可自动接收服务器广播的数据。
+ * @modulecategory Services
+ * @extends {ServiceBase}
+ * @example
+ *      new DataFlowService(url).queryChart(param,function(result){
+ *          //doSomething
+ *      })
+ * @param {string} url - 服务地址。
+ * @param {Object} options - 参数。
+ * @param {string} [options.proxy] - 服务代理地址。
+ * @param {boolean} [options.withCredentials=false] - 请求是否携带 cookie。
+ * @param {boolean} [options.crossOrigin] - 是否允许跨域请求。
+ * @param {Object} [options.headers] - 请求头。
+ * @param {GeoJSONObject} [options.geometry] - 指定几何范围，只有在该范围内的要素才能被订阅。
+ * @param {Object} [options.excludeField] - 排除字段。
+ * @usage
+ */
+export class DataFlowService extends ServiceBase {
+
+    constructor(url, options) {
+        options = options || {};
+        if (options.projection) {
+            options.prjCoordSys = options.projection;
+        }
+        super(url, options);
+        this.dataFlow = new DataFlow(url, options);
+        this.dataFlow.events.on({
+            "broadcastSocketConnected": this._defaultEvent,
+            "broadcastSocketError": this._defaultEvent,
+            "broadcastFailed": this._defaultEvent,
+            "broadcastSucceeded": this._defaultEvent,
+            "subscribeSocketConnected": this._defaultEvent,
+            "subscribeSocketError": this._defaultEvent,
+            "messageSucceeded": this._defaultEvent,
+            "setFilterParamSucceeded": this._defaultEvent,
+            scope: this
+        });
+    }
+
+    /**
+     * @function DataFlowService.prototype.initBroadcast
+     * @description 初始化广播。
+     * @returns {DataFlowService} - 数据流服务。
+     */
+    initBroadcast() {
+        this.dataFlow.initBroadcast();
+        return this;
+    }
+
+    /**
+     * @function DataFlowService.prototype.broadcast
+     * @description 加载广播数据。
+     * @param {JSONObject} obj - JSON 格式的要素数据。
+     */
+    broadcast(obj) {
+        this.dataFlow.broadcast(obj);
+    }
+
+    /**
+     * @function DataFlowService.prototype.initSubscribe
+     * @description 初始化订阅数据。
+     */
+    initSubscribe() {
+        this.dataFlow.initSubscribe();
+        return this;
+    }
+
+    /**
+     * @function DataFlowService.prototype.setExcludeField
+     * @description 设置排除字段。
+     * @param {Object} excludeField - 排除字段。
+     */
+    setExcludeField(excludeField) {
+        this.dataFlow.setExcludeField(excludeField);
+        this.options.excludeField = excludeField;
+        return this;
+    }
+
+    /**
+     * @function DataFlowService.prototype.setGeometry
+     * @description 设置添加的几何要素数据。
+     * @param {GeoJSONObject} geometry - 指定几何范围，只有在该范围内的要素才能被订阅。
+     */
+    setGeometry(geometry) {
+        this.dataFlow.setGeometry(geometry);
+        this.options.geometry = geometry;
+        return this;
+    }
+
+    /**
+     * @function DataFlowService.prototype.unSubscribe
+     * @description 结束订阅数据。
+     */
+    unSubscribe() {
+        this.dataFlow.unSubscribe();
+    }
+
+    /**
+     * @function DataFlowService.prototype.unBroadcast
+     * @description 结束加载广播。
+     */
+    unBroadcast() {
+        this.dataFlow.unBroadcast();
+    }
+
+    _defaultEvent(e) {
+        this.dispatchEvent({type: e.eventType || e.type, value: e});
+    }
+}

package/services/DatasetService.js

@@ -0,0 +1,104 @@
+/* Copyright© 2000 - 2024 SuperMap Software Co.Ltd. All rights reserved.
+ * This program are made available under the terms of the Apache License, Version 2.0
+ * which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
+import { ServiceBase } from './ServiceBase';
+import { DatasetService as CommonDatasetService } from '@supermapgis/iclient-common/iServer/DatasetService';
+import { CreateDatasetParameters } from '@supermapgis/iclient-common/iServer/CreateDatasetParameters';
+import { UpdateDatasetParameters } from '@supermapgis/iclient-common/iServer/UpdateDatasetParameters';
+
+/**
+ * @class DatasetService
+ * @category  iServer Data Dataset
+ * @classdesc 数据集信息服务类。提供方法：查询数据集集合、查询指定数据集信息，在指定数据源下新增、修改、删除数据集等。
+ * @modulecategory Services
+ * @param {string} url - 服务地址。
+ * @param {Object} options - 参数。
+ * @param {string} [options.proxy] - 服务代理地址。
+ * @param {boolean} [options.withCredentials=false] - 请求是否携带 cookie。
+ * @param {boolean} [options.crossOrigin] - 是否允许跨域请求。
+ * @param {Object} [options.headers] - 请求头。
+ * @extends {ServiceBase}
+ * @usage
+ */
+export class DatasetService extends ServiceBase {
+
+    constructor(url, options) {
+      super(url, options);
+      this._datasetService = new CommonDatasetService(this.url, {
+        proxy: this.options.proxy,
+        withCredentials: this.options.withCredentials,
+        crossOrigin: this.options.crossOrigin,
+        headers: this.options.headers
+      });
+    }
+
+    /**
+     * @function DatasetService.prototype.getDatasets
+     * @description 数据集查询服务。
+     * @param {string} datasourceName - 数据源名称。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @returns {Promise} Promise 对象。
+     */
+    getDatasets(datasourceName, callback) {
+        if (!datasourceName) {
+            return;
+        }
+        return this._datasetService.getDatasetsService(datasourceName, callback);
+    }
+
+    /**
+     * @function DatasetService.prototype.getDataset
+     * @description 数据集查询服务。
+     * @param {string} datasourceName - 数据源名称。
+     * @param {string} datasetName - 数据集名称。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @returns {Promise} Promise 对象。
+     */
+    getDataset(datasourceName, datasetName, callback) {
+      if (!datasourceName || !datasetName) {
+          return;
+      }
+      return this._datasetService.getDatasetService(datasourceName, datasetName, callback);
+    }
+
+    /**
+     * @function DatasetService.prototype.setDataset
+     * @description 数据集信息设置服务。可实现修改已存在数据集，新增不存在数据集。
+     * @param {CreateDatasetParameters | UpdateDatasetParameters } params - 数据集创建参数类或数据集信息更改参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @returns {Promise} Promise 对象。
+     */
+    setDataset(params, callback) {
+      if(!(params instanceof CreateDatasetParameters) && !(params instanceof UpdateDatasetParameters)){
+          return;
+      }else if (params instanceof CreateDatasetParameters) {
+          var datasetParams = {
+              "datasetType": params.datasetType,
+              "datasetName": params.datasetName,
+              "datasourceName": params.datasourceName
+          }
+      }else if(params instanceof UpdateDatasetParameters){
+            datasetParams = {
+                  "datasetName": params.datasetName,
+                  "datasourceName": params.datasourceName,
+                  "isFileCache": params.isFileCache,
+                  "description": params.description,
+                  "prjCoordSys": params.prjCoordSys,
+                  "charset": params.charset
+              }
+      }
+      return this._datasetService.setDatasetService(datasetParams, callback);
+    }
+
+    /**
+     * @function DatasetService.prototype.deleteDataset
+     * @description 指定数据源下的数据集删除服务。
+     * @param {string} datasourceName - 数据源名称。
+     * @param {string} datasetName - 数据集名称。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @returns {Promise} Promise 对象。
+     */
+    deleteDataset(datasourceName, datasetName, callback) {
+      return this._datasetService.deleteDatasetService(datasourceName, datasetName, callback);
+    }
+}

package/services/DatasourceService.js

@@ -0,0 +1,76 @@
+/* Copyright© 2000 - 2024 SuperMap Software Co.Ltd. All rights reserved.
+ * This program are made available under the terms of the Apache License, Version 2.0
+ * which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
+import {ServiceBase} from './ServiceBase';
+import {DatasourceService as CommonDatasourceService} from '@supermapgis/iclient-common/iServer/DatasourceService';
+import { SetDatasourceParameters } from '@supermapgis/iclient-common/iServer/SetDatasourceParameters';
+
+/**
+ * @class DatasourceService
+ * @category  iServer Data Datasource
+ * @classdesc 数据源服务类。提供方法：查询数据源集合、查询指定数据源信息、设置指定数据源信息。可以获取的数据源信息包括数据源名称、数据源描述、引擎类型、距离单位、坐标单位、投影信息等。
+ * @modulecategory Services
+ * @param {string} url - 服务地址。
+ * @param {Object} options - 参数。
+ * @param {string} [options.proxy] - 服务代理地址。
+ * @param {boolean} [options.withCredentials=false] - 请求是否携带 cookie。
+ * @param {boolean} [options.crossOrigin] - 是否允许跨域请求。
+ * @param {Object} [options.headers] - 请求头。
+ * @extends {ServiceBase}
+ * @usage
+ */
+export class DatasourceService extends ServiceBase {
+
+    constructor(url, options) {
+        super(url, options);
+        this._datasourceService = new CommonDatasourceService(this.url, {
+          proxy: this.proxy,
+          withCredentials: this.withCredentials,
+          crossOrigin: this.crossOrigin,
+          headers: this.headers
+        });
+    }
+
+    /**
+     * @function DatasourceService.prototype.getDatasources
+     * @description 数据源集合查询服务。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     */
+    getDatasources(callback) {
+      return this._datasourceService.getDatasourcesService(callback);
+    }
+
+    /**
+     * @function DatasourceService.prototype.getDatasource
+     * @description 数据源信息查询服务。
+     * @param {string} datasourceName - 数据源名称。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @returns {Promise} Promise 对象。
+     */
+    getDatasource(datasourceName, callback) {
+      if (!datasourceName) {
+          return;
+      }
+      return this._datasourceService.getDatasourceService(datasourceName, callback);
+    }
+
+   /**
+     * @function DatasourceService.prototype.setDatasource
+     * @description 数据源信息设置服务。可实现更改当前数据源信息。
+     * @param {SetDatasourceParameters} params - 数据源信息设置参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @returns {Promise} Promise 对象。
+     */
+    setDatasource(params, callback) {
+        if (!(params instanceof SetDatasourceParameters)) {
+            return;
+        }
+        const datasourceParams = {
+          description: params.description,
+          coordUnit: params.coordUnit,
+          distanceUnit: params.distanceUnit,
+          datasourceName: params.datasourceName
+        };
+        return this._datasourceService.setDatasourceService(datasourceParams, callback);
+    }
+}

package/services/FeatureService.js

@@ -0,0 +1,260 @@
+/* Copyright© 2000 - 2024 SuperMap Software Co.Ltd. All rights reserved.
+ * This program are made available under the terms of the Apache License, Version 2.0
+ * which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
+import { Util as CommonUtil } from '@supermapgis/iclient-common/commontypes/Util';
+import { DataFormat } from '@supermapgis/iclient-common/REST';
+import { EditFeaturesService } from '@supermapgis/iclient-common/iServer/EditFeaturesService';
+import { FeatureService as CommonFeatureService } from '@supermapgis/iclient-common/iServer/FeatureService';
+import { Util } from '../core/Util';
+import { ServiceBase } from './ServiceBase';
+import GeoJSON from 'ol/format/GeoJSON';
+import Geometry from 'ol/geom/Geometry';
+import Polygon from 'ol/geom/Polygon';
+
+/**
+ * @class FeatureService
+ * @constructs FeatureService
+ * @category  iServer Data Feature
+ * @classdesc 要素数据集类。提供：ID 查询，范围查询，SQL查询，几何查询，缓冲区查询，地物编辑，要素附件查询、编辑等方法。
+ * @modulecategory Services
+ * @example
+ *      new FeatureService(url).getFeaturesByIDs(param,function(result){
+ *          //doSomething
+ *      })
+ * @param {string} url - 服务地址。
+ * @param {Object} options - 参数。
+ * @param {string} [options.proxy] - 服务代理地址。
+ * @param {boolean} [options.withCredentials=false] - 请求是否携带 cookie。
+ * @param {boolean} [options.crossOrigin] - 是否允许跨域请求。
+ * @param {Object} [options.headers] - 请求头。
+ * @extends {ServiceBase}
+ * @usage
+ */
+export class FeatureService extends ServiceBase {
+  constructor(url, options) {
+    super(url, options);
+    this._featureService = new CommonFeatureService(url, options);
+  }
+
+  /**
+   * @function FeatureService.prototype.getFeaturesByIDs
+   * @description 数据集 ID 查询服务。
+   * @param {GetFeaturesByIDsParameters} params - ID 查询参数类。
+   * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+   * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的数据格式。
+   * @returns {Promise} Promise 对象。
+   */
+  getFeaturesByIDs(params, callback, resultFormat) {
+    params = this._processParams(params);
+    return this._featureService.getFeaturesByIDs(params, callback, resultFormat);
+  }
+
+  /**
+   * @function FeatureService.prototype.getFeaturesByBounds
+   * @description 数据集范围查询服务。
+   * @param {GetFeaturesByBoundsParameters} params - 数据集范围查询参数类。
+   * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+   * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的数据格式。
+   * @returns {Promise} Promise 对象。
+   */
+  getFeaturesByBounds(params, callback, resultFormat) {
+    params = this._processParams(params);
+    return this._featureService.getFeaturesByBounds(params, callback, resultFormat);
+  }
+
+  /**
+   * @function FeatureService.prototype.getFeaturesByBuffer
+   * @description 数据集缓冲区查询服务。
+   * @param {GetFeaturesByBufferParameters} params - 数据集缓冲区查询参数类。
+   * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+   * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的数据格式。
+   * @returns {Promise} Promise 对象。
+   */
+  getFeaturesByBuffer(params, callback, resultFormat) {
+    params = this._processParams(params);
+    return this._featureService.getFeaturesByBuffer(params, callback, resultFormat);
+  }
+
+  /**
+   * @function FeatureService.prototype.getFeaturesBySQL
+   * @description 数据集 SQL 查询服务。
+   * @param {GetFeaturesBySQLParameters} params - 数据集 SQL 查询参数类。
+   * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+   * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的数据格式。
+   * @returns {Promise} Promise 对象。
+   */
+  getFeaturesBySQL(params, callback, resultFormat) {
+    params = this._processParams(params);
+    return this._featureService.getFeaturesBySQL(params, callback, resultFormat);
+  }
+
+  /**
+   * @function FeatureService.prototype.getFeaturesByGeometry
+   * @description 数据集几何查询服务类。
+   * @param {GetFeaturesByGeometryParameters} params - 数据集几何查询参数类。
+   * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+   * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的数据格式。
+   * @returns {Promise} Promise 对象。
+   */
+  getFeaturesByGeometry(params, callback, resultFormat) {
+    params = this._processParams(params);
+    return this._featureService.getFeaturesByGeometry(params, callback, resultFormat);
+  }
+
+  /**
+   * @function FeatureService.prototype.editFeatures
+   * @description 地物编辑服务。
+   * @param {EditFeaturesParameters} params - 数据服务中数据集添加、修改、删除参数类。
+   * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+   * @returns {Promise} Promise 对象。
+   */
+  editFeatures(params, callback) {
+    if (!params || !params.dataSourceName || !params.dataSetName) {
+      return;
+    }
+    var me = this,
+      url = me.url,
+      dataSourceName = params.dataSourceName,
+      dataSetName = params.dataSetName;
+    url = CommonUtil.urlPathAppend(url, 'datasources/' + dataSourceName + '/datasets/' + dataSetName);
+
+    var editFeatureService = new EditFeaturesService(url, {
+      proxy: me.options.proxy,
+      withCredentials: me.options.withCredentials,
+      crossOrigin: me.options.crossOrigin,
+      headers: me.options.headers
+    });
+    return editFeatureService.processAsync(me._processParams(params), callback);
+  }
+
+  /**
+   * @function FeatureService.prototype.getMetadata
+   * @description 地理要素元信息。
+   * @version 11.1.1
+   * @param {Object} params - 包括数据源名称、数据集名称、要素 ID。
+   * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+   * @returns {Promise} Promise 对象。
+   */
+  getMetadata(params, callback) {
+    return this._featureService.getMetadata(params, callback);
+  }
+
+  /**
+   * @function FeatureService.prototype.getFeatureAttachments
+   * @description 要素附件查询服务。
+   * @version 11.2.0
+   * @param {AttachmentsParameters} params - 要素附件服务中附件查询参数类。
+   * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+   * @returns {Promise} Promise 对象。
+   */
+  getFeatureAttachments(params, callback) {
+    return this._featureService.getFeatureAttachments(params, callback);
+  }
+
+  /**
+   * @function FeatureService.prototype.editFeatureAttachments
+   * @description 要素附件编辑服务。
+   * @version 11.2.0
+   * @param {EditAttachmentsParameters} params - 要素附件服务中附件添加、删除参数类。
+   * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+   * @returns {Promise} Promise 对象。
+   */
+  editFeatureAttachments(params, callback) {
+    return this._featureService.editFeatureAttachments(params, callback);
+  }
+  
+  /**
+     * @function FeatureService.prototype.getFeaturesCount
+     * @description 获取要素数量。
+     * @version 11.2.0
+     * @param {GetFeaturesByIDsParameters|GetFeaturesByBoundsParameters|GetFeaturesByBufferParameters|GetFeaturesByGeometryParameters|GetFeaturesBySQLParameters} params - 查询参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @returns {Promise} Promise 对象。
+     */
+  getFeaturesCount(params, callback) {
+    params = this._processParams(params);
+    return this._featureService.getFeaturesCount(params, callback);
+  }
+
+  /**
+   * @function FeatureService.prototype.getFeaturesDatasetInfo
+   * @description 获取要素数据集信息。
+   * @version 11.2.0
+   * @param {GetFeaturesByIDsParameters|GetFeaturesByBoundsParameters|GetFeaturesByBufferParameters|GetFeaturesByGeometryParameters|GetFeaturesBySQLParameters} params - 查询参数类。
+   * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+   * @returns {Promise} Promise 对象。
+   */
+  getFeaturesDatasetInfo(params, callback) {
+    params = this._processParams(params);
+    return this._featureService.getFeaturesDatasetInfo(params, callback);
+  }
+
+  _processParams(params) {
+    if (!params) {
+      return {};
+    }
+    var me = this;
+    params.returnContent = params.returnContent == null ? true : params.returnContent;
+    params.fromIndex = params.fromIndex ? params.fromIndex : 0;
+    params.toIndex = params.toIndex ? params.toIndex : -1;
+    if (params.bounds) {
+      params.bounds = Util.toSuperMapBounds(params.bounds);
+    }
+    if (params.geometry && params.geometry instanceof Geometry) {
+      params.geometry = Util.toSuperMapGeometry(JSON.parse(new GeoJSON().writeGeometry(params.geometry)));
+    }
+    if (params.editType) {
+      params.editType = params.editType.toLowerCase();
+    }
+    if (params.features) {
+      var features = [];
+      if (Util.isArray(params.features)) {
+        params.features.map(function (feature) {
+          features.push(me._createServerFeature(feature));
+          return feature;
+        });
+      } else {
+        features.push(me._createServerFeature(params.features));
+      }
+      params.features = features;
+    }
+    return params;
+  }
+
+  _createServerFeature(geoFeature) {
+    var feature = {},
+      fieldNames = [],
+      fieldValues = [];
+    if(geoFeature.toServerFeature){
+      return geoFeature.toServerFeature({geometryFunction:(geometry)=>{
+        if(Array.isArray(geometry) && geometry.length === 4){
+          const polygon = new Polygon([[[geometry[0], geometry[1]], [geometry[2], geometry[1]], [geometry[2], geometry[3]], [geometry[0], geometry[3]]]]);
+          return Util.toSuperMapGeometry(new GeoJSON().writeGeometryObject(polygon));
+        }
+        if(geometry.getExtent){
+          return Util.toSuperMapGeometry(new GeoJSON().writeGeometryObject(geometry));
+        }
+        return Util.toSuperMapGeometry(geometry);
+      }})
+    }  
+    var properties = geoFeature.getProperties();
+    for (var key in properties) {
+      if (key === geoFeature.getGeometryName()) {
+        continue;
+      }
+      fieldNames.push(key);
+      fieldValues.push(properties[key]);
+    }
+    feature.fieldNames = fieldNames;
+    feature.fieldValues = fieldValues;
+    if (geoFeature.getId()) {
+      feature.id = geoFeature.getId();
+    }
+    feature.geometry = Util.toSuperMapGeometry(new GeoJSON().writeFeatureObject(geoFeature));
+    return feature;
+  }
+
+  _processFormat(resultFormat) {
+    return resultFormat ? resultFormat : DataFormat.GEOJSON;
+  }
+}

package/services/FieldService.js

@@ -0,0 +1,53 @@
+/* Copyright© 2000 - 2024 SuperMap Software Co.Ltd. All rights reserved.
+ * This program are made available under the terms of the Apache License, Version 2.0
+ * which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
+import {ServiceBase} from './ServiceBase';
+import { FieldService as CommonFieldService } from '@supermapgis/iclient-common/iServer/FieldService';
+
+/**
+ * @class FieldService
+ * @category  iServer Data Field
+ * @classdesc 字段服务类。提供方法：查询字段信息、查询字段统计信息等。
+ * @example
+ *      new FieldService(url).getFields(function(result){
+ *           //doSomething
+ *      });
+ * @modulecategory Services
+ * @param {string} url - 服务地址。
+ * @param {Object} options - 参数。
+ * @param {string} [options.proxy] - 服务代理地址。
+ * @param {boolean} [options.withCredentials=false] - 请求是否携带 cookie。
+ * @param {boolean} [options.crossOrigin] - 是否允许跨域请求。
+ * @param {Object} [options.headers] - 请求头。
+ * @extends {ServiceBase}
+ * @usage
+ */
+export class FieldService extends ServiceBase {
+
+    constructor(url, options) {
+        super(url, options);
+        this._fieldService = new CommonFieldService(url, options);
+    }
+
+    /**
+     * @function FieldService.prototype.getFields
+     * @description 字段查询服务。
+     * @param {FieldParameters} params - 字段信息查询参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @returns {Promise} Promise 对象。
+     */
+    getFields(params, callback) {
+      return this._fieldService.getFields(params, callback);
+    }
+
+    /**
+     * @function FieldService.prototype.getFieldStatisticsInfo
+     * @description 字段统计服务。
+     * @param {FieldStatisticsParameters} params - 字段统计信息查询参数类。
+     * @param {RequestCallback} callback - 回调函数。
+     * @returns {Promise} Promise 对象。
+     */
+    getFieldStatisticsInfo(params, callback) {
+      return this._fieldService.getFieldStatisticsInfo(params, callback);
+    }
+}