EJB3.0入门学习文档

EJB3.0简介
岳乡成
一、 EJB的简介
1、 什么是EJB
Enterprise JavaBeans（EJB）是一个用于分布式业务应用的标准服务器端组件模式。
Enterprise JavaBeans（EJB）定义了3种企业Bean，分别是会话Bean（Session Bean）、实体Bean（Entity Bean）和消息驱动Bean（Massage Driver Bean）。
2、 EJB的运行环境
EJB需要运行在EJB容器，每个Java EE应用服务器都含有EJB容器和Web容器，所以既可以运行EJB，也可以运行Web应用。目前支持EJB 3.0的应用服务器有JBoss，WebLogic等。
（注：Tomcat目前只是Web容器，它不能运行EJB应用。）
二、 会话Bean（Session Bean）
1、 什么是Session Bean
Session Bean用于实现业务逻辑。比如：要实现两个数的相加或是从数据库中读取数据，都是通过Session Bean来实现的。Session Bean相当于我们熟悉的Action类。
Session Bean分为两种：有状态Bean（Stateful Session Beans）和无状态Bean（Stateless Session Beans）。
要开发一个Session Bean，需要定义接口和bean class。其中接口分为远程（Remote）和本地（Local）接口。
远程接口（Remote interface）：定义了Session Bean的业务方法，这些方法可以被来自EJB容器之外的应用访问到。
本地接口（Local interface）：同样定义了Session Bean的业务方法，这些方法可以同处于EJB容器内的其他应用使用。因为local接口允许Bean之间直接通过内存交互，没有分布式对象协议的开销，从而改善了性能。
Bean类（bean class）：Bean class包含了业务逻辑，它必须具备一个远程或本地接口。
2、 Stateless Session Bean（无状态Bean）
（1）无状态Bean不维护会话状态，意味着一个Bean实例可以为多个用户服务。简单的说，就是当无状态会话Bean部署到应用服务器时，EJB容器会为它预先创建一些Bean实例放在对象池。当有用户访问EJB方法时，EJB容器会从对象池中取出一个实例为之服务，服务完成后就回到对象池。当下一个用户再访问EJB方法时，EJB容器有可能再次把该实例取出来为之服务。正因为如此，无状态会话Bean只需要少量的实例就可以为成千上万个用户服务，大大提高了系统性能。
（2） 无状态Bean比有状态Bean更具性能优势，条件允许的情况下开发人员应该首先考虑使用无状态会话Bean。
（3）无状态Bean定义实例如下：
远程接口（Remote interface）如下：
@Remote
public interface NewsDAO extends DAO{

}
本地接口（Local interface）如下：
@Local
public interface NewsLocalDAO extends NewsDAO {

}
无状态Bean定义如下：
/**
* 新闻实体操作类
* @author xiangcheng.yue
*
*/
@Stateless(mappedName="NewsDAOBean")
@Remote (NewsDAO.class)
@Local(NewsLocalDAO.class)
public class NewsDAOBean extends DaoSupport implements NewsDAO, NewsLocalDAO {
}
（4）Stateless Session Bean的生命周期很简单只有两种状态——does not exist和method-ready pool，有兴趣的可以查阅相关资料，因为我们开发中可能不太关注Stateless Session Bean所处的状态，这里就不详细介绍了。但只值得注意的是Session Bean从一种状态转入到另一状态时，往往会产生一个事件，在Bean class类中可以通过注释，为该事件注册一个回调方法。
例如：一个Stateless Session Bean实例从does not exist到method-ready pool状态就会产生一个post-construction事件。可以为某个方法加@javax.annotation.PostConstruct注释做为该事件的回调方法。
@Stateless
@Remote(LifeCycle.class)
Public class LifeCycleBean implements LifeCycle{
@PostConstruct
Public void Construct(){
System.out.println(“Construct()方法被调用”);
}
}
3、 Stateful Session Bean（有状态Bean）
（1）Stateless Session Bean创建在对象池中，提供给众多用户使用，如果Bean class有自己的成员属性（变量），那么这些变量就会受到所有调用它的用户的影响。在一些应用场合中，有时需要每个用户都有自己的一个实例，这个实例不受其他用户的影响。就好比购物车对象，每个用户都应有自己的购物车，谁都不希望有人往自己的购物车里添加或拿掉商品，而有状态Bean正好满足满足了这种需求。每个有状态的Bean在Bean实例的生命周期内都只服务一个用户，Bean class的成员变量可以在不同的方法调用间维护特定于某个用户的数据。正因为在Bean实例的生命周期内Stateful Session Bean保持了用户的信息，所以叫有状态的Bean。
（2）Stateful Session Bean必须实现Serializable接口，这样EJB容器才能在它们不再使用时，把它们序列化保存到硬盘上。
（3）有状态Bean定义实例如下：
业务接口：Cart.java
import java.io.Serializable;
import java.util.List;
public interface Cart extends Serializable {
public void AddBuyItem(String productName);
public List<String> getBuyItem();
}
Bean类：
import java.util.ArrayList;
import java.util.List;

import javax.ejb.Remote;
import javax.ejb.Stateful;
import com.foshanshop.ejb3.Cart;

