在部署描述文件ejb-jar.xml中提供组件的抽象持久性模式的名称和需要容器进行持久性管理的域名称，还需要指定实体的Primary Key对应的域。即在entity元素声明中使用abstract-schema-name定义组件的抽象持久性模式名称，并使用cmp-field定义需要容器进行持久性管理的域，最后使用primkey-field定义Primary Key域，此域必须存在于使用cmp-field定义的容器管理持久性域中。需要注意的是，对于处理实体之间的关系而定义在实体中的域，需要以容器管理关系域出现，如Book实体中的publishingHouse域，将在第 44.6.2.3.2 节 “容器管理关系（cmr）与容器管理关系域（cmr-field）”中介绍。

以本节范例实体中的Book为例，因publishingHouse和authors域用于定义与PublishingHouse、Author等实体间的关系，不属于容器管理持久性域的范围，因此，Book只有三个容器管理持久性域：id、title和price域，其中，id域表示Primary Key域，不代表实体数据，因此，未表示在实体图形中 。按照前面的规则，有如下ejb-jar.xml片断：

...
  <entity>
    ...		
    <abstract-schema-name>Book</abstract-schema-name>
    <cmp-field>
      <field-name>id</field-name>
    </cmp-field>
    <cmp-field>
      <field-name>title</field-name>
    </cmp-field>
    <cmp-field>
      <field-name>price</field-name>
    </cmp-field>
    <primkey-field >id</primkey-field>		
    ...
  </entity>
...

对于每个在ejb-jar.xml文件中声明的容器管理持久性的Entity Bean，还需要在apusic-application.xml中，使用table-name元素定义组件映射的表名称，使用field-mapping元素对容器管理持久性域与数据库表中的列进行映射，并且使用cmp-resource元素声明需要使用的数据源名称，这一数据源由ejb-jar中所有的容器管理持久性的Entity Bean以及关系辅助表共同使用。以Book组件为例，有如下apusic-application.xml片断：

<ejb>
  ...
  <entity ejb-name="Book">
    <jndi-name>Book</jndi-name>
    <cmp>
      <jdbc>
        <table-name>BOOK_TABLE</table-name>
        <field-mapping>
          <field-name>id</field-name>
          <column-name>BOOK_ID</column-name>
        </field-mapping>
        <field-mapping>
          <field-name>title</field-name>
          <column-name>TITLE</column-name>
        </field-mapping>
        <field-mapping>
          <field-name>price</field-name>
          <column-name>PRICE</column-name>
        </field-mapping>
      </jdbc>
    </cmp>
  </entity>
  ...
  <cmp-resource>
    <jndi-name>jdbc/CMPSample</jndi-name>
  </cmp-resource>
...
<ejb>
...

最后，开发者还需要在组件类中声明对容器管理持久性域的抽象访问方法 ，即Java Beans规范中的setter和getter方法，在组件被部署到应用服务器后，容器将在运行时根据前面指定的配置信息实现这些方法，因此，开发者在定义这些方法时，必须把它们声明为抽象（abstract）方法。以Book组件为例，组件类BookEJB有如下代码片断：

...
public abstract class BookEJB implements EntityBean {

    // access methods for persistent fields

    public abstract void setId(java.lang.String id);
    public abstract void setTitle(java.lang.String title);
    public abstract void setPrice(double price);
    public abstract double getPrice();
    public abstract java.lang.String getTitle();
    public abstract java.lang.String getId();
    ...
}

在Entity Bean的开发过程中，对组件状态的访问必须通过上面定义的抽象方法进行，例如，在BookEJB中的ejbCreate方法被调时，可直接调用以上访问方法进行状态的初始化，如下：

...
    public String ejbCreate(
        String id,
        String title,
        double price) throws CreateException {

        setId(id);
        setTitle(title);
        setPrice(price);
        return null;
    }
...

如果，业务实体的状态对客户是可读或可写的，则可以通过组件接口决定是否暴露状态域的setter和getter方法，也可根据实际情形，决定暴露哪个方法给客户端。以Book组件为例，其两个容器管理持久性域对客户而言是可读和可写的，因此，本地接口Book中关于客户访问的代码片断如下：

...
public interface Book extends EJBLocalObject {
    public String getId();

    public void setTitle(String title);
    public String getTitle();

    public void setPrice(double price);
    public double getPrice();
    ...
}

