简单介绍信Flex与Web服务的交互

时间：2010-07-18 来源：yiranwuqing

简单介绍信Flex与Web服务的交互

主要内容:

       1.ActionScript与服务端的基本交互方式(REST).

       2.ActionScript特有的数据传输格式(AMF)与服务器交互.

       3.Flex与WebService.

要实现ActionScript与服务端交互, 首先必须知道以下几个类:

       URLRequest类

       记录请求服务端的URL信息, 给URLLoader进行发送操作.

      URLVariables类

       保存向服务端请求所需的参数, 一般用于POST方式传输,GET方式传输不需要使用.

       URLRequestMethod类

       该类只有两个静态常量值, 一个是POST, 一个是GET, 可以把它当作是一个枚举类型, 用于指定URL请求时使用POST方式或是GET方式.

       URLLoader类

       真正与服务端打交道的类, 通过load方法把一个Reuqest发送给服务端, 在load之前必须给该对象添加一个Complete事件的监听器,接收服务器返回的信息. 传输过程中有可能产生IO错误, 有必要时可以为该对象添加IOError监听器.

例子:

var request: URLRequest = new URLRequest("http://localhost");

//默认为URLRequestMethod.GET, 若使用GET方式可以不指定

request.method = URLRequestMethod.POST;

//创建一个参数变量对象,用于保存所有向服务发送的参数数据, GET方式可以不使用

var vars: URLVariables = new URLVariables ();

vars["varName"] = varValue; //把参数键,值对放到vars对象中.

vars["var2Name"] = var2Value;

request.data = vars;        //把参数对象放进Request对象中作为参数

// 通过request对象创建一个loader,

var loader: URLLoader = new URLLoader(request);

loader.addEventListener(       //给loader对象添加完成时的监听器.

       Event.COMPLETE,

       function(e: Event):void         //临时定义一个监听器

       {

              //服务端返回的数据是保存在loader的data里,通过以下语句可以得到

              trace(URLLoader(e.target).data );//在监听器里处理服务端返回的数据

              //complete

              // process the data;

       }

);

loader.addEventListener(       //IOError监听器

       IOErrorEvent.IO_ERROR,

       //临时监听器,IO错误的处理在该函数中处理

       function(e: IOErrorEvent): void {/* process the err;*/}

);

loader.load(request);//把request对象发送到服务端.当请求完成,则会自动触发COMPLETE事件

REST实例演示

通过AMF数据格式与服务器交互

什么是AMF?

       AMF是Adobe公司制定一套ActionScript与服务端交互的数据格式, Flex本身已经有相关的类可以直接使用,但服务端则需要一个可以解释该格式的包或框架, 幸运的时现在已经存在大部分服务端语言解释AMF格式包与类库, 所以不用担心处理该格式的问题.

通过AMF数据格式与服务器交互

怎样在Flex中使用AMF数据格式进行传输?

       在Flex中使用AMF需要通过以下几个类进行:

       RemoteObject类, 可以作为Flex中的一个控件使用.

       AsyncToken类, 保存一个请求的状态, 给请求添加监听器.

       AsyncResponder类, 用于设置请求的两种返回结果, 返回成功或失败

       ResultEvent类, 返回成功的事件对象, 返回的数据保存在该对象的result属性里.

       FaultEvent类, 返回失败的事件对象, 该对象保存请求失败的所有信息.

通过AMF数据格式与服务器交互

例子(后台采用django + pyAMF):

在Application的MXML文件里创建一个RemoteObject对象

<mx:RemoteObject id="djangoService" destination="myservice"

          showBusyCursor="true"/>

Flex编写以下代码：

//djangoService是面上创建一个RemoteObject对象, echo是服务端提供的一个无参数方法, 用于显示信息.

var token:AsyncToken=djangoService.echo();

//调用服务端的方法后返回一个Token对象

// 为Token添加成功与失败的监听器.

token.addResponder(new AsyncResponder(AfterEchoRet,falutHandler));

通过AMF数据格式与服务器交互

//定义成功与失败的监听器.

private function AfterEchoRet(result:ResultEvent):void{

       trace(result.result);

       //在这里处理返回的数据.数据保存于result属性中.

}

private function falutHandler(error:FaultEvent):void{

       trace(error.message);

}

程序代码就只有这么多, 不过还需要一个Services-config.xml配置文件.

还需要在工程属性里添加一个参数, 设置如下:

通过AMF数据格式与服务器交互

services-config.xml内容如下:

<?xml version="1.0" encoding="UTF-8"?>

