访问远程Java对象 remoteObject

19.2 访问远程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对象。 19.2.1 服务器端：实现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类也不能使用“_”作为远程服务方法名的起始字母。 19.2.2 服务器端：部署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目录中。 19.2.3 服务器端：配置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定义的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 19.2.4 客户端：实例化RemoteObject组件对象创建RemoteObject组件对象的MXML标签语法如下： id属性指定了RemoteObject组件实例名称，在接下来调用该服务对象及处理远程服务响应时使用。destination属性指定了要连接的远程服务的目标，该值必须与服务器端remote-config.xml文件中配置的目标id属性相匹配。 我们也可以使用ActionScript代码来创建RemoteObject对象： var remoteObj:RemoteObject = new RemoteObject(); remoteObj.destination = "shoppingCart"; 19.2.5 客户端：调用远程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(); 19.2.6 客户端：处理响应和异常 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对象处理异常。具体方式可以参见第18章的18.1.6节“处理异常”（见第425页）。 19.2.7 使用处理多个方法类似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()方法实现调用。例如：