one-to-one，每个Bean实例关联另一个Bean的单个实例；

one-to-many，一个Bean关联另一个Bean的多个实例；

many-to-many，Bean的多个实例关联另一个Bean的多个实例；

在ejb-jar.xml文件中，使用relationships元素中的ejb-relation元素对每个容器管理关系进行定义。在ejb-relation元素中，需要使用ejb-relationship-name元素定义标识关系的关系名称，使用ejb-relationship-role对关系中涉及的角色进行定义，每个角色涉及的角色名、多重性（one or many)、对应的Entity Bean组件、容器管理关系域，依次使用ejb-relationship-role-name、multiplicity、relationship-role-source、cmr-field元素对其进行定义。以本章中Book实体与PublishingHouse实体间的关系为例，则有如下ejb-jar.xml文件有关容器管理关系的片断：

<ejb-jar>
  ...
  <relationships>    
  ...
    <ejb-relation>
      <ejb-relation-name>BookAndPublishingHouse</ejb-relation-name>
      <!-- One role: Book -->
      <ejb-relationship-role>
        <ejb-relationship-role-name>
          Book
        </ejb-relationship-role-name>
        <multiplicity>Many</multiplicity>
        <relationship-role-source>
          <ejb-name>Book</ejb-name>
        </relationship-role-source>
        <cmr-field>
          <cmr-field-name>publishingHouse</cmr-field-name>
        </cmr-field>
      </ejb-relationship-role>
      <!-- The other role: PublishingHouse -->
      <ejb-relationship-role>
        <ejb-relationship-role-name>
          PublishingHouse
        </ejb-relationship-role-name>
        <multiplicity>One</multiplicity>
        <relationship-role-source>
          <ejb-name>PublishingHouse</ejb-name>
        </relationship-role-source>
        <cmr-field>
          <cmr-field-name>books</cmr-field-name>
          <cmr-field-type>java.util.Collection</cmr-field-type>
        </cmr-field>
      </ejb-relationship-role>
    </ejb-relation>
    ...
  </relationships>
  ...
</ejb-jar>

在apusic-application.xml中，开发者需要使用ejb元素中包含的relationship-mapping元素对构成容器管理关系的容器管理关系域与持久存储中的数据模型进行映射。其中，使用ejb-relation-name元素定义关系的名字（需要与ejb-jar.xml文件中对应的ejb-relation-name元素的值相同）、使用table-name定义关系域所存在的表名字、使用source-role和sink-role元素定义参与关系的角色双方，完成组件模型中的容器管理关系域与数据库表中列的映射。source-role和sink-role元素被用于区分两个不同的角色，需要与在ejb-jar.xml文件中使用ejb-relationship-role元素定义的角色对应；如角色存在容器管理关系域在持久存储中的映射，则需要在source-role或sink-role元素中，使用field-mapping元素声明关系域与数据库表列的映射。如角色不存在容器管理关系域在持久存储中的映射，则可以使用空标记声明角色。

field-mapping元素中，使用field-name元素声明本角色在ejb-jar.xml文件中定义的primkey-field域，使用column-name元素将其映射到引用此域以保存关系的列。

以Book与PublishingHouse间的关系为例，此关系中只有Book中的关系域publishingHouse存在持久数据存储中的对应列PUB_FID，因此，有关apusic-application.xml片断如下：

...
<apusic-application> 
  ...
  <module>
    ...
    <ejb>
      ...
      <relationship-mapping>
        <ejb-relation-name>
          BookAndPublishingHouse
        </ejb-relation-name>
        <table-name>BOOK_TABLE</table-name>
        <auto-create-table/>
        <source-role/>
        <sink-role>
          <field-mapping>
            <field-name>id</field-name>
            <column-name>PUB_FID</column-name>
          </field-mapping>
        </sink-role>
      </relationship-mapping>
      ...
    </ejb>
  ...
  </module>
...
</apusic-application>

在关系双方的组件类中，声明所使用的容器管理关系域的抽象访问方法，如关系是单向的，则只需在可定位到另一方的组件类中，对域进行声明。方法必须是公有（public）和抽象（abstract）方法。以Book与PublishingHouse间的关系为例，BookEJB和PublishingHouseEJB中的相关代码片断如下：

//BookEJB.java
public abstract class BookEJB implements EntityBean
{
    ...
    public abstract void setPublishingHouse(PublishingHouse pub);
    public abstract PublishingHouse getPublishingHouse();
    ...
}//END BookEJB.java

