一个CMP的例子（一）

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

出处 CN-JAVA翻译： somy