@SuppressWarnings("serial")
@Stateful
@Remote(Cart.class)
public class CartBean implements Cart{
private List<String> buyitem = new ArrayList<String>();

public void AddBuyItem(String productName) {
buyitem.add(productName);
}

public List<String> getBuyItem() {
return buyitem;
}

}
（4）Stateful Session Bean的生命周期有3个状态，如有兴趣自己研究。
三、实体Bean（Entity Bean）
1、什么是实体Bean
创建实体Bean的目的为了实现持久化，EJB3.0遵循的持久化规范是Java Persistence API，即JPA。JPA定义了一种方法，可以将常规的Java对象映射到数据库。这些普通的Java对象被叫做Entity Bean。其实除了用JPA元数据将其映射到数据库外，Entity Bean与其他Java类没有任何区别。就是我们熟悉的POJO。
2、Entity Bean介绍
（1）Entity Bean必须用@ Entity注明。
（2）Entity Bean必须用@id唯一标示主键。
（3）如果实体Bean对象需要返回客户端，必须实现 Serializable接口。
（4）通过在Entity Bean中加注释可以表示表和表的关联，例如：一对多要用@OneToMany来表示。
（5）JPA还提供了好多注解来实现别的功能，希望大家仔细研究。
3、Entity Bean的实例
import java.io.Serializable;
import java.util.Date;

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;
import javax.persistence.Table;
import javax.persistence.Temporal;
import javax.persistence.TemporalType;
import javax.persistence.GenerationType;

@SuppressWarnings("serial")
@Entity
@Table(name = "Person")
public class Person implements Serializable{

private Integer personid;
private String name;
private boolean sex;
private Short age;
private Date birthday;

@Id
@GeneratedValue(strategy=GenerationType.AUTO)
public Integer getPersonid() {
return personid;
}
public void setPersonid(Integer personid) {
this.personid = personid;
}

@Column(nullable=false,length=32)
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}

@Column(nullable=false)
public boolean getSex() {
return sex;
}
public void setSex(boolean sex) {
this.sex = sex;
}

@Column(nullable=false)
public Short getAge() {
return age;
}
public void setAge(Short age) {
this.age = age;
}

@Temporal(value=TemporalType.DATE)
public Date getBirthday() {
return birthday;
}

public void setBirthday(Date birthday) {
this.birthday = birthday;
}
}
4、 实体Bean的管理器EntityManaager
EntityManaager可以用来添加、删除、更新实体Bean，通过主键查找实体Bean。
EntityManaager管理实体Bean的实例如下：
import java.util.List;
import javax.ejb.Remote;
import javax.ejb.Stateless;
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;
import javax.persistence.Query;

import com.foshanshop.ejb3.PersonDAO;
import com.foshanshop.ejb3.bean.Person;

@Stateless
@Remote (PersonDAO.class)
public class PersonDAOBean implements PersonDAO {
@PersistenceContext
protected EntityManager em;

public void insertPerson(Person person) {
em.persist(person);
}

public Person getPersonByID(int personid) {
return em.find(Person.class, personid);
}

public void mergePerson(Person person) {
em.merge(person);
}

@SuppressWarnings("unchecked")//关闭unchecked警告
public List<Person> getPersonList() {
Query query = em.createQuery("select o from Person o order by o.personid asc");
return (List<Person>) query.getResultList();
}

public void deletePerson(int personid) {
Person person = em.find(Person.class, personid);
if(person!=null) em.remove(person);
}

public void updateName(String newname, int personid) {
Person person = em.find(Person.class, personid);
if(person!=null) person.setName(newname);
}
}
5、 EntityManaager操作数据的方式
（1）利用EntityManaager提供的方法对实体Bean操作。
#用find()或getReference()方法得到实体。
例如：
@PersistenceContext
protected EntityManager em;

public Person getPersonByID(int personid) {
return em.find(Person.class, personid);
}
#用persist()方法保存实体
例如：
@PersistenceContext
protected EntityManager em;

public void insertPerson(Person person) {
em.persist(person);
}


#用merger()方法更新实体
例如：
@PersistenceContext
protected EntityManager em;

public void mergePerson(Person person) {
em.merge(person);
}
#用remoove()方法删除实体
例如：
@PersistenceContext
protected EntityManager em;

public void deletePerson(int personid) {
Person person = em.find(Person.class, personid);
if(person!=null) em.remove(person);
}
（2）操作实体Bean通过EJB QL
EJB QL是JPA提供的一种声明性的查询语言，它可以直接操作实体Bean。相当于我们熟悉的HSQL语句。
javax.persistence.Query是EJB3查询操作的接口。进行查询，首先要通过EntityManager 获得Query对象。
EntityManager为执行EJB QL语句提供了两种方法，createQuery（String ejbqlString）和createNamedQuery（String name）。
createQuery（）方法得实例如下：
@PersistenceContext
private EntityManager em;
public List findByName（String first，String last）{
Query query = entityManager.createQuery( "select o from Customer o where o.firstName = : first and o.lastName = : last" );
query.setParameter( " first ", first );
query.setParameter( " last ", " last " );
return query. getResultList();
}
createNamedQuery（）如何使用请参考相关的文档。
（3）查询数据通过原生SQL
EntityManager为执行原生的SQL提供了三种方式，createNativeQuery（String sqlString），createNativeQuery（String sqlString，Class resultClass），createNativeQuery（String sqlString，String resultSetMapping）。
createNativeQuer（String sqlString，String resultSetMapping）方式实例如下：
@PersistenceContext
private EntityManager em;
Query query = entityManager. createNativeQuery ( "select p.phone_pk,p. phone_number, p.type from phone p ", Phone.class );
其他的两种方式请参考相关文档。