使用BlazeDS进行Java和纯actionscript项目通信

Kanglai Qian 4月 07, 2012

前段时间在帮着做一个网络模块，背景是一个actionscript的项目和后台服务器进行数据交换。最后选择了BlazeDS的解决方案，使用HTTP封装的AMF协议进行通信。交换的数据中有各种数组和自定义类，blazeDS基本上都能自动序列化和反序列化，因此用的比较舒服。但一开始配置环境的时候遇到了各种奇怪的问题，特别有一个问题网上搜索只有在一个post里提到，因此很值得记录。

搭建BlazeDS服务器

因为BlazeDS实质上是tomcat webapp，因此我用的是Eclipse+Web Tools Platform搭建的服务器。建立Dynamic Web Project之后，将blazeds.war里面的META-INF和WEB-INF解压到WebContent里面，就完成了服务器的初步搭建(so easy~)。在Eclipse里面用Run on Server，接下来一系列常规设置tomcat就行了。

在FlashBuilder中，我一开始是选择的Flex项目进行测试(因为纯actionscript项目使用BlazeDS会麻烦非常多，容后再表)。在建立项目的时候可以选择服务器技术-BlazeDS:

提示说“无法访问 Web 服务器。服务器可能没有运行，或者 Web 根文件夹或根 URL 可能无效”，但实际上是已经在Eclipse里面运行了服务器。这就是我纠结的第一个问题。

后来发现，Eclipse WTP在默认部署的时候，是将网站部署到workspace metadata文件夹；Flex在验证服务器的时候，很有可能是在文件夹里添加某些内容然后尝试远程访问——这个很像Google site这样上传随机文件的样子。然而用过的人都知道，WTP在刷新服务器内容的时候是有时间差的(譬如修改了代码，会提示同步中…)，这就是问题所在。最后我通过将网站部署位置修改到tomcat文件夹下来解决:

修改默认tomcat部署位置

通常情况下，会发现这些内容都是灰色的！我是通过删除tomcat服务器下的网站，清理之后重新打开，就如下图所示，可以修改了

将部署位置修改以后，FlashBuilder表示能正常连上了~

具体怎么使用BlazeDS服务器:修改配置文件、编写自定义类之类的，都比较简单，查阅官方文档就行了。比较简单的就搞定了Flex与Java之前的互相通信。

纯ActionScript项目使用BlazeDS

网上绝大部分(包括教程)都是如何使用Flex项目进行数据通信，ActionScript版本的很难找到。这一部分我纠结了特别长的时间，主要遇到了以下几个问题，在这里分享一下。

导入mx.rpc.*等

默认的AS项目比Flex项目少引用了不少东西，这里需要手动加上:framework.swc, rpc.swc。但是在加上framework.swc之后，还遇到了“无法为区域设置zh_CN解析资源束xxx解决方法”一串错误：在actionscript构建路径-库路径中，将C:\Program Files (x86)\Adobe\Adobe Flash Builder 4.6\sdks\4.6.0\frameworks\locale\zh_CN作为swc文件夹导入。

不使用services-config.xml配置

在Flex中，通过指定services-config.xml(本质是在编译的时候加上-services标签)，可以很方便的使用

<mx:RemoteObject id="helloRemoteObject" destination="helloWorld" fault="faultHandler(event)" result="resultHandler(event)">;

但是在Actionscrpit项目中，我指定xml编译一直不能成功使用。后来我自己使用AS3代码实现了等价的功能

var ro:RemoteObject = new RemoteObject();
var cs:ChannelSet = new ChannelSet(); 
cs.addChannel(new AMFChannel("my-amf", "http://localhost:8080/Ninja/messagebroker/amf"));
ro.channelSet = cs;
ro.destination = "ninja"; 

ro.addEventListener(ResultEvent.RESULT,r1);
ro.addEventListener(FaultEvent.FAULT,r2);

ro.sayHello();

这个就相当于调用远程对象的sayHello方法。

Error #1034

TypeError: Error #1034: Type Coercion failed: cannot convert Object@13e9921 to mx.messaging.messages.ErrorMessage.

这个问题是最值得记录的问题，也是我遇到的最关键的问题。最后在StackOverflow找到了答案：没有绑定。反正当时在网上搜了很久，都只有这一个地方找到。

Flex的.mxml文件本质上会编译出一堆.as文件(通过编译器指令-keep-generated-actionscript=true)，对比发现有这样一句初始化命令flash.net.registerClassAlias()

public static function registerClassAliases():void
{
    // Flex classes
    registerClassAlias("flex.messaging.io.ArrayCollection", ArrayCollection);
    registerClassAlias("flex.messaging.io.ArrayList", ArrayList);
    registerClassAlias("flex.messaging.io.ObjectProxy", ObjectProxy);
    
    // rpc classes
    registerClassAlias("flex.messaging.messages.AcknowledgeMessage", AcknowledgeMessage);
    registerClassAlias("DSK", AcknowledgeMessageExt);
    registerClassAlias("flex.messaging.messages.AsyncMessage", AsyncMessage);
    registerClassAlias("DSA", AsyncMessageExt);
    registerClassAlias("flex.messaging.messages.CommandMessage", CommandMessage);
    registerClassAlias("DSC", CommandMessageExt);
    registerClassAlias("flex.messaging.config.ConfigMap", ConfigMap);
    registerClassAlias("flex.messaging.messages.ErrorMessage", ErrorMessage);
    registerClassAlias("flex.messaging.messages.HTTPMessage", HTTPRequestMessage);
    registerClassAlias("flex.messaging.messages.MessagePerformanceInfo", MessagePerformanceInfo);
    registerClassAlias("flex.messaging.messages.RemotingMessage", RemotingMessage);
    registerClassAlias("flex.messaging.messages.SOAPMessage", SOAPMessage);
}

这些语句的意思是说，将本地的as类和远程的java类对应起来(诸如flex.messaging.messages.*都在blazeds.war里面的jar中实现了)。这样在Flex-Java通信的时候，就知道序列化和反序列化对应的是什么类了。

我估计是没有初始化的情况下，返回的基本类型(我当时是返回了一个String)不知道如何反序列化这样的情况。

所谓`[RemoteClass(alias=)]`标签

除了基本的一些类型和数组之外，AMF协议可以进行自定义类的序列化。但是需要在AS代码中进行绑定，例如

[Bindable]
[RemoteClass(alias="me.qiankanglai.test")]
public class Test
{
    public var t:String="";
}

但是，一如既往的，在actionscript中使用不能。最后发现这个问题和上个问题类似——对比.mxml生成的.as代码可以发现，这个metadata其实就是这句话

registerClassAlias("me.qiankanglai.test",Test);

自此问题解决~

ps.当时做的时候还在纠结要不要用node.js+websocket，或者说AMF+socket的架构。最后出于开发风险和现有要求的考虑，用了HTTP+AMF的架构实现，估计问题也不大。

ps2.看了Zynga通信框架，感觉蛋定了好多！话说云服务真是个好东西啊。