全面研读EJB 2.0(3)
· EJB 查询语言
EJB 查询语言 (EJB QL) 规定了持久性管理器应该如何实现在本地接口中定义的各种查找方法。 EJB QL 以 SQL-92 为基础,可由持久性管理器自动编译,这使得实体 bean 具有更高的可移植性,并且更容易部署。
· EJB QL 和查找方法
EJB QL 语句是在实体 bean 的部署描述符中声明的。使用 EJB QL 非常简单。作为一个例子,Employee bean 的本地接口可以按以下方式声明:
public interface EmployeeHome extends javax.ejb.EJBHome
{
...
public Employee findByPrimaryKey(Integer id)
throws RemoteException, CreateException;
public Collection findByZipCode(String zipcode)
throws RemoteException, CreateException;
public Collection findByInvestment(String
investmentName)
throws RemoteException, CreateException;
}
给定了上面的本地接口定义之后,您就可以使用 EJB QL 来指定持久性管理器应该如何执行查找方法。每个实体 bean 都必须有一个 findByPrimaryKey() 方法。为执行该方法所需的查询是很明显的 -- 使用主关键字的(一个或几个)字段在数据库中查找 bean,这样就不需要任何 EJB QL 语句。
findByZipCode() 方法用来获得具有某个邮政编码的所有 Employee bean。这将使用部署描述符中的下列 EJB QL 来表达。
FROM contactInfo WHERE contactInfo.zip = ?1
该语句本质上是表示“选择其邮政编码等于 zipcode 参数的所有 Employee bean”。
在用于查找方法的 EJB QL 语句中,不需要使用 SELECT 子句来表明要选择的内容。这是因为,查找方法将总是选择与其自身的 bean 类型相同的远程引用。在这种情况下,就可以认为选择语句将返回远程 Employee bean 的全部引用。
如果各种查找方法都一起部署在同一个 ejb-jar 文件中,并且其间具有可导航的实际关系,那么这些查找方法就甚至可以跨越到另一些 bean 的抽象持久性方案中去。例如,findByInvestment() 方法将要求该查找查询从 Employee 导航到投资 bean 的抽象持久性方案中去。声明来表达这种查找操作的 EJB QL 语句如下所示。
FROM element IN benefit.investments WHERE element.name
= ?1
以上语句是说:“选择全部这样的 Employee bean:其获利从属对象至少包含一个投资 bean 的引用,并且其名称等于 findByInvestment() 方法的 investmentName 参数。”
· EJB QL 和选择方法
EJB QL 也用于一种称为 ejbSelect 方法的新查询方法中,该方法类似于查找方法,只是它仅供 bean 类使用。该方法不在本地接口中声明,所以也不显露给客户机。此外,ejbSelect 方法可返回范围更大的各种值,而不仅限于 bean 本身的远程接口类型。
存在两种选择方法:ejbSelect<METHOD> 和 ejbSelect<METHOD>InEntity。ejbSelect<METHOD> 方法是全局执行的,这是指这种方法并非专用于执行该方法的 bean 实例。ejbSelect<METHOD>InEntity 方法则专用于执行该方法的实体实例。这些选择方法在 bean 类中被声明为抽象方法,并在这些类的业务方法中使用。下面是 ejbSelect<METHOD> 方法和 ejbSelect<METHOD>InEntity 方法的示例,同时说明了可以如何在业务方法中使用它们。
public abstract class EmployeeBean implements
javax.ejb.EntityBean {
...
// ejbSelectInEntity
public abstract Collection
ejbSelectInvestmentsInEntity (String risk);
// ejbSelect
public abstract Collection
ejbSelectInvestments(String risk);
...
}
在上面的声明中,两种选择方法运行于不同的范围。ejbSelectInvestmentsInEntity() 仅在当前的 Employee bean 实例上执行,所以它只返回雇员的风险投资。
SELECT invest FROM invest IN benefit.investments WHERE
invest.type = ?1
另一方面,ejbSelect<METHOD> 方法的范围则是全局性的,所以同一个查询将返回整个企业内所有雇员的全部风险投资。
ejbSelect<METHOD>InEntity 选择方法可以返回 bean 的远程类型(如在上面的查询中那样)、从属对象或任何其它 Java 类型。另一方面,全局选择方法则不能返回 bean 的从属对象类型。
选择方法的 EJB QL 语句要求使用 SELECT 子句,因为它们能够返回范围更广的各种值。
· 新的 ejbHome 方法
在 EJB 2.0 中,实体 bean 可以声明一些 ejbHome 方法,用来执行与 EJB 组件相关的操作,但并不专用于某个 bean 实例。在 bean 类中定义的 ejbHome 方法在本地接口中必须有一个与其相匹配的本地方法。下面的代码说明了一个本地方法,它正是作为 Employee bean 的本地接口定义的。applyCola() 方法用来根据最近 COLA(生活费用调整)的增长来更新所有雇员的薪水。
public interface EmployeeHome extends javax.ejb.EJBHome
{
// 本地方法
public void applyCola(double increate) throws
RemoteException;
...
}
applyCola() 方法在 bean 类中必须有匹配的 ejbHome 方法,它被声明为 ejbHomeApplyCola()。ejbHomeApplyCola() 方法并非专用于一个 bean 实例,它的范围是全局的,所以它将对所有雇员的薪水使用同一个 COLA。
public abstract class EmployeeBean implements
javax.ejb.EntityBean {
...
// ejbHome 方法
public void ejbHomeApplyCola (double increase ){
Collection col = ejbSelectAllEmployees ();
Iterator employees = col.iterator();
while(employees.next()){
Employee emp =
(Employee)employees.next();
double salary =
emp.getAnnualSalary();
salary = salary + (salary*increase);
emp.setAnnualSalary(salary);
}
}
}
bean 的开发人员需要为 BMP 和 CMP 实体 bean 都实现 ejbHome 方法。CMP 实现可能在很大程度上要依赖于全局的选择语句(如上面所说明的那样)和 finder 方法,而 ejbHome 的 BMP 实现则将使用直接数据库访问和 bean 的 finder 方法,来查询数据和进行更改。
MessageDrivenBean
在 EJB 2.0 中,对规范的一个基础性更改是添加了一种全新的企业级 bean 类型,即 MessageDrivenBean。MessageDrivenBean 专门设计来处理入网的 JMS 消息。对于许多开发人员来说,JMS 是一种新的范例,所以本文将花一些时间逐步说明对 JMS 的理解,以及它们在 EJB 2.0 中的用法。
· 什么是 JMS?
JMS 是一种与厂商无关的 API,用来访问消息收发系统。它类似于 JDBC (Java Database Connectivity):这里,JDBC 是可以用来访问许多不同关系数据库的 API,而 JMS 则提供同样与厂商无关的访问方法,以访问消息收发服务。许多厂商目前都支持 JMS,包括 IBM 的 MQSeries、BEA 的 Weblogic JMS service 和 Progress 的 SonicMQ,这只是几个例子。
JMS 使您能够通过消息收发服务(有时称为消息中介程序或路由器)从一个 JMS 客户机向另一个 JML 客户机发送消息。消息是 JMS 中的一种类型对象,由两部分组成:报头和消息主体。报头由路由信息以及有关该消息的元数据组成。消息主体则携带着应用程序的数据或有效负载。根据有效负载的类型来划分,可以将消息分为几种类型,它们分别携带:简单文本 (TextMessage)、可序列化的对象 (ObjectMessage)、属性集合 (MapMessage)、字节流 (BytesMessage)、原始值流 (StreamMessage),还有无有效负载的消息 (Message)。
消息收发系统是异步的,也就是说,JMS 客户机可以发送消息而不必等待回应。比较可知,这完全不同于基于 RPC 的(基于远程过程的)系统,如 EJB 1.1、CORBA 和 Java RMI 的引用实现。在 RPC 中,客户机调用服务器上某个分布式对象的一个方法。在方法调用返回之前,该客户机被阻塞;该客户机在可以执行下一条指令之前,必须等待方法调用结束。在 JMS 中,客户机将消息发送给一个虚拟通道(主题或队列),而其它 JMS 客户机则预订或监听这个虚拟通道。当 JMS 客户机发送消息时,它并不等待回应。它执行发送操作,然后继续执行下一条指令。消息可能最终转发到一个或许多个客户机,这些客户机都不需要作出回应。
· EJB 2.0 中的 JMS
EJB 2.0 以两种方式支持 JMS 的集成:作为一种 bean 可用的资源,和作为一个 MessageDrivenBean。当将 JMS 用作一种资源时,使用 JMS API 的 bean 就是消息的产生者或发送者。在这种情况下,bean 将消息发送给称为主题或队列的虚拟通道。另一方面,MessageDrivenBean 则是消息的使用者或接收者。它监听特定的虚拟通道(主题或队列),并处理发送给该通道的消息。为了更好地理解消息产生者和消息使用者的作用,用 SessionBean bean 来发送一条使用 JMS 的消息,然后使用一个新的 MessageDrivenBean 来使用该同一条消息。
· 作为 EJB 2.0 资源的 JMS
会话 bean 和实体 bean 都是基于 RPC 的组件,为了将各种事务性的组件装配到一起,这是一种卓越的体系结构。但是,在某些情况下,RPC 的同步性质会成为一种障碍,这正是 EJB 1.1 中将对 JMS API 的访问作为一种资源包括在内的原因。利用 JNDI 环境命名的上下文,bean 可以获得一个 JMS 工厂,并将一条异步消息发送给主题或队列(也从 JNDI 获得),而不必等待回应。下面是 ShoppingCart bean 的一个例子,它使用 JMS 将 Order 的详细信息发送给消息收发主题。
public class ShoppingCartBean implements SessionBean {
// 订单详细信息是一个可序列化的对象,它包含全部订单信息。
public OrderDetail orderDetail;
public void processOrder(){
// 处理订单的逻辑从此处开始
....
// ... 处理订单以后,向其它系统发送有关此订单的一条消息
InitialContext jndiEnc = new
InitialContext();
// 使用 JNDI ENC 获取 JMS 工厂和主题标识符
TopicConnectionFactory factory =
jndiEnc.lookup("java:comp/env/jms/topicfactory");
Topic orderTopic =
jndiEnc.lookup("java:comp/env/jms/ordertopic");
// 获得一个用来发送消息的发布者
TopicConnection con =
factory.createTopicConnection();
TopicSession session =
con.createTopicSession(false,
Session.AUTO_ACKNOWLEDGE );
TopicPublisher publisher =
session.createPublisher(orderTopic);
// 将一个 ObjectMessage 发送给主题(虚拟通道)
ObjectMessage message =
session.createObjectMessage();
message.setObject(orderDetail);
publisher.publish(message);
con.close();
}
...
}
在这种情况下,JMS 是用来通知另外的应用程序,订单已被处理。这些另外的应用程序对于处理订单来说并不重要,但它们会因为得到一个订单已被处理的通知而受益。这样的例子包括自动调整库存的库存系统,和能将客户添加进产品目录邮寄名单中的销售应用程序。
使用 JMS 使 bean 能够发布(发送)消息而不会发生阻塞。bean 并不知道谁将收到消息,因为它是将消息发送给某个主题(虚拟通道),而不是直接发送给另一个应用程序。应用程序可以选择预订该主题,并接收有关新订单的通知。这样就有可能动态地在虚拟通道中添加或删除应用程序,从而产生了一种更加灵活的系统。
预订了订单主题的应用程序将收到有关新订单的通知,应用程序可以使用它们认为合适的任何方式来处理这个通知。预订了各种主题的应用程序或者从各个队列中接收消息的应用程序可以是 Java 应用程序、EAI 系统(用于集成遗留系统和 ERP 系统)或者 MessageDrivenBean 组件,在 JMS 的术语中,它们全部被认为是 JMS 客户机。
JMS 和 MessageDrivenBean
虽然大多数 JMS 厂商都提供消息中介工具,来将消息从发送者路由到接收者,但构建使用(接收)消息的 JMS 客户机却是应用程序开发人员的职责。在许多情况下,接收消息的应用程序必须强健、安全、快速而且可伸缩;它需要的基础结构基本上与 EJB 应用程序相同。
由于认识到这种需要,EJB 2.0 现在包括了 MessageDrivenBean 类型,它可以使用 JMS 消息,并且在同一个强健的、基于组件的基础结构中处理这些消息,这样的基础结构对于会话 bean 和实体 bean 都非常有用。MessageDrivenBean 类型(消息 bean)是一种企业级 bean 组件,它设计来使用异步的 JMS 消息。
除了提供容器基础结构以外,EJB 还具有另一个重要的优点:并发处理。在 EJB 中,一个已部署的消息 bean 表示一个单一的消息使用者,但这个 bean 本身是由许多 bean 实例提供服务的。每个 bean 实例都可以分别地使用消息 bean 接收到的消息。这意味着,消息 bean 不必像常规 JMS 客户机那样连续地使用消息。消息 bean 可以并发地使用接收到的多个消息,这样就能达到比传统 JMS 应用程序高得多吞吐量和好得多的可伸缩性。
为了说明消息 bean 的作用,就开发了 MarketingBean 类,并将它从订单主题中部署到供使用的消息中去。MarketingBean 将从消息中提取 OrderDetail 对象,并使用它将客户添加到适当的目录邮寄名单中。这是一种最精致的大量邮寄系统。
下面是 MarketingBean 类的定义,这个类使用发布给订单主题的消息。
public class MarketingBean implements
javax.ejb.MessageDrivenBean {
public void onMessage(Message message) {
ObjectMessage orderMessage =
(ObjectMessage)orderMessage:
OrderDetail orderDetail =
(OrderDetail)orderMessage.getObject();
Integer customerID =
orderDetail.getCustomerID();
InitialContext jndiEnc = new
InitialContext();
CatalogHome catalogHome =
(CatalogHome)jndiEnc.lookup("java:comp/env/ejb/catalog");
Iterator productIDs =
orderDetail.getProductsIDs();
while(productIDs.hasNext()){
Integer productID =
(Integer)productIDs.next();
Catalog cat =
CatalogHome.findByProductID(productID);
cat.addCustomerToMailingList(customerID);
}
}
}
正像会话 bean 和实体 bean 一样,MessageDrivenBean 也是一种完备的企业级 bean,但其间仍存在一些重要的区别。消息 bean 没有远程接口或本地接口。这是因为消息 bean 不是 RPC 组件。它没有供 EJB 客户机调用的业务方法。消息 bean 监听虚拟消息通道(主题或队列),并使用其它 JMS 客户机发送给该通道的消息。
各个消息 bean 构成一个 bean 类,这个类实现 MessageDrivenBean 接口和一个 XML 部署描述符。下面是 MessageDrivenBean 接口的定义,所有消息 bean 都必须实现这个接口。
package javax.ejb;
import javax.jms.Message;
import javax.jms.MessageListener;
public interface MessageDrivenBean extends
MessageListener{
public void onMessage(Message message);
public void ejbCreate();
public void ejbRemove();
public void
setMessageDrivenContext(MessageDrivenContext mdc);
}
当部署了一个消息驱动的 bean 以后,它就被指派来处理特定主题或队列中的消息。JMS 客户机(Java 应用程序、bean 或本地客户机)发送的任何消息,将由消息路由器转发给消息 bean,该消息 bean 正是被指派来从该虚拟通道中接收消息的。当一条消息被发送给一个消息 bean 时,EJB 容器就会从某个池中选择该 bean 的一个实例,来处理这条消息。当 bean 实例调用其 onMessage() 方法时,它就会接收到这条消息,并能够以它认为合适的任何方式来处理这条消息。一旦这条消息被使用,则只要事务没有异常中止,这条消息都不会被传送给这个消息 bean 的任何其它实例。
消息 bean 在某点上类似于无状态的会话 bean,即这两种 bean 在两次请求之间都不保持任何状态。因此,消息驱动的 bean 是无状态的,但是,就像无状态的会话 bean 一样,它们也可以有实例变量,这些变量在这个 bean 实例的整个生存期内均保持。
对消息 bean 的最后一点说明是,理解这样一个事实是很重要的,即 bean 使用的消息不一定要是由其它 bean 所产生的。消息 bean 可以使用由符合 JMS 的厂商提供的任何主题或队列中的消息。消息 bean 使用的消息可以来自其它 bean(会话 bean、实体 bean 或消息 bean)、非 EJB 的 Java 应用程序、或者甚至非 Java 的应用程序(如果其供应商符合 JMS)。例如,遗留应用程序可能使用 IBM 的 MQSeries 向队列发送消息,而该消息既可以由其它遗留应用程序使用,同样可以由消息 bean 使用。
· 结论
与以前的规范相比,Enterprise JavaBeans 2.0 中作了一些相当大的更改。新的 CMP 模型比以前的模型要灵活得多,它允许各种实体为复杂的对象图建立模型,而同又提供跨容器的更大的可移植性。人们迫切地期待着为查找和选择操作定义一种通用的查询语言,而它也将有助于提高可移植性。
这种新的 MessageDrivenBean 类型将有助于使这种强大的消息收发范例成为众人瞩目的焦点,就像 EJB 那样。消息收发在分布式的混合计算中是一个极其重要的组成部分,将它包括在 EJB 内就是其重要性的一个证明。
在写这篇文章时,EJB 2.0 刚刚作为公开草案发布,这意味着在它成为一个最终规范之前仍有可能更改。如果更改对此处提供的材料有重大影响,届时我将设法对本文作一些注释,但这个规范正在趋于稳定,所以不太可能有真正重大的更改。
· 作者简介
Richard Monson-Haefel 是最近发布的 Enterprise JavaBeans 第二版的作者。他是 OpenEJB 的首席设计师(OpenEJB 是一种开放源代码的 Enterprise JavaBeans 2.0 容器),他曾经以设计师身份为 Enterprise JavaBeans、CORBA、Java RMI 以及其它 Java 方案提供咨询。Monson-Haefel 还维护着一个网站,供人们讨论 Enterprise JavaBeans 和相关的分布式计算技术。可以通过 richard.monson-haefel@javaworld.com 与 Richard Monson-Haefel 联系。
(全文完)
|