Flex与.NET互操作(十四)：FluorineFx的AMF(Action Message Format)协议通信
AMF(Action Message Format)在开发Flash/Flex应用中使用频率是非常高的，相对普通的HTTP、WebService的SOAP等多种数据通信方式的效率更高，本文将结合FluorineFx来提供通信服务接口，在客户端通过Flex来访问，详细介绍基于FluorineFx的AMF(Action Message Format)协议通信中常用数据类型的使用方法。
AMF(Action Message Format)在开发Flash/Flex应用中使用频率是非常高的，相对普通的HTTP、WebService的SOAP等多种数据通信方式的效率更高，有人曾经做过这方面的测试，详细可以访问：http://xinsync.xju.edu.cn/index.php/archives/2162。本文将结合FluorineFx来提供通信服务接口，在客户端通过Flex来访问，简单的介绍下关于使用FluorineFx的AMF(Action Message Format)协议通信的用法。
首先建立一个FluorineFx服务库，并建立一个数据传输对象（DTO），为该对象添加[FluorineFx.TransferObject]表示该对象可以用作于FluorineFx的数据传输对象，这个对象将会在本文后面用到，如下代码块：
{
[FluorineFx.TransferObject]
public class Book
{
public int ID { get; set; }
public string Name { get; set; }
public string Author { get; set; }
public double Price { get; set; }
public Book()
{ }
public Book(int id, string name, string author, double price)
{
this.ID = id;
this.Name = name;
this.Author = author;
this.Price = price;
}
}
}
接下来就需要提供一个FluorineFx的远程服务（即标记有[RemotingService]的对象）,通过该服务提供对外访问的方法接口，如下代码块：
{
[RemotingService]
public class DataServices
{
public DataServices()
{
}
/// <summary>
/// 获取服务端的系统时间
/// </summary>
/// <returns></returns>
public string GetServerTime()
{
return DateTime.Now.ToString();
}
public ArrayCollection GetBooks()
{
ArrayCollection array = new ArrayCollection();
array.Add(new Book(1, "三国演义", "罗贯中", 100.00));
array.Add(new Book(2, "西游记", "吴承恩", 200.00));
array.Add(new Book(3, "水浒传", "施耐庵", 300.00));
array.Add(new Book(4, "红楼梦", "曹雪芹", 400.00));
return array;
}
}
}
通过FluorineFx网站来宿主该远程服务,通过Flex的配置文件services-config.xml配置远程访问的AMF连接通道。
<channel-definition id="my-amf" class="mx.messaging.channels.AMFChannel">
<endpoint uri="http://{server.name}:{server.port}/{context.root}/Gateway.aspx" class="flex.messaging.endpoints.AMFEndpoint"/>
<properties>
</properties>
</channel-definition>
</channels>
FluorineFx提供的远程服务(RemotingService),使用Flex、Flash或Silverlight开发的客户端都是可以访问的，要实现客户端的远程调用其实是很简单的，这里以Flex作为示例进行演示，设置通信协议为AMF3，然后直接调用当前连接到服务器端连接对象的call()方法就可以实现远程调用，详细请查看下面完整的Flex示例。
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" creationComplete="init()" fontSize="12">
<mx:Script>
<![CDATA[
import mx.collections.ArrayCollection;
import mx.controls.List;
import mx.rpc.events.FaultEvent;
import mx.rpc.events.ResultEvent;
private var nc:NetConnection;
private var rs:Responder;
private function init():void
{
nc = new NetConnection();
rs = new Responder(onResult,onStatus);
nc.objectEncoding = ObjectEncoding.AMF3;
nc.connect("http://localhost:2311/FxDotNet.Web/Gateway.aspx");
nc.client = this;
}
private function onResult(result:String):void
{
this.lbServerTime.text = "服务端系统时间为：" + result;
}
private function onStatus(event:Object):void
{
trace("Error");
}
private function getServerTime(event:MouseEvent):void
{
//服务器端所提供的RemotingService的全限定名
nc.call("FxDotNet.Services.DataServices.GetServerTime",rs);
}
]]>
</mx:Script>
<mx:Button x="19" y="28" label="获取服务器系统时间" click="getServerTime(event)"/>
<mx:Label x="19" y="60" width="402" id="lbServerTime"/>
</mx:Application>
同样可以使用AMF来做大数据的传输，比如要传递一个集合、数组、DataTable或是DataSet等，下面以集合做为示例演示，ActionScript 3.0中新增了ArrayCollectin类，FluorineFx在服务器端对ActionScript 3.0的ArrayCollection对进行了序列化映射封装，服务端FluorineFx.AMF3.ArrayCollection类型的对象可以直接被客户端的ArrayCollection所接收。
如上面FluorineFx所提供的远程服务接口中的GetBooks()方法，Flex调用此方法就会得到一个ArrayCollection对象，通过调试跟踪返回的数据可以很清楚的分析这些数据，如下图示：
详细请看下面的Flex完整示例代码：
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" fontSize="12"
width="541" height="302" creationComplete="init()">
<mx:Script>
<![CDATA[
import mx.collections.ArrayCollection;
import mx.controls.List;
import mx.rpc.events.FaultEvent;
import mx.rpc.events.ResultEvent;
private var nc:NetConnection;
private var rs:Responder;
private function init():void
{
nc = new NetConnection();
rs = new Responder(onResult,onFault);
nc.objectEncoding = ObjectEncoding.AMF3;
nc.connect("http://localhost:2311/FxDotNet.Web/Gateway.aspx");
nc.client = this;
}
private function getBook(event:MouseEvent):void
{
nc.call("FxDotNet.Services.DataServices.GetBooks",rs);
}
private function onResult(result:ArrayCollection):void
{
this.bookGrid.dataProvider = result;
}
private function onFault(event:Object):void
{
trace("Error");
}
]]>
</mx:Script>
<mx:Button x="44" y="46" label="获取图书信息" click="getBook(event)"/>
<mx:DataGrid x="44" y="78" id="bookGrid">
<mx:columns>
<mx:DataGridColumn headerText="编号" dataField="ID"/>
<mx:DataGridColumn headerText="书名" dataField="Name"/>
<mx:DataGridColumn headerText="作者" dataField="Author"/>
<mx:DataGridColumn headerText="价格" dataField="Price"/>
</mx:columns>
</mx:DataGrid>
</mx:Application>
除了使用FluorineFx所提供的ArrayCollection外，同样可以使用我们熟悉的Object[],List<Object>,DataTable等常用类型来作为数据返回的类型，其中Object[]和List<Object>类型的数据返回到客户段能够直接被客户端所接收，如下使用Object[]作数据返回类型的代码块：
public Book[] GetBookArray()
{
Book[] book = new Book[]
{
new Book(1, "三国演义", "罗贯中", 100.00),
new Book(2, "西游记", "吴承恩", 200.00),
new Book(3, "水浒传", "施耐庵", 300.00),
new Book(4, "红楼梦", "曹雪芹", 400.00)
};
return book;
}
/*************客户端方法*************/
private function onResult(result:Array):void
{
//
}
下面是以List<Object>类型返回的代码示例代码，客户段可以使用ArrayCollection直接接收：
/// <summary>
/// 以泛型类型返回给客户端
/// </summary>
/// <returns></returns>
public List<Book> GetBookList()
{
List<Book> list = new List<Book>
{
new Book(1, "三国演义", "罗贯中", 100.00),
new Book(2, "西游记", "吴承恩", 200.00),
new Book(3, "水浒传", "施耐庵", 300.00),
new Book(4, "红楼梦", "曹雪芹", 400.00)
};
return list;
}
/*************客户端方法*************/
private function onResult(result:ArrayCollection):void
{
//
}
如果要使用DataTable类型做方法的数据返回类型就需要注意下，服务器端直接返回DataTable类型的数据客户端是不能直接接收解析的，要使客户断方便解析所返回的DataTable类型数据，FluorineFx提供了DataTableTypeAttribute，为返回DataTable类型的方法加上DataTableTypeAttribute后返回给客户端，客户端就可以直接使用ArrayCollection接收了。
返回DataTable类型
关于FluorineFx的AMF就简单介绍这些，要想了解更多的Flex客户端与.NET服务器端通信，可以访问 这里 。
本文示例代码下载 FluorineFxAMF.rar
