一起学习
EJB 2.0 中的一个示例 CMP 实体
在 EJB 2.0 中，容器管理的实体 bean 被定义为抽象的，而且它的持久性字段并不在 bean 类中直接定义。作为替代，开发了一种抽象的持久性方案，从而允许 bean 提供者间接地声明持久性字段和 bean 关系。下面是 Employee bean 的一个示例，它使用了新的抽象持久性方案。请注意，该 bean 类中未声明任何持久性字段。
public abstract EmployeeBean implements
javax.ejb.EntityBean {
. // 实例字段
EntityContext ejbContext;
// 容器管理的持久性字段
public abstract void setIdentity(int identity);
public abstract int getIdentity();
public abstract void setFirstName(String firstName);
public abstract String getFirstName();
public abstract void setLastName(String lastName);
public abstract String getLastName();
// 容器管理的关系字段
public abstract void
setContactInfo(ContactInfo info);
public abstract ContactInfo
getContactInfo();
...
}
在此 bean 的 XML 部署描述符中，抽象的持久性方案声明容器管理的各个字段和各种关系。
EmployeeEJB
...
Container
...
identity
firstName
lastName
...
ContactInfo
ContactInfo
street
city
state
zip
homePhone
workPhone
email
...
Employee-ContactInfo
employee-has-contactinfo
one
EmployeeEJB
contactInfo
ContactInfo
contactinfo_belongsto_employee
one
ContactInfo
用来描述容器管理的关系的 XML 元素可能变得非常复杂，因为他们必须处理各种关系的对应性和方向（单向的还是双向的）。上面的代码段说明，为了描述 bean 与其从属对象类之间的简单关系，您需要哪些元素。虽然即使是简单的关系也会被转换为冗长的 XML，但所有这些元素都是必需的，以便持久性管理器能够将复杂的对象图映射到数据库中。
虽然用于定义 CMP bean 的抽象持久性方案的 XML 元素是 EJB 2.0 中的 CMP 的主要问题，但为了简洁起见，本文不再提供 XML 示例。作为替代，本文将纯粹依靠 bean 类中必须使用的抽象习语，来说明 EJB 2.0 中的 CMP 背后的基本概念。这些代码习语与 XML 部署描述符中的关系元素一起使用，并由后者定义，所以您不能只有其一而没有另一个，但它们比该方案的 XML 部分较容易理解。
除了 XML 元素之外，抽象的持久性方案还定义了一组习语，它们在声明 bean 类及其相关的对象时必然会用到。用来访问和修改字段的方法是严格定义了的，要求用 set<:METHOD> 方法修改持久性字段，而用 get<:METHOD> 方法访问它们。这些方法的名称和返回类型由部署描述符中它们相应的 XML 关系元素规定。
实体 bean 类和从属类都遵循相同的抽象持久性方案。下面是如何将 ContactInfo 对象定义为从属对象类的示例。
public abstract class ContactInfo {
file:// 家庭地址信息
public abstract void setStreet(String street);
public abstract String getStreet();
public abstract void setState(String state);
public abstract String getState();
public abstract void setZip(String zip);
public abstract String getZip();
public abstract void setHomePhone(String phone);
public abstract String getHomePhone();
// 工作地址信息
public abstract void setWorkPhone(String phone);
public abstract String getWorkPhone();
public abstract void setEMail(String email);
public abstract String getEMail();
...
}
从属对象随实体 bean 的存在而存在，随实体 bean 的中止而中止，这是理解从属对象与实体 bean 之间关系的关键。从属对象包含在一个具体的实体中，所以删除这个实体将导致从属对象也被删除。用关系数据库的术语来说，有时这就称为级联删除。
从属对象，如 ContactInfo，用在关系字段中。与实体 bean 形成关系的从属对象技术上称为从属对象类。EJB 客户端应用程序永远不能直接访问从属对象类；这种类不能用作 bean 的远程或本地接口中的参数或返回值。从属对象类只对 bean 类才是可见的。
从属对象类不适合作为远程参数类型，因为它们与 bean 在运行时的持久性逻辑有密切的联系。持久性管理器扩展了抽象的从属对象类，以便能提供一种实现，可用于在运行时管理 bean 的持久性状态。此外，抽象的持久性方案还为数据建模 -- 而不是为那些由企业级 bean 表示的业务概念建模 -- 所以，作为一种设计策略，将抽象的持久性方案对 EJB 客户机隐藏起来是有意义的。
例如，ContactInfo 关系字段中除了 bean 的客户机所需的简单地址信息之外，还包含许多其它信息。虽然您可以使用抽象持久性方案中的从属对象类 ContactInfo（它对 bean 的客户机是隐藏的），但是，您得用其它的对象来把这些数据实际表露给客户机。下面是一个示例，说明了如何对 EJB 客户机隐藏 ContactInfo 从属对象。在此例中，地址信息是通过在 EJB 1.1 的示例中开发的 Address 对象来表露的。
// Employee bean 的远程接口
public interface Employee extends javax.ejb.EJBObject {
public Address getHomeAddress();
public void setHomeAddress(Address address);
public int getIdentity() throws RemoteException;
public void setFirstName(String firstName) throws RemoteException;
public String getFirstName()throws RemoteException;
public void setLastName(String lastName) throws RemoteException;
public String getLastName() throws RemoteException;
}
// Employee bean 的 bean 类
public abstract EmployeeBean implements
javax.ejb.EntityBean {
...
public Address getHomeAddress(){
ContactInfo info = getContactInfo();
Address addr = new Address();
addr.street = info.getStreet();
addr.city = info.getCity();
addr.state = info.getState();
addr.zip = info.getZip();
return addr;
}
public void setHomeAddress(Address addr){
ContactInfo info = getContactInfo();
info.setStreet(addr.street);
info.getCity(addr.city);
info.getState(addr.state);
info.getZip(addr.zip);
}
....
// 容器管理的关系字段
public abstract void setContactInfo(ContactInfo info);
public abstract ContactInfo getContactInfo();
...
}
尽管容器管理的关系字段没有表露给客户机，但您仍然可以从远程接口直接使用容器管理的持久性字段。请注意，用来访问 firstName 和 lastName 的容器管理的持久性字段是在远程接口中使用的。
一个 bean 与各种从属对象类之间可能具有多种不同的关系，它们由这种关系的对应性和方向来定义。Bean 与从属对象类之间可以有一对多和一对一的关系。例如，Employee bean 可能仅有一个 Benefit 从属对象类，但可能有许多 ContactInfo 从属对象类。
public abstract EmployeeBean implements
javax.ejb.EntityBean {
...
public abstract void setContactInfos(Collection addresses);
public abstract Collection getContactInfos():
public abstract void setBenefit(Benefit benefit);
public abstract Benefit getBenefit();
...
}
与从属对象类的一对多关系既可表示为 java.util.Collection 类型，也可表示为 ava.util.Set 类型（注：在本规范的后续版本中，java.util.Map 和 java.util.List 被视为附加的返回类型），而与从属对象的一对一关系则使用从属对象的类型。
实体 bean 也可以定义与其它实体 bean 的关系。这些关系可以是一对一、一对多或多对多。例如，Employee bean 可能有许多子级 bean，而只有一个配对的 bean。下面的代码段使用抽象持久性方案的方法习语，说明了如何为这些关系建模。该应用程序中，子级 bean 和配对的 bean 都表现为 Person bean。
public abstract EmployeeBean implements
javax.ejb.EntityBean {
...
public abstract void setSpouse(Person manager);
public abstract Person getSpouse();
public abstract void setChildren(Collection family);
public abstract Collection getChildren();
...
}
与另一个 bean 的一对多关系表示为 java.util.Collection 类型或 java.util.Set 类型，而一对一关系则使用该 bean 的远程接口类型。
从属对象本身与同一个 bean 中的其它从属对象之间可以有一对一、一对多和多对多的关系。此外，从属对象与其它实体 bean（除其父级 bean 之外）也可以有一对一、一对多的关系。下面的示例显示，Benefit 从属对象类与 Salary 从属对象（一种报酬计算程序）之间怎样具有一对一的关系，而与 Investment bean 又怎样具有一对多的关系。
public abstract class Benefit {
public abstract void setSalary(Salary salary);
public abstract Salary getSalary();
public abstract void setInvestments(Collection investments);
public abstract Collection getInvestments();
}
在部署时，部署者将使用持久性管理器工具来具体实现这个 bean 类及其从属类。这些具体实现将在运行时保持各种关系，并使各 bean 实例的状态与数据库同步。容器将在运行时管理持久性实例，从而提供一种强健的环境，其中具有自动的访问控制和事务控制。
bean 也可以定义从属对象的值，这些对象是可序列化的对象，如 EJB 1.1 示例中的 Address 对象。这些值通过序列化而变为持久的，它们并不形成与 bean 的关系 -- 它们是严格的容器管理的持久性字段。
容器与持久性管理器之间也已经定义了一个合约，使持久性管理器可以获得事务的句柄，并访问由该容器管理的数据库连接池。这个合约稍嫌宽松，将来还需要使其更为严格，但它是允许持久性管理器跨 EJB 容器移植的基础。容器和持久性管理器之间合约的细节已超出了本文的范围。
除了通过抽象持久性方案定义持久性之外，EJB 2.0 还提供了一种新的查询语言，用来说明持久性管理器应该如何实现 CMP 中的各种查找方法。
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 {
...
file:// 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
{
file:// 本地方法
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 方法，来查询数据和进行更改。
下载本文示例代码
全面研读 EJB 2.0（中）全面研读 EJB 2.0（中）全面研读 EJB 2.0（中）全面研读 EJB 2.0（中）全面研读 EJB 2.0（中）全面研读 EJB 2.0（中）全面研读 EJB 2.0（中）全面研读 EJB 2.0（中）全面研读 EJB 2.0（中）全面研读 EJB 2.0（中）全面研读 EJB 2.0（中）全面研读 EJB 2.0（中）