//PublishingHouseEJB.java
...
public abstract class PublishingHouseEJB implements EntityBean
{
    ...
    public abstract void setBooks(Collection books);
    public abstract Collection getBooks();
		  ...
}//END PublishingHouse.java

通过组件接口定义客户端对组件的访问接口，即使用组件接口决定是否允许客户端访问容器管理关系域。Book与PublishingHouse相关的组件接口代码如下：

//Book.java
public interface Book extends javax.ejb.EJBLocalObject
{
    ...
    public void setPublishingHouse(PublishingHouse pub);
    public PublishingHouse getPublishingHouse();
    ...
}//END Book.java

//PublishingHouse.java
public interface PublishingHouse extends EJBLocalObject
{
    ...
    public void setBooks(Collection books);
    public Collection getBooks();
    ...
}//END PublishingHouse.java

在组件类中声明此辅助值对象的抽象访问方法，并在ejb-jar.xml文件中，将此域声明为一个容器管理持久性的域。

CustomerEJB.java中的相关代码片断如下：

...
public abstract class CustomerEJB implements EntityBean
{
    ...
    public abstract ContactInfo getInfo();
    public abstract void setInfo(ContactInfo info);
    ...
}

在apusic-application.xml中，映射辅助值对象的域与表模型中的列，域声明使用<容器管理持久性域的名称>.<辅助值对象的域>，如本例中，ContactInfo在CustomerEJB中以info为域名，而ContactInfo包含name、phone、fax和email域，因此，apusic-application.xml有如下配置片断:

...      
<entity ejb-name="CustomerEJB">
    <jndi-name>CustomerEJB</jndi-name>
    <cmp>
    <jdbc>
      ...
      <field-mapping>
        <field-name>info.name</field-name>
        <column-name>customer_name</column-name>
      </field-mapping>
      <field-mapping>
        <field-name>info.phone</field-name>
        <column-name>phone</column-name>
      </field-mapping>
      <field-mapping>
        <field-name>info.fax</field-name>
        <column-name>fax</column-name>
      </field-mapping>
      <field-mapping>
        <field-name>info.email</field-name>
        <column-name>email</column-name>
      </field-mapping>
      ...
    </jdbc>
  </cmp>
</entity>
...

当Entity对象被从关系中移除，关系所提供的可访问到此对象的方法将反映出对象被移除的结果。原通过one-to-one关系或many-to-one关系可访问到此对象的方法，现会返回null值；而通过many-to-may关系可访问到此对象的方法将返回一个不包含此对象的集合对象。

对于已被移除的Entity对象的访问，如果是通过远程客户进行调用，容器将抛出java.rmi.NoSuchObjectException异常；如是通过本地客户进行调用，容器将抛出javax.ejb.NoSuchObjectLocalException异常。当把一个已被移除的Entity对象赋值给一个容器管理关系的域（无论是通过域的set方法或通过java.util.Collection API），容器将抛出java.lang.IllegalArgument异常。

如在Home接口中声明了findAll方法， 容器将自动生成查询所有行的语句；

如在Home接口中定义的finder方法名为findBy<域名>，其中，域名是一个容器管理持久性域的名字，且第一个字母大写并且参数类型与容器管理持久性域类型相同，容器自动生成按此容器管理持久性域进行查找的查询语句。

不存在状态 ；

实例池状态。处于实例池状态中的实例没有特别的对象标识；

就绪状态。处于就绪状态的实例已被分配对象标识。

实例的生存周期开始于容器创建新的Entity实例，然后容器调用实例的setEntityContext方法，将容器保存的伴随实例的EntityContext对象传递给实例。EntityContext对象使实例拥有访问容器提供的服务和取得客户端调用信息的能力；

实例进入实例池中，成为可用实例。每个Entity Bean拥有其自身的实例池。实例池中的所有实例无对象标识，且都是相等的，任何实例都可通过分配对象标识进入就绪状态。对于实例池中的实例，容器可以调用实例的ejbFind方法和ejbHome方法，这两种方法的对应客户端视图在组件的Home接口中定义，执行这些方法不会导致实例改变其状态，同时可以在ejbHome方法中调用实例的ejbSelect方法。

