flex4 RemoteObject 的用法详解

访问远程Java对象

为了实现对远程Java对象的访问,在服务器端,需要完成如下几个 步骤:

1.      创建LiveCycle Data Service Web应用;

2.      实现POJO Java类;

3.      在LiveCycle Data Service Web应用中部署POJO Java类;

4.      配置remote-config.xml文件,声明desination节点,指向POJO Java类。

在客户端应用中,需要实现:

1.      实例化RemoteObject对象,并设定destination等属性;

2.      调用远程Java对象的方法,并传递参数;

3.      注册RemoteObject对象的result和fault事件侦听器,实现侦听器方法以处理返回响应或者调用异常。

我 们已经在第17章的17.5.1节“创建服务器端 LiveCycle Data Service应用”(见第416页)中介绍过如何创建LiveCycle Data Service Web应用。因此,我们这里将从实现POJO Java类开始逐步实现访问远程Java对象。

服务器端:实现POJO Java类

使用POJO类作为远程Java对象

我们当然不会在一本Flex书籍中讲解如何编写POJO Java类。我们须要在这里解释一下可以作为远程Java对象的Java类。

只 有所谓的POJO类能够作为远程Java对象。 POJO(Plain Old Java Object)简称为简单Java对象,通常包含了一系列get和set方法。通常所说的POJO Java类就是纯的Java对象,不实现任何Java对象模型、协议及框架,例如不能实现EJB标准。严格地说,POJO类不能继承其他父类,不能实现接 口。LiveCycle Data Service要求,作为LiveCycle Data Service远程服务的远程Java对象,其构造器不能接受任何参数,也就是说必须为零参数构造器。这样,LiveCycle Data Service才能够构造POJO类实例。

然而,POJO类仍然可以作为后端业务逻辑服务的窗口,例如使用 POJO类访问JNDI,获取EJB服务等,以便进一步集成后端业务逻辑。

POJO Java类的公共方法提供了远程服务。需要注意的是,LiveCycle Data Service保留了一些方法名,因此POJO Java类不能使用这些方法名,我们称这些方法为“保留方法”。保留方法是RemoteObject类或其父类定义的方法。

保留方法包括:

·       addHeader();

·       addProperty();

·       clearUsernamePassword();

·       deleteHeader();

·       hasOwnProperty();

·       isPropertyEnumerable();

·       isPrototypeOf();

·       registerClass();

·       setUsernamePassword();

·       toLocaleString();

·       toString();

·       unwatch();

·       valueOf();

·       watch()。

此外,作为远程对象的POJO Java类也不能使用“_”作为远程服务方法名的起始字母。

服务器端:部署POJO Java类

在我们使用HTTPService组件和WebService组 件,通过HTTPProxyService服务访问远程HTTP服务和Web服务时,远程服务并不一定要部署在LiveCycle Data Service服务器上。

而调用远程Java对象,则与这种情况大不相同。提供远程服务的 Java类必须与Flex应用部署在同一LiveCycle Data Service的Web应用中。

部署POJO Java类的唯一目的就是当客户端RemoteObject组件向LiveCycle Data Service发出访问请求时,LiveCylce Data Service能够找到对应的Java类。

因 此,我们须要把POJO Java类部署到LiveCycle Data Service的类路径中。我们可以直接将POJO Java类文件(.class文件)按照类包结构部署到Web应用的WEB-INF\classes目录下,或者将POJO Java类打包为Jar包(.jar文件),部署在WEB-INF\lib目录中。

 服务器端:配置remote-config.xml

原始remote-config.xml文件

lcds-root/webapps/ lcds目录中包含了空的remote-config.xml文件。我们先来看看原始的remote-config.xml文件。

请参考图19-2,该图展示了原始的remote- config.xml文件,并对主要节点做了注释。


图19-2  尚未配置目标的remote-config.xml

配置远程服务目标

在标 签内,添加< /destination>标签来声明新的远程对象目标。

下面的代码显示了包含一个destination定义的 remote-config.xml文件:



    
        
    
    
        
    
 
    
        
            com.mark.pojo.shoppingCart
            session
        
    

destination节点的source属性说明了远程对象 服务的目标,也就是远程Java对象。在设定source属性时,必须使用全路径java类名称来指向部署在LiveCycle Data Service类路径中的Java类。

desitnation节点的scrop属性的可选值为 application、session和request,指定了远程对象实例作用域。

如果作用域为request,那么服务器会为每一次请求都创建一个 远程Java对象实例,request是默认的作用域。

如 果作用域是session,服务器则为每一个会话创建一个共享的 远程Java对象实例。通常来说,连接服务器的每一个浏览器实例构成了一个会话。例如,如果我们启动Firefox来访问连接LiveCycle Data Service的Flex应用,启动的Firefox就是一个浏览器实例。在该Firefox浏览器中,如果打开其他标签页也访问同一Flex应用,那么 这些应用就处于同一会话中,共享同一远程对象实例。

如果作用域是application,那么服务器则为每一个 Flex应用创建一个远程的Java对象实例。

限制远程Java对象可访问方法

有 些时候,远程Java对象定义了许多公共方法,但是我们也许并不 希望这些方法都开放给Flex应用。在这种情况下,可以通过include-methods属性定义允许访问的方法列表,如果Flex应用试图访问该列表 外的方法就会导致异常,在客户端会调用fault事件。

