Flex与.NET互操作(十四)：FluorineFx的AMF协议通信
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接收了。
/******************服务端方法***********************/
[DataTableType("Book", "FxDotNet.Services.DTO.Book")]
public DataTable GetBookTable()
{
DataTable dt = new DataTable("Book");
dt.Columns.Add("ID", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Columns.Add("Author", typeof(string));
dt.Columns.Add("Price", typeof(double));
DataRow dr = dt.NewRow();
dr["ID"] = 1;
dr["Name"] = "《三国演义》";
dr["Author"] = "罗贯中";
dr["Price"] = 100.00;
dt.Rows.Add(dr);
dr = dt.NewRow();
dr["ID"] = 2;
dr["Name"] = "《西游记》";
dr["Author"] = "吴承恩";
dr["Price"] = 200.00;
dt.Rows.Add(dr);
dr = dt.NewRow();
dr["ID"] = 3;
dr["Name"] = "《水浒传》";
dr["Author"] = "施耐庵";
dr["Price"] = 300.00;
dt.Rows.Add(dr);
dr = dt.NewRow();
dr["ID"] = 4;
dr["Name"] = "《红楼梦》";
dr["Author"] = "曹雪芹";
dr["Price"] = 400.00;
dt.Rows.Add(dr);
return dt;
}
/******************客户端方法***********************/
private function onResult(result:ArrayCollection):void
{
//do other
}
关于FluorineFx的AMF就简单介绍这些，要想了解更多的Flex客户端与.NET服务器端通信，可以访问 这里 。
本文示例代码下载 FluorineFxAMF.rar