<services-config>

   <services>

    <service id="ananasService" class="flex.messaging.services.RemotingService" messageTypes="flex.messaging.messages.RemotingMessage">

     <destination id="myservice">//需要对应pyAMF服务器上设定的destination 值,必须一致

         <channels><channel ref="ananasChannel"/></channels> //对应下面定义的Channel

                <properties><source>*</source></properties>

       </destination>

      </service>

    </services>

    <channels>

       <channel-definition id="ananasChannel" class="mx.messaging.channels.AMFChannel">

            <endpoint uri="http://192.168.28.97/pysite/hello/gateway/" class="flex.messaging.endpoints.AMFEndpoint"/> //设置服务器终端URL地址

        </channel-definition>

    </channels>

</services-config>

RemoteObject的介绍：

view plaincopy to clipboardprint?

   1. <mx:RemoteObject> 标签使您可以访问使用 Action Message Format (AMF) 编码的 Java 对象的方法。
   2.
   3. MXML 语法显示 MXML 语法
   4. 隐藏 MXML 语法
   5. The <mx:RemoteObject> tag accepts the following tag attributes:
   6.
   7. <mx:RemoteObject
   8.   Properties
   9.   concurrency="multiple|single|last"
10.   destination="No default."
11.   id="No default."
12.   endpoint="No default."
13.   showBusyCursor="false|true"
14.   source="No default." (currently, Adobe ColdFusion only)
15.   makeObjectsBindable="false|true"
16.
17.   Events
18.   fault="No default."
19.   result="No default."
20. />
21.
22. <mx:RemoteObject> can have multiple <mx:method> tags, which have the following tag attributes:
23.
24. <mx:method
25.   Properties
26.   concurrency="multiple|single|last"
27.   name="No default, required."
28.   makeObjectsBindable="false|true"
29.
30. Events
31.   fault="No default."
32.   result="No default."
33. />
34. It then can have a single <mx:arguments> child tag which is an array of objects that is passed in order.
35.
36. endpoint 属性
37.
38. endpoint:String [读写]
39.
40.
41. 此属性可使开发人员在编译或以编程方式创建 ChannelSet 时快速指定 RemoteObject 目标的端点，而无需引用服务配置文件。如果已经为 RemoteObject 服务设置了 ChannelSet，它也可以覆盖现有的 ChannelSet。
42.
43. 如果端点 url 以“https”开头，将使用 SecureAMFChannel；否则将使用 AMFChannel。可以在端点 url 中使用 {server.name} 和 {server.port} 这两个特殊标记，以指定通道应使用用来加载 SWF 的服务器名称和端口。
44.
45. 注意：当创建 AIR 应用程序时该属性是必需的。
46.
47.
48.
49.
50. 实现
51.     public function get endpoint():String
52.     public function set endpoint(value:String):void
53.
54. showBusyCursor 属性
55.
56. showBusyCursor:Boolean [读写]
57.
58.
59. 如果为 true，在执行服务时会显示忙碌光标。默认值为 false。
60.
61.
62.
63. 实现
64.     public function get showBusyCursor():Boolean
65.     public function set showBusyCursor(value:Boolean):void

<mx:RemoteObject> 标签使您可以访问使用 Action Message Format (AMF) 编码的 Java 对象的方法。 MXML 语法显示 MXML 语法隐藏 MXML 语法 The <mx:RemoteObject> tag accepts the following tag attributes: <mx:RemoteObject Properties concurrency="multiple|single|last" destination="No default." id="No default." endpoint="No default." showBusyCursor="false|true" source="No default." (currently, Adobe ColdFusion only) makeObjectsBindable="false|true" Events fault="No default." result="No default." /> <mx:RemoteObject> can have multiple <mx:method> tags, which have the following tag attributes: <mx:method Properties concurrency="multiple|single|last" name="No default, required." makeObjectsBindable="false|true" Events fault="No default." result="No default." /> It then can have a single <mx:arguments> child tag which is an array of objects that is passed in order. endpoint 属性 endpoint:String [读写] 此属性可使开发人员在编译或以编程方式创建 ChannelSet 时快速指定 RemoteObject 目标的端点，而无需引用服务配置文件。如果已经为 RemoteObject 服务设置了 ChannelSet，它也可以覆盖现有的 ChannelSet。如果端点 url 以“https”开头，将使用 SecureAMFChannel；否则将使用 AMFChannel。可以在端点 url 中使用 {server.name} 和 {server.port} 这两个特殊标记，以指定通道应使用用来加载 SWF 的服务器名称和端口。注意：当创建 AIR 应用程序时该属性是必需的。实现 public function get endpoint():String public function set endpoint(value:String):void showBusyCursor 属性 showBusyCursor:Boolean [读写] 如果为 true，在执行服务时会显示忙碌光标。默认值为 false。实现 public function get showBusyCursor():Boolean public function set showBusyCursor(value:Boolean):void

