Remote Object Service

Remote Object Service

Remote Object Service
对于主流的Flex数据服务器，目前都支持AMF3/RemoteObject，今天我们就来谈一谈BlazeDS的远程服务。

1. 编写远程服务类

编写BlazeDS的Java远程服务类有三个要求：

1) 所有被调用的方法必须是public；

2) 所有的编译类必须能够通过BlazeDS的classpath访问得到；

3) 类必须是stateful/stateless的。

大家可以参考工程文件中的SimpleService.java。

2. 配置remoting-config.xml

Java服务类写好后，还需要配置，BlazeDS的Remote Service也是在服务器端对应了一个配置文件：remoting-config.xml，配置好Remote Service 后，Flex在运行时才能找到相应的服务类并调用其方法。下面就是本工程的Remote Service配置文件。

第2~3行指定服务的ID和对应的类，第5~7行设置适配器(adapters)的ID和对应的类。第9~11行指定默认的通道(channels)及其参照，该通道是在 services-config.xml中定义的。适配器和通道可以设置多个，采用第一个优先的原则。前面这几项设置适用于proxy-config.xml、remoting-config.xml和我们后面要讲的 messaging-config.xml。

第13~18行设置的服务终端(destination)，该属性必须和RemoteObject组件的服务终端属性一致。按照服务的种类，服务终端又可以分为代理服务终端、远程服务终端和消息服务终端。上一次讲述的代理服务终端，需要指定该终端的url，而这次我们讲述的远程服务终端，需要指定该目标的source和scope。source对应 RemoteObject要调用的远程服务的全限定类名，不像FluorineFX，它不能在RemoteObject组件中指定。scope表示当前远程服务的作用范围，即远程服务类是stateful还是stateless，有application、session和request三个选项。

注意：我们提倡在配置文件中设置，这样更安全也方便后期维护。

3. 使用RemoteObjec组件

对于RemoteObjec组件，请参看
下面的Flex RemoteObject类参考相关内容。一句话，Flex的RemoteObject与后台语言是无关的。在工程文件中的BasicRemoteObject.mxml，调用了SimpleService类的三个方法，当通过BlazeDS从J2EE服务器返回RemoteObjec时，Java数据被序列化成ActionScript数据。其中Java字符串对应ActionScript字符串，Java的数组列表对应ActionScript ArrayCollection。

Flex RemoteObject类参考

<mx:RemoteObject>标记允许使用AMF3访问远程服务类的方法，要知道在Flex中怎样使用Flash Remoting访问数据，应该先了解一下RemoteObject类。

要知道在Flex中怎样使用Flash Remoting访问数据，应该先了解一下RemoteObject类。

包 mx.rpc.remoting 类 public dynamic class RemoteObject 
继承 RemoteObject → AbstractService → Proxy → Object 
子类 RemoteObject

一、<mx:RemoteObject>标记

它允许使用AMF3访问远程服务类的方法。

1. <mx:RemoteObject>允许的标记属性有：

< mx:RemoteObject
  Properties
  concurrency = "multiple|single|last"
  destination = "No default."
  id = "No default."
  endpoint = "No default."
  showBusyCursor = "false|true"
  source = "No default." (currently, Macromedia ColdFusion only)
  makeObjectsBindable = "false|true"
  事件
  fault = "No default."
  result = "No default."
 />

2. <mx:RemoteObject>标记可以包含多个 <mx:method> 标记，<mx:method>允许的标记属性有：

< mx:method
  Properties
  concurrency = "multiple|single|last"
  name = "No default, required."
  makeObjectsBindable = "false|true"
 事件
  fault = "No default."
  result = "No default."
 />

3. <mx:RemoteObject>标记可以也只能包含一个<mx:arguments> 子标记，该子标记是一个序列数组对象。

二、公有属性

1. concurrency : String

表示对同一服务怎样进行多次调用。类似于XMLConnector/WebServiceConnector/RemotingConnector的multipleSimultaneousAllowed属性。它的默认值为multiple，允许下列值:

• Multiple：同一时间可以执行多个请求。已有的请求不会被取消；
• Single：同一时间调用只能执行一个请求，多个请求会报错；
• Last：最后一次请求会覆盖已有的请求。

2. endpoint: String

允许开发人员快速为RemoteObject destination(目标)指定endpoint(端点)。而该destination既没有在编译时，也没有在用代码新建ChannelSet(通道集)时参照services-config.xml。如果设定了该属性，它会覆盖已有的ChannelSet。

如果endpoint 的url 以“https”开关，将使用 SecureAMFChannel, 否则使用普通的AMFChannel。{server.name}和{server.port}标记,可以用在endpoint的url中，表明Channel应该使用用来加载SWF文件的服务名称和端口。

3. showBusyCursor:Boolean

表示服务正在执行时是否显示一个表示忙碌的鼠标指针。

三、公有方法

1. RemoteObject () 构造方法

创建一个新的RemoteObject对象。

参数

destination:String (默认为 null) —RemoteObject 的destination属性必须匹配 services-config.xml 中的destination的ID属性值。

2. initialized ()

public function initialized(document:Object, id:String):void

只要设定RemoteObject标记就会通过MXML编译器自动调用该方法。如果使用ActionScrip新建RemoteObject实例，则可以自行调用该方法，这对验证其参数很有用。

参数

• document:Object —RemoteObject 所在的MXML文档
• id:String —RemoteObjec在上述文档中的ID