站内搜索: 请输入搜索关键词

当前页面: 开发资料首页J2EE 专题一个CMP的例子(一)

一个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
↑返回目录
前一篇: 使用JMX监控应用程序内、外部的状况
后一篇: 我的RMI实践