一个简单的使用：

view plaincopy to clipboardprint?

   1. <?xml version="1.0" encoding="utf-8"?>
   2. <mx:Canvas xmlns:mx="http://www.adobe.com/2006/mxml" implements="laxino.slot.controller.network.IMessageSenderSlot">
   3.     <mx:Script>
   4.         
32.     </mx:Script>
33.
34.     <mx:RemoteObject id="ams_player_transaction" source="PlayerTransactionHistories" destination="rubyamf">
35.         <mx:method name="fund_in_for_play_game"/>
36.         
37.         <mx:method name="show_transaction_state"/>
38.         
39.     </mx:RemoteObject>
40. </mx:Canvas>

<?xml version="1.0" encoding="utf-8"?> <mx:Canvas xmlns:mx="http://www.adobe.com/2006/mxml" implements="laxino.slot.controller.network.IMessageSenderSlot"> <mx:Script>  </mx:Script> <mx:RemoteObject id="ams_player_transaction" source="PlayerTransactionHistories" destination="rubyamf"> <mx:method name="fund_in_for_play_game"/>  <mx:method name="show_transaction_state"/>  </mx:RemoteObject> </mx:Canvas>

Flex与WebService

u WSDL（Web Service Description Language）Web服务器描述语言是用XML文档来描述Web服务的标准，是Web服务的接口定义语言，通过WSDL，可描述Web服务的三个基本属性：

              ·服务做些什么——服务所提供的操作（方法）

              ·如何访问服务——和服务交互的数据格式以及必要协议

              ·服务位于何处——协议相关的地址，如URL

u Flex本身就拥有支持WebService的类, 常用的是: WebService类,该类已经可以实现对服务端提供的WebService的WSDL数据进行相应的操作.

Flex与WebService

       Flex framework 包含mx.rpc.soap.WebService，该类可调用web services方法，首先创建WebService

       对象，如下：

var webService:WebService = new WebService( );

       每个web service都有一个Web服务描述语言(WSDL)，通过WebService对象的wsdl属性进行定位：

webService.wsdl = "http://www.rightactionscript.com/webservices/FlashSurvey.php?wsdl";



       在调用方法之前，必须先用loadWSDL( ) 方法读取wsdl数据：

webService.loadWSDL( );

       loadWSDL( ) 方法是异步调用的，因此需要监听是否WSDL数据已经读取完毕，当数据读取完成

       时WebService 对象会发出mx.rpc.soap.LoadEvent 事件，如：

webService.addEventListener(LoadEvent.LOAD, onWSDL);

       当WSDL数据读取后，就可以调用WebService对象方法了，WSDL URL 指向真实的web service ，其有个方法叫getAverages( ) ：

webService.getAverages( );

Flex与WebService

处理返回结果

       Web services 方法的类型实际上是mx.rpc.soap.Operation，当web services 方法返回值时，方法对象会发出mx.rpc.events.ResultEvent 事件，要想处理这个事件可注册监听器，例如，webService有个方法叫getAverages( )，可这样注册监听器：

webService.getAverages.addEventListener(ResultEvent.RESULT, onGetAverages);

       调用写法和其他方法一样：

webService.getAverages( );

       当进入处理函数时，会传进来一个ResultEvent 参数，ResultEvent 类定义了一个叫result 的属性，它包含返回值，因为getAverages( ) 方法返回一个关联数组，包含两个属性：flash 和actionscript：

private function onGetAverages(event:ResultEvent):void {

       textArea.text = "The averages for Flash and ActionScript are " +

              event.result.flash + " and " + event.result.actionscript;

}

处理异常

       当web services 引发异常时，方法会发出fault事件，类型为mx.rpc.events.FaultEvent，下面的代码注册了fault 事件处理函数：

webService.addEventListener(FaultEvent.FAULT, onWebServiceFault);

       FaultEvent 类定义了一个fault属性，类型为mx.rpc.Fault. Fault 对象返回有关异常的信息，包含如faultCode, faultDetail, faultString, 和rootCause 属性，下面的例子用Alert 显示异常信息：

private onWebServiceFault(event:FaultEvent):void {

var fault:Fault = FaultEvent.fault;

var message:String = "An error occurred. The details are as follows\ncode: " + fault.faultCode;

message += "\ndetail: " + faul.faultDetail;

Alert.show("Web Service Error", message);

}