一个CMP的例子（一）

核心提示：Container-Managed Persistence Examples一个container-managed的实体bean带给开发人员很多好处，首先，一个CMP的例子（一），EJB容器治理所有数据库的存储与同步指令；其次容器治理实体bean之间的关系，由于这些服务的存在，这些方法有bean实现，同时也定义了get

　　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;
　　}