当客户端对Entity对象进行调用，容器选择某实例以服务此调用时，实例从实例池状态转移到就绪状态。这种转换由两种可能的方式：一是通过ejbCreate方法和ejbPostCreate方法，即当客户端调用了Home接口中定义的create方法，容器在创建Entity对象的过程中，将实例分配给Entity对象；另一种方式是当对已存在的Entity对象的调用发生，当没有合适的处于就绪状态的实例可分配给客户端请求时，容器通过调用ejbActivate方法，使实例由实例池的状态转移到就绪状态；

处于就绪状态中的实例拥有指定的对象标识，当实例状态发生变化或与底层数据存储中的数据不一致，容器将会决定何时调用ejbLoad方法和ejbStore方法，以对实例状态和业务数据进行同步。当实例处于就绪状态，ejbSelect方法可以由业务方法或ejbStore或ejbLoad方法所调用；

容器可以在事务边界中选择钝化一个Entity Bean实例。容器首先调用ejbStore方法保证实例状态与业务数据的同步，之后调用ejbPassivate方法，使实例转移到实例池的状态；

最终，容器将实例转移到实例池状态。有三种方式完成转移，一种是通过ejbPassivate方法，通过ejbRemove方法，还有就是因ejbCreate、ejbPostCreate和ejbRemove等方法的事务回滚发生的转移（上图中未标注）。容器在需要解除实例的对象标识但不移除对象的情况下，调用ejbPassivate。当组件接口中或Home接口中的remove方法被调用后，容器调用ejbRemove方法移除Entity对象。当ejbCreate方法、ejbPostCreate方法和ejbRemove方法被调用，但发生了事务回滚，容器将把实例转移到实例池状态。

当实例返回实例池中，不再拥有对象标识。容器可以把实例分配给任何同一Home接口的Entity对象；

容器通过调用实例的unsetEntityContext方法清除实例。

提供一个无参数的公有构建器（public constructor） ；

实现setEntityContext方法。

容器通过此方法将一个EntityContext接口的引用传递给实例。如果实例希望在其生存周期内使用此引用，一般需要定义一个变量以保存此引用。在此方法中，实例的对象标识不可用，在此方法内部不可访问实例的持久状态和关系。

通过此方法，开发者可以对实例生存周期内将要使用的资源进行分配，此类资源不可被指定到特定的Entity对象标识，因为在实例的生存周期内部，实例可能会服务于多个Entity对象标识。

实现unsetEntityContext方法。

在结束实例的生存周期之前，容器将会调用此方法。在此方法中，实例的对象标识不可用，在此方法内部不可访问实例的持久状态和关系。通过此方法，开发者可以对实例生存周期内占用的资源进行释放，此类资源通常在setEntityContext内分配。

实现ejbCreate方法。

Entity Bean的组件类中可以定义零个到多个ejbCreate方法。其方法签名必须与组件的Home接口中定义的create方法一一对应。在客户端调用create方法时，容器将调用对应的ejbCreate方法。

开发者通过getter和setter方法，使用ejbCreate方法的输入参数，对实例进行初始化，当ejbCreate方法返回时，在底层数据存储中创建对象的持久数据表示。在此方法中，对容器管理域的getter方法的调用将返回Java语言中的缺省值（如integer型的域返回0，指针类型返回null），除了集合类型的容器管理关系域，对它的getter方法的调用将返回一个空集合。在此方法中，开发者不能试图去修改容器管理关系域，而应该在ejbPostCreate方法中进行此操作。

ejbCreate方法创建的Entity对象必须拥有一个非重复的Primary Key，即不同于所有已经存在的，同一Home接口的Entity对象已经拥有的Primary Key。

	注意
	开发者应该在ejbCreate方法中编码返回null值，如下： ... public String ejbCreate( String id, String title, double price) throws CreateException { setId(id); setTitle(title); setPrice(price); return null; } ...

ejbCreate方法的事务上下文由对应的create方法指定的事务属性决定。容器在开发者实现的ejbCreate方法完成后，在同一事务上下文中完成数据的插入操作。

实现ejbPostCreate方法。

每个ejbCreate方法都有一个对应的ejbPostCreate方法，这两个对应方法拥有同样的参数数目和类型，但ejbPostCreate方法的返回值类型为void，容器在调用ejbCreate方法后，使用同样参数调用ejbPostCreate方法。容器可以调用随同实例的EntityContext对象引用的getPrimaryKey方法，得到实例的Primary Key。

