全面研读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> 方法的范围则是全局性的,所以同一个查询将返回整个企业内所有雇员的全部风险投资。