include- methods属性位于destination节 点的内。下面的设定只允许Flex客户端访问shoppingCart类的 purchaseItem和deleteItem方法。


        
            com.mark.pojo.shoppingCart
            session
            
                
                
            
        
    

如 果你只想限制对某几个公共方法的远程访问,使 用属性会更加方便。下面的配置设定了Flex客户端可以访问shoppingCart类中除了purchaseItem方法之外的其 他公共方法。

        
            com.mark.pojo.shoppingCart
            session
            
                
            
        
    

 客户端:实例化RemoteObject组件对象

创建RemoteObject组件对象的MXML标签语法如下:

id属性指定了RemoteObject组件实例名称,在接下来调 用该服务对象及处理远程服务响应时使用。destination属性指定了要连接的远程服务的目标,该值必须与服务器端remote- config.xml文件中配置的目标id属性相匹配。

我们也可以使用ActionScript代码来创建 RemoteObject对象:

var remoteObj:RemoteObject = new RemoteObject();

remoteObj.destination = "shoppingCart";

 客户端:调用远程Java对象方法

使用RemoteObject组件最终访问的是远程Java对象公 开的公共方法。调用远程Java对象方法的最简单方式即直接调用方法名:

remoteObj.methodName(parm1,parm2,…);

在 MXML标签中,我们可以在用户事件中直接使用这种方式调用远程 服务。例如,如下代码实现了当用户点击“购物”按钮时,调用remoteObj.purchase(‘TV’)。(假定我们配置的远程Java对象开放了 公共方法purchase(String product))。

在 本章“服务器端:实现并部署POJO Java类”节中,我们介绍过,远程Java对象应该避免使用保留方法名。然而,如果由于不可避免的原因你不得不这样做,例如你的远程Java对象开发者 是个“disconnect”方法名的偏执狂,那么使用RemoteObject类的getOperation方法可以缓解你的尴尬。

public function getOperation(name:String):Operation

例如,远程Java对象开放了公共方法toString(),我们 可以通过如下代码创建Operation对象来调用该方法:

public var remoteObj:RemoteObject = new RemoteObject();

remoteObj.destination = "shoppingCart";

//创建代表toString方法的操作对象

public var oper:Operation = remoteObj.getOperation("toString");

//调用该方法

oper.send();

客户端:处理响应和异常

RemoteObject 使用异步方式调用远程Java对象。在调 用操作后,Flex应用并不停止执行其他操作来等待响应,而是允许用户继续交互,执行其他操作。当响应返回时,或者抛出异常时,系统调度result事件 或者fault事件来通知应用,以执行事件侦听器方法。也就是说,我们通过侦听RemoteObject组件的result和fault事件处理响应和异 常。这种方式与处理远程HTTP服务和Web服务响应的方式如出一辙。

当RemoteObject调用远程方法成功时,系统会调度 result事件。开发者可以使用result事件生成的mx.rpc.events.ResultEvent对象访问服务响应数据。

如下所示,我们为RemoteObject对象实例添加 result事件和fault事件侦听器,并声明侦听器方法。

……


    

    
    
    
    

我们可以采用ResultEvent.result属性或远程服务 组件的Operation.lastResult属性两种方式获取返回数据。

与处理Web服务返回对象类似,对于复杂类型的返回数据,例如数组 或自定义对象,默认情况下,Flex会将数组类型数据封装为mx.collection.ArrayCollection,将自定义对象类型封装为 mx.utils.ObjectProxy。

如果远程对象调用失败,系统会触发fault事件,开发者可以为该 事件定义侦听器方法,使用fault事件生成的mx.rpc.events.FaultEvent对象处理异常。



使用处理多个方法

类似Web服务能够提供多个操作,远程Java对象也可以开放多个 公共方法,供RemoteObject组件调用。我们可以使用operation类或标签,为一个 RemoteObject组件调用多个远程方法。

使用这种方式还能够为处理不同方法的响应提供更多的选择,我们可以 为每一个方法定义专有的result和fault事件侦听器,而不是仅仅在RemoteObject组件对象上定义统一的侦听器。

假设我们定义了Java类shoppingCart,开放了公共方 法clearCart()、purchaseItem(String itemName,int quantity)、deleteItem(String itemName)等方法。

使用mx.rpc.remoting.Operation类

mx.rpc.remoting.Operation 类专门用于为 RemoteObject类指定远程对象的操作。Operation 是服务上的单个方法,可以通过在服务上调用同名函数,即RemoteObject.operationName()的方式,或者在服务上访问作为属性的 Operation 并调用 send() 方法来调用 Operation,比如RemoteObject.operation.send()。

使用标签

我们也可以使用标签为 RemoteObject组件定义多个方法。

标签必须内嵌 在标签对内,通过name属性指定匹配的远程Java 对象方法名称。开发者可以为每个method标签注册result和fault事件侦听器方法,来分别处理远程Java对象不同方法的响应或调用异常。

标签对中,可以嵌入标签指定传递给远程方法的参数。Flex不要求使用与远程Java对象方法参数名称完全相同 的名字来定义标签。但是,当调用多参的远程方法时,必须保证标签指定 的参数顺序与远程方法中的参数顺序相匹配。



    
    
        
            {comboItem.selectedItem.data}
        
    

    
        
            {comboItem.selectedItem.data}
            {txtQuantity.text}
        
    

由于我们已经在标签中定义了参 数,因此只须要使用无参数的send()方法实现调用。例如:

   


你可能感兴趣的:(flex)