com.supermap.web.iServerJava6R.layerServices
public class SetLayerStatusService
继承 SetLayerStatusService Inheritance com.supermap.web.service.ServiceBase

子图层显示控制服务类.

该类负责将子图层显示控制参数传递到服务端,并获取服务端返回的图层显示状态。
用户获取服务端返回的各子图层显示状态有两种方式:一种是通过监听 SetLayerEvent.PROCESS_COMPLETE 事件;一种是始用 AsyncResponder 类实现异步处理。其中 SetLayerEvent 类既存有从服务端获取的原始结果,也包括经客户端处理后的最终结果 SetLayerResult;始用 AsyncResponder 类获取的结果为经客户端处理后的最终结果 SetLayerResult。当用户只需要最终结果时,推荐使用 AsyncResponder 类。



公共方法
  方法 定义方
   
使用地图服务访问地址初始化 SetLayerStatusService 类的新实例。
SetLayerStatusService
   
processAsync(parameters:SetLayerStatusParameters, responder:IResponder = null):AsyncToken
根据地图服务地址与服务端完成异步通讯,获取各子图层可视状态。.
SetLayerStatusService
事件
  事件 Summary 定义方
    当与服务端交互失败时触发该事件。 SetLayerStatusService
    当与服务端交互成功时触发该事件。 SetLayerStatusService
构造函数详细信息
SetLayerStatusService () 构造函数
public function SetLayerStatusService(url:String)

使用地图服务访问地址初始化 SetLayerStatusService 类的新实例。

参数
url:String — 地图服务访问地址。请求地图服务,URL 应为:
http://{服务器地址}:{服务端口号}/iserver/services/{地图服务名}/rest/maps/{地图名};
方法详细描述
processAsync () 方法
public function processAsync(parameters:SetLayerStatusParameters, responder:IResponder = null):AsyncToken

根据地图服务地址与服务端完成异步通讯,获取各子图层可视状态。.

当子图层显示控制成功时,将触发 SetLayerEvent.PROCESS_COMPLETE 事件。用可以通过户两种方式获取图层信息:
1. 通过 AsyncResponder 类获取(推荐使用);
2. 通过监听 SetLayerEvent.PROCESS_COMPLETE 事件获取。

参数

parameters:SetLayerStatusParameters — 子图层显示控制参数。
 
responder:IResponder (default = null) — 由 AsyncResponder 类实现异步处理,获取子图层可视状态。远程或异步请求服务完成时将调用的处理函数。使用方法为
AsyncResponder(result:Function, fault:Function, token:Object = null)
result:Function — 成功完成请求时应调用的函数。必须具有以下签名:
public function (result:SetLayerResult, 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.SetLayerEvent

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