按照手册内容,这里给出两个客户端和服务端示例代码,你可以编译、部署到BlazeDS服务器中进行体验,我使用的编辑器是Eclipse 3.4 + Flex Builder Plunin 3.0.1,BlazeDS使用的二进制包,服务器是Tomcat 6.0.18,而构建一个BlazeDS应用程序的一般流程如下:
1、在WEB-INF/flex目录下的配置文件(一般为remoting-config.xml)中配置一个目的(destination),用他来进行客户端和服务端数据交换;
2、在WEB-INF/flex目录下的配置文件(services-config.xml)中配置一个通道(channel),用它来封装数据以进行数据的网络传送;
3、用MXML或者ActionScript编写Flex客户端;
4、将客户端程序编译为SWF文件,并将它部署在BlazeDS服务器中。
一、RPC服务例子
Remoting Service是BlazeDS服务器中RPC服务的一种,它能够让客户端访问服务端POJOs的方法。在这个例子中,首先在服务端部署一个Java类:EchoService,用来返回客户端发送过来的字符串,具体代码如下:
package remoting; public class EchoService { public String echo(String text) { return "Server says: I received '" + text + "' from you"; } }
echo()方法带有一个字符串的参数,并将它与另外一些字符串组合后返回。将该文件编译,把生成的EchoService.class文件拷贝到WEB-INF/classes/remoting目录下。
接下来,在WEB-INF/flex/remoting-config.xml文件中定义目的,代码如下:
<destination id="echoSericeDest" channels="my-amf"> <properties> <source>remoting.EchoService</source> </properties> </destination>
source定义了目的相对应的具体Java类,而channels定义了该目的使用的通道,而通道的定义则在WEB/flex/services-config.xml文件中定义,具体如下:
<channel-definition id="my-amf" class="mx.messaging.channels.AMFChannel"> <endpoint url="http://{server.name}:{server.port}/{context.root}/messagebroker/amf" class="flex.messaging.endpoints.AMFEndpoint" /> <properties> <polling-enabled>false</polling-enabled> <properties> </channel-definition>
服务端的工作完成了,如果使用的是BlazeDS的二进制版本(blazeds.war),在Flex Builder环境下,其中通道的定义默认就完成了,而在目的的定义中,存在一个默认的通道配置(default-channels),所以,在定义目的的时候如果是使用的默认通道配置也可以省略通道。
客户端编码主要就是Flex的开发,用到的控件主要就是RemoteObject,在该示例中就是很简单的在文本框中显示返回的结果,代码如下:
<?xml version="1.0" encoding="utf-8"?> <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" width="100%" height="100%"> <mx:Script> <![CDATA[ import mx.rpc.events.FaultEvent; import mx.rpc.events.ResultEvent; private function resultHandle(event:ResultEvent):void { ta.text += "Server responded: " + event.result + "\n"; } private function faultHandle(event:FaultEvent):void { ta.text += "Received fault: " + event.fault + "\n"; } private function echo():void { var text:String = ti.text; ro.echo(text); } ]]> </mx:Script> <mx:RemoteObject id="ro" destination="echoServiceDest" result="resultHandle(event);" fault="faultHandle(event);" /> <mx:Label text="Enter a text fro the server to echo" /> <mx:TextInput id="ti" text="Hello world!" /> <mx:Button label="Send" click="echo();" /> <mx:TextArea id="ta" width="100%" height="100%" /> </mx:Application>
将该文件编译成SWF文件,然后部署到BlazeDS服务器中,启动Tomcat服务器,在浏览器中浏览该文件,将会看到运行的结果,如下图。
整个代码请点击下载(解压后拷贝rpc目录到Tomcat的webapps目录下):RPC服务例子
另一个示例看下一篇文章:消息服务示例。