com.supermap.web.iServerJava6R.dataServices
public class GetFieldsService
继承 GetFieldsService Inheritance com.supermap.web.service.ServiceBase

数据集字段查询服务类.

数据集字段查询是指查询数据集中所包含的字段信息。
该类负责与服务端完成异步通信:将客户端指定的数据集字段查询参数传递给服务端,并获取服务端返回的结果信息,从而实现数据集字段查询的操作。
用户获取服务端返回的数据集字段查询结果有两种方式:一种是通过监听 GetFieldsEvent.PROCESS_COMPLETE 事件;一种是使用 AsyncResponder 类。



公共属性
  属性 定义方
    dataset : String
查询的数据集名称。
GetFieldsService
    datasource : String
查询的数据源名称。
GetFieldsService
公共方法
  方法 定义方
   
GetFieldsService(url:String)
使用数据服务资源地址初始化 GetFieldsService 类的新实例。
GetFieldsService
   
processAsync(parameters:Object, responder:IResponder = null):AsyncToken
根据数据服务资源地址与服务端完成异步通讯,即发送数据集字段参数,并获取查询结果。.
GetFieldsService
事件
  事件 Summary 定义方
    当与服务端交互失败时触发该事件。 GetFieldsService
    当与服务端交互成功时触发该事件。 GetFieldsService
属性详细信息
dataset 属性
dataset:String

查询的数据集名称。


Implementation
    public function get dataset():String
    public function set dataset(value:String):void
datasource 属性  
datasource:String

查询的数据源名称。


Implementation
    public function get datasource():String
    public function set datasource(value:String):void
构造函数详细信息
GetFieldsService () 构造函数
public function GetFieldsService(url:String)

使用数据服务资源地址初始化 GetFieldsService 类的新实例。

参数
url:String — 数据服务资源地址。例如:“http://localhost:8090/iserver/services/data-world/rest/data”。
方法详细描述
processAsync () 方法
public function processAsync(parameters:Object, responder:IResponder = null):AsyncToken

根据数据服务资源地址与服务端完成异步通讯,即发送数据集字段参数,并获取查询结果。.

当查询成功时,将触发 GetFieldsEvent.PROCESS_COMPLETE 事件。因此用户可以通过两种方式获取查询结果:
1. 通过 AsyncResponder 类获取(推荐使用);
2. 通过监听 GetFieldsEvent.PROCESS_COMPLETE 事件获取。

参数

parameters:Object — 数据集字段查询参数,由用户自定义该对象,并给其增加数据源、数据集等属性,以便查询时使用。例如:
var myparm:Object = new Object();
 
responder:IResponder (default = null) — 由 AsyncResponder 类实现。远程或异步请求服务完成时将调用的处理函数。使用方法为
AsyncResponder(result:Function, fault:Function, token:Object = null)
result:Function — 成功完成请求时应调用的函数。必须具有以下签名:
public function (result:Object, token:Object = null):void;
fault:Function — 请求完成但出错时应调用的函数。必须具有以下签名:
public function (error:FaultEvent, token:Object = null):void;
token:Object (default = null) — 与此请求相关的其他信息。
有关 AsyncResponder 类的详细信息请参见 “ActionScript 语言帮助文档”。

返回
AsyncToken — 返回 AsyncToken 对象,它为异步 RPC 操作提供设置额外数据或标记级别数据的位置。它也允许为单独的调用附加 IResponder。可从 token 属性的 ResultEvent 和 FaultEvent 中引用 AsyncToken。有关 AsyncToken 类的详细信息请参见 “ActionScript 语言帮助文档”。
事件详细信息
fault 事件
Event Object Type: mx.rpc.events.FaultEvent

当与服务端交互失败时触发该事件。

processComplete 事件  
Event Object Type: com.supermap.web.iServerJava6R.serviceEvents.GetFieldsEvent

当与服务端交互成功时触发该事件。