Container-Managed Persistence Examples一个container-managed的实体bean带给开发人员很多好处。
首先，EJB容器管理所有数据库的存储与同步指令；其次容器管理实体bean之间的关系。
由于这些服务的存在，你不用去编写数据库逻辑，你所要做的只是在配置描述里面描述这些信息，这样不仅可以节约时间而且使得bean可以在多种数据库服务器使用。
这章我们的实例是一个container-managed的实体bean。这个应用的名字叫RosterApp。
RosterApp总揽：
这个RosterApp应用程序维持在一些体育运动联盟的球员的名单以及球队的名单。这个应用程序有5个组件。RosterAppClient组件是一个客户端组件，
他通过RosterEJB会话bean的romote接口访问RosterEJB。
RosterEJB访问3个实体bean-PlayerEJB, TeamEJB, and LeagueEJB,这些访问是通过3个实体bean的local接口。
这些实体bean采用CMP方式，TeamEJB和PlayerEJB的关系是多对多的双向的，LeagueEJB和TeamEJB的关系也是双向的，但是是一对多的关系。
编写PlayerEJB
这个实体bean代表一个存储在数据库的球员，像所有的CMP实体bean,PlayEJB需要如下的代码：
1 Entity bean class (PlayerBean)
2 Local home interface (LocalPlayerHome)
3 Local interface (LocalPlayer)
Entity bean class
为了实现CMP，这个实体bean的类必须是public和abstract的。同时也必须实现以下的条件：
1 EntityBean interface
2 0个或者多个ejbCreate和ejbPostCreate方法
3 get和set抽象方法。
4 一些抽象的select方法
5 home方法
6 商业方法
这个bean不能实现的方法:
1 finder方法
2 finalize方法
Access方法
一个CMP实体bean有persistent和relationship，这些是虚拟的，所以你不用把他们定义为实例变量。
你所作的只是在配置时描述他。但是你需要定义get和set方法。容器自动管理数据库的存储和同步，
配置中这些persistent需要被容器维持：
1 playerId (primary key)
2 name
3 position
4 salary
我们需要这些方法访问这些：
public abstract String getPlayerId();
public abstract void setPlayerId(String id);
public abstract String getName();
public abstract void setName(String name);
public abstract String getPosition();
public abstract void setPosition(String position);
public abstract double getSalary();
public abstract void setSalary(double salary);
这些方法的名字以get或者set开头，后面跟着persistent的名字。
这和JeanBean是一样的。
同时我们需要Access方法访问Relationship在这个应用程序中，因为一个球员可以在多个球队效力，所以一个PlayerEJB对象可以和很多TeamEJB相关。我们定义这个Relationship名字为teams，接下来我们需要定义这些Access方法。
public abstract Collection getTeams();
public abstract void setTeams(Collection teams);
Select方法
一个Select方法和一个Finder方法类似：
1 一个Select可以放回一个local或者remote接口（或者一个集合）
2 一个Select需要一个query连接数据库
3 需要自己在配置中定义一个EJB QL
4 bean类不需要实现这个方法
但是2者也有不同的地方：
1 一个select方法可以返回相关联的bean一个persistent（或者集合），一个finder只能返回local或者remote接口。
2 由于select方法不在local或者remote接口，一个select方法不能直接被客户调用，只能被这个bean的内部方法调用。
通常被一个商业方法调用。这个程序中定义了如下的select方法：
public abstract Collection ejbSelectLeagues(LocalPlayer player)
throws FinderException;
public abstract Collection ejbSelectSports(LocalPlayer player)
throws FinderException;
select方法名必须满足：
1 前缀必须是ejbSelect
2 access控制访问是public的
3 abstract
4 抛出的exception必须包含javax.ejb.FinderException
商业方法由于select方法不能被客户直接调通，所以将他们包含在商业方法中：
public Collection getLeagues() throws FinderException {
LocalPlayer player = (team.LocalPlayer)context.getEJBLocalObject();
return ejbSelectLeagues(player);
}
public Collection getSports() throws FinderException {
LocalPlayer player = (team.LocalPlayer)context.getEJBLocalObject();
return ejbSelectSports(player);
}
实体bean方法
由于是CMP，所以bean的生命周期方法基本不用实现
ejbCreate方法:
public String ejbCreate (String id, String name, String position, double salary) throws CreateException {
setPlayerId(id);
setName(name);
setPosition(position);
setSalary(salary);
return null;
}
注意return null除非debug的需要，ejbRemove方法一般都是空的。当容器调用这个方法后，容器删除数据库中的纪录。
ejbPostCreate方法和ejbCreate方法的参数和返回类型一样，如果你想建立一个关系，你应该把代码写在ejbPostCreate方法中。
容器会自动管理同步，存储等数据库操作，这些通过ejbLoad和ejbStore方法完成。
local home interface:
这里定义了creat，finder和其他一些home方法。
package team;
import java.util.*;
import javax.ejb.*;
public interface LocalPlayerHome extends EJBLocalHome {
public LocalPlayer create (String id, String name, String position, double salary)
throws CreateException;
public LocalPlayer findByPrimaryKey (String id)
throws FinderException;
public Collection findByPosition(String position)
throws FinderException;
...
public Collection findByLeague(LocalLeague league)
throws FinderException;
...
}
loca interface:
这里定义了一些商业方法，这些方法有bean实现，同时也定义了get和set方法，set方法不应该被暴露出来。
package team;
import java.util.*;
import javax.ejb.*;
public interface LocalPlayer extends EJBLocalObject {
public String getPlayerId();
public String getName();
public String getPosition();
public double getSalary();
public Collection getTeams();
public Collection getLeagues() throws FinderException;
public Collection getSports() throws FinderException;
}
