Bean管理持续化实例

　　原著：Dale Green

　　译者前言

　　有关本章中相应源代码的下载，请参看一个Session Bean的示例

　　正文

　　数据是绝大多数商业应用程序的核心。在J2EE应用程序中，entity bean反映了存储在一个数据库中的商业对象。对于使用bean管理持续化的entity bean，你必须编写代码以访问数据库。尽管编写这样的代码会增加一些额外的工作量，但是与此同时，你对entity bean如何访问数据库也获得了更多的控制。

　　在这一章中，我们将讨论一个使用bean管理持续化的entity bean的编程问题。对于entity beans的相关概念，请参阅Entity Bean是什么？.

　　SavingsAccountEJB示例

　　在这一部分的这个entity bean表现了一个简单的银行帐户。SavingsAccountEJB的状态存储在一个关系型数据库的savingsaccount表中。savingsaccount表是用下面的SQL语句建立的：

CREATE TABLE savingsaccount 
(id VARCHAR(3) 
CONSTRAINT pk_savingsaccount PRIMARY KEY, 
firstname VARCHAR(24), 
lastname VARCHAR(24), 
balance NUMERIC(10,2));

　　SavingsAccountEJB示例需要以下代码：

　　1、Entity bean类(SavingsAccountBean)

　　2、Home接口(SavingsAccountHome)

　　3、Remote接口(SavingsAccount)

　　此外，这个示例还用到以下类：

　　1、一个名为InsufficientBalanceException的功能类

　　2、一个名为SavingsAccountClient的客户端类

　　在j2eetutorial/examples/src/ejb/savingsaccount目录下有这个示例的源代码。要编译这个代码，到j2eetutorial/examples目录下并输入ant savingsaccount。在j2eetutorial/examples/ears下有SavingsAccountApp.ear文件的示例。

　　Entity Bean类

　　在示例程序中，entity bean类名为SavingsAccountBean。在你浏览它的代码时，请注意它满足了所有使用bean管理持续化的entity bean的必要条件。首先，它实现了以下几个方面：

　　1、EntityBean接口

　　2、零个或多个ejbCreate和ejbPostCreate方法

　　3、Finder方法

　　4、商业方法

　　5、Home方法

　　另外，一个使用bean管理持续化的entity bean类必须满足这些条件：

　　1、类定义为public。

　　2、类不能定义为abstract或final。

　　3、包含一个空的构造函数。

　　4、它不能实现finalize方法。

　　EntityBean接口

　　EntityBean接口继承自实现了Serializable接口的EnterpriseBean接口。EntityBean接口中声明了许多方法，例如ejbActivate和ejbLoad，这些方法你必须在你的entity bean类中加以实现。我们将在下面对这些方法作详细讨论。

　　ejbCreate方法

　　当客户端调用create方法时，EJB容器调用相应的ejbCreate方法。典型的情况是，一个entity bean中的ejbCreate方法执行以下任务：

　　1、将实体状态添加到数据库中

　　2、对实例变量进行初始化

　　3、返回主键

　　SavingsAccountBean的ejbCreate方法通过调用private类型的insertRow方法将实体状态添加到数据库中，这样做的结果是执行了一个INSERT语句。下面是ejbCreate方法的源代码：

public String ejbCreate(String id, String firstName, 
   String lastName, BigDecimal balance) 
   throws CreateException { 
  if (balance.signum() == -1) { 
  throw new CreateException 
 ("A negative initial balance is not allowed."); 
   } 
   try { 
  insertRow(id, firstName, lastName, balance); 
   } catch (Exception ex) { 
   throw new EJBException("ejbCreate: " + 
  ex.getMessage()); 
   } 
   this.id = id; 
   this.firstName = firstName; 
   this.lastName = lastName; 
   this.balance = balance; 
   return id; 
}

　　尽管SavingsAccountBean类只有一个ejbCreate方法，但是一个enterprise bean可以包含多个ejbCreate方法。示例请参见j2eetutorial/examples/src/ejb/cart目录下的CartEJB.java。

　　在为一个entity bean编写ejbCreate方法，必须遵守以下规则：

　　1、访问控制修饰必须是public。

　　2、返回类型必须是主键。

　　3、参数类型必须满足Java 2 RMI API。

　　4、方法修饰不能是final或static。

　　throws子句可以包含javax.ejb.CreateException的你的应用程序中所指定的其它例外。如果输入的参数无效，一个ejbCreate方法通常会抛出一个CreateException。如果因为已经存在另一个相同主键的实体，ejbCreate方法不能建立一个新的实体，它会抛出一个javax.ejb.DuplicateKeyException(CreateException的子类)。如果一个客户端接受到一个CreateException或者是一个DuplicateKeyException，它会认为实体未被建立。

　　可以通过一个对于J2EE服务器未知的应用程序将一个entity bean的状态直接插入到数据库中。例如，可以使用一个SQL脚本在savingsaccount表中添加一行。尽管对应于这一行的entity bean不是由一个ejbCreate方法创建的，但是客户端程序还是可以对这个bean进行定位。

　　ejbPostCreate方法

　　对于每一个ejbCreate方法，你必须在entity bean类中编写一个ejbPostCreate方法。EJB容器在调用ejbCreate方法后会立即调用ejbPostCreate方法。与ejbCreate方法不同，ejbPostCreate方法可以调用EntityContext接口中的getPrimaryKey方法和getEJBObject方法。有关getEJBObject方法的详细信息，请参看传递一个Enterprise Bean的对象索引。不过，你的ejbPostCreate方法常常会是一个空方法。