在ejbPostCreate方法中，对象标识是可用的，例如，可以在方法中取得对象的组件接口并作为参数传递给另一个EJB。

ejbPostCreate方法与ejbCreate方法在同一事务上下文中执行。

实现ejbActivate方法。

当容器从实例池中取得实例并分配给实例一个指定对象标识时，容器将调用此方法，开发者可以在此方法中为实例将在就绪状态中使用的资源进行分配。在此方法中，不可访问实例的持久状态和关系。

实例可以通过伴随实例的EntityContext对象引用的getPrimaryKey、getEJBLocalObject或getEJBObject等方法取得Entity对象的标识。

实现ejbPassivate方法。

当容器决定清除实例的对象标识时，容器将调用此方法，并将实例返回到实例池中。开发者可以在此方法中为实例在就绪状态中占用的资源进行释放，通常这些资源在ejbActivate方法中分配。在此方法中，不可访问实例的持久状态和关系。

实例仍然可以通过伴随实例的EntityContext对象引用的getPrimaryKey、getEJBLocalObject或getEJBObject等方法取得Entity对象的标识。

实现ejbRemove方法。

当客户端调用组件的Home接口或组件接口中的remove方法，或者作为级联移除的结果，容器将调用实例的ejbRemove方法。当ejbRemove方法结束，实例转移到实例池的状态。

在实例对应的持久业务数据被清除之前，开发者可以在此方法中进行必要的操作。容器在调用ejbRemove方法之前，将会对实例状态与持久存储中的业务数据进行同步。

ejbRemove方法的事务上下文决定于引发ejbRemove方法的对应remove方法的事务属性。在此方法中，实例仍然可以通过伴随实例的EntityContext对象引用的getPrimaryKey、getEJBLocalObject或getEJBObject等方法取得Entity对象的标识。

当ejbRemove方法返回，容器将在同一个事务上下文中，将实例从参与的所有容器管理关系从持久存储中移除。

在此方法执行完成之后的实例状态与实例钝化后的状态相同，准备进入实例池，因此，实例必须释放通常在ejbPassivate方法中释放的资源。

实现ejbLoad方法。

当容器决定同步实例状态与持久数据时，容器将调用此方法。在ejbLoad方法被调用之前，容器已经将持久数据装入，因此，开发者需要在此方法中对依赖于持久数据的实例变量进行重新计算和初始化。例如，开发者可以通过ejbLoad方法，对通过getter访问方法返回的值进行重新计算，如文本解压缩或进行解密操作。

执行ejbLoad方法的事务上下文取决于引发ejbLoad的业务方法的事务属性。

实现ejbStore方法。

当容器决定同步持久数据与实例状态时，容器将调用此方法。在同步实例状态之前，开发者应该使用域访问方法（getter、setter）更新实例，如在使用ejbStore存储数据到持久存储之前，将某文本域的值进行压缩等。

实现ejbFind方法。

对于容器管理持久性的Entity Bean，开发者不必编写ejbFind方法的内容。只需使用EJB QL查询语言在部署描述中指定查询语句。有关EJB QL查询语言，参见 第 44.7 节 “EJB QL”。有关finder方法的具体内容，参见第 44.6.2.6 节 “Finder方法”。

实现ejbHome方法。

当客户端通过Home接口引用调用Home方法时，容器将选择一个实例并调用对应的ejbHome方法。当容器调用实例的ejbHome方法时，实例处于实例池中，在方法调用返回之后，实例又回到实例池中。

执行ejbHome方法的事务上下文取决于对应的Home接口中Home方法的事务属性。

开发者必须在ejbHome方法中提供对Home接口中定义的Home方法的实现。在此方法中，不可访问实例的持久状态和关系。

实现ejbSelect方法。

开发者可以在组件类中定义零到多个ejbSelect方法。ejbSelect方法并不暴露在Home接口和组件接口中，对客户端是不可见的。通常，开发者通过业务方法调用ejbSelect方法。

ejbSelect方法必须被定义为抽象（abstract）的。

ejbSelect方法由开发者在部署描述中指定的信息决定，开发者不需要对ejbSelect方法进行编码。

定义ejbSelect方法的语法参见第 44.7 节 “EJB QL”。有关select方法的具体内容，参见第 44.6.2.7 节 “Select方法”。

执行ejbSelect方法的事务上下文取决于调用ejbSelect方法的业务方法的事务上下文。