EJB3.0简介

1．依赖注入(dependency injection)

A．依赖注入之@EJB：

@EJB注释，其常用属性如下：

beanName：指定EJB的类名(不带包名),

mappedName：指定Bean实例的JNDI名。

    例如：

        @EJB(beanName=”A”)

        IA a;

    A 就是IA 的实现类，如果IA 的实现只有一个，那么这里可以不指定。

   B．依赖注入之@Resource

@Resource注释，注入来自JNDI的任何资源。

例如：

@Resource (mappedName="java:/DefaultMySqlDS")

DataSource myDb;

"java:/DefaultMySqlDS"是数据源DefaultMySqlDS的全局JNDI名。如果JNDI对象在本地(java:comp/env)JNDI目录中，则只需给定它的映射名称即可。

2．实体Bean

一 个实体Bean 由实体类和persistence.xml 文件组成。persistence.xml 文件在Jar 文件的META-INF 目录。persistence.xml 文件指定实体Bean 使用的数据源及EntityManager 对象的默认行为。persistence.xml文件的配置说明如下：

<persistence>

<persistence-unit name="xxx">

<jta-data-source>java:/ MySqlDS</jta-data-source>

<properties>

<property name="hibernate.hbm2ddl.auto" value="create-drop"/>

</properties>

</persistence-unit>

</persistence>

persistence-unit 节点可以有一个或多个，每个persistence-unit 节点定义了持久化内容名称、使用的数据源名称及Hibernate 属性。name 属性用作设置持久化名称。jta-data-source 节点用作指定实体Bean 使用的数据源名称，指定数据源名称时java:/ 前缀不能缺少，数据源名称大小写敏感。properties 节点用作指定Hibernate 的各项属性，如果hibernate.hbm2ddl.auto的值设为create-drop，在实体Bean 发布及卸载时将自动创建及删除相应数据库表。

 

注意： 在编写EJB的实体bean时一定要注意，必须有一个无参的构造函数，当然如果你没写任何构造函数，java会自动给你一个默认的无参的构造函数的。但是 当你自己写了有参数的构造函数时，千万别忘记了加上一个无参的构造函数，最好的习惯就是在建类的就把无参构造函数写上，这样就不会出错了。（以前在写 Hibernate的bean时其实也有这么一条原则的，只是当时写的那些bean从没写过有参的构造函数，所以一时没有发现这条原则）。

 

A．写在类声明之前的有：

a．@Entity,以表明此Bean为EntityBean。

b．@Table(name=”TableName”),表示此实体Bean对应的数据库表名。

B．写在getXxx（）方法声明之前的有：

a．@Column注释定义了映射到列的所有属性,如列名是否唯一，是否允许为空，是否允许更新等，他的属性介绍如下：

· name: 映射的列名。如：映射Person表的PersonName列，可以在name属性的getName 方法上面加入@Column(name = "PersonName")，如果不指定映射列名，容器将属性名称作为默认的映射列名。

·unique: 是否唯一

·nullable: 是否允许为空

·length: 对于字符型列，length属性指定列的最大字符长度

·insertable: 是否允许插入

·updatable: 是否允许更新

·columnDefinition: 定义建表时创建此列的DDL

·secondaryTable: 从表名。如果此列不建在主表上（默认建在主表），该属性定义该列所在从表的名字。

b．@Id 注释指定personid属性为表的主键，它可以有多种生成方式：

·TABLE：容器指定用底层的数据表确保唯一。

·SEQUENCE：使用数据库的SEQUENCE 列来保证唯一

·IDENTITY：使用数据库的INDENTIT列来保证唯一

·AUTO：由容器挑选一个合适的方式来保证唯一

·NONE：容器不负责主键的生成，由调用程序来完成。

c．@GeneratedValue注释定义标识字段的生成方式。

 

3．复合主键(Composite Primary Key)

当需要使用多个属性变量（表中的多列）联合起来作为主键时，我们需要使用复合主键。复合主键要求我们编写一个复合主键类( Composite Primary Key Class )。复合主键类需要符合以下一些要求：

·复合主键类必须是public，必须具备一个没有参数的构造函数

·复合主键类的每个属性变量必须有getter/setter，如果没有，每个属性变量则必须是public或者protected

·复合主键类必须实现java.io.Serializable接口

·复合主键类必须重写equals()和hashcode()方法

·复合主键类中的主键属性变量的名字必须和对应的EntityBean中主键属性变量的名字相同

·一旦主键值设定后，不要修改主键属性变量的值

 

4．JBoss的目录结构

安装JBoss会创建下列目录结构：

目录              描述

bin                       启 动 和关闭JBoss的脚本

client                    客户端与JBoss通信所需的Java 库（JARs）

docs                     配置的样本文件（数据库配置等）

docs/dtd                      在JBoss中使用的各种XML文件的DTD。

lib              一些JAR，JBoss启动时加载，且被所有JBoss配置共享。（不要把你的放在这里）

server           各种JBoss配置。每个配置必须放在不同的子目录。子目录的名字表示配置的名字。JBoss包含3 个默认的配置：minimial，default和all，在你安装时可以进行选择。

server/all        JBoss的完全配置，启动所有服务，包括集群和IIOP。(本教程就采用此配置)

server/default     JBoss 的默认配置。在没有在JBoss 命令航中指定配置名称时使用。(本教程没有安装此配置，如果不指定配置名称，启动将会出错)

server/all/conf   JBoss的配置文件。

server/all/data    JBoss的数据库文件。比如，嵌入的数据库，或者JBossMQ。

server/all/deploy  JBoss的热部署目录。放到这里的任何文件或目录会被JBoss自动部署。EJB、WAR、EAR，甚至服务。

server/all/lib      一些JAR，JBoss在启动特定配置时加载他们。(default和minimial配置也包含这个和下面两个目录。)

server/all/log      JBoss的日志文件

server/all/tmp      JBoss的临时文件。

 

5．持久化实体管理器EntityManager

EntityManager 是由EJB容器自动地管理和配置的，通常声明方式如下：

@PersistenceContext(unitName="xxx")

EntityManager em;

unitName属性的值xxx对应persistence.xml文件中的<persistence-unit name="xxx">元素的name属性的值。如果只有一个持久化内容配置，不需要明确指定。

其常用的API如下：

A.     增加数据：persist（）方法

B.       删除数据：remove（）方法

C.       修改数据：merge（）方法

D.      查询数据：find（）方法

E．执行EJB3 QL 操作：createQuery（）方法

 

6．会话Bean

在类名前声明：

@Stateless 注释定义这是一个无状态会话Bean

@Remote 注释指明Bean的remote 接口

@Local 注释指明Bean的local接口

@Stateful 注释定义这是一个有状态会话Bean

@SuppressWarnings("serial") 注释屏蔽缺少serialVersionUID 定义的警告

 

注意：Stateless Session Bean 与Stateful Session Bean 的区别

这 两种Session Bean都可以将系统逻辑放在方法之中执行，不同的是Stateful Session Bean可以记录呼叫者的状态，因此一个使用者会有自己的一个实例。Stateless Session Bean虽然也是逻辑组件，但是他却不负责记录使用者状态，也就是说当使用者呼叫 Stateless Session Bean的时候，EJB 容器并不会寻找特定的Stateless Session Bean的实体来执行这个method。换言之，很可能数个使用者在执行某个Stateless Session Bean的methods时，会是同一个Bean

的实例在执行。从内存方面来看，Stateful Session Bean与Stateless Session Bean比较，Stateful Session Bean会消耗J2EE Server 较多的内存，然而Stateful Session Bean的优势却在于他可以维持使用者的状态。

 

如何改变Session Bean 的JNDI 名称：

默认的JNDI命名规则前面已经介绍过，但有些情况下需要自定义名称。要自定义JNDI名称，可以使用@LocalBinding 和 @RemoteBinding 注释：

@LocalBinding注释指定Session Bean的Local接口的JNDI名称，

@RemoteBinding注释指定Session Bean的Remote接口的JNDI名称

例如，在类声明之前加上：

@Stateless

@Remote ({RemoteOperation.class})

@RemoteBinding (jndiBinding="xxx/RemoteOperation")

@Local ({LocalOperation.class})

@LocalBinding (jndiBinding="yyy/LocalOperation")

 

Session Bean 的生命周期:

通过使有下面所列的注释，EJB 3.0允许你将任何方法指定为回调方法。EJB 3.0中，bean可以有任意数量，任意名字的回调方法。

·@PostConstruct：当bean对象完成实例化后，使用了这个注释的方法会被立即调用。这个注释同时适用于有状态和无状态的会话bean。

·@PreDestroy：使用这个注释的方法会在容器从它的对象池中销毁一个无用的或者过期的bean 实例之前调用。这个注释同时适用于有状态和无状态的会话bean。

·@PrePassivate： 当一个有状态的session bean实例空闲过长的时间，容器将会钝化(passivate)它，并把它的状态保存在缓存当中。使用这个注释的方法会在容器钝化bean实例之前调 用。这个注释适用于有状态的会话bean。当钝化后，又经过一段时间该bean 仍然没有被操作，容器将会把它从存储介质中删除。以后，任何针对该bean方法的调用容器都会抛出例外。

·@PostActivate：当客户端再次使用已经被钝化的有状态session bean时，新的实例被创建，状态被恢复。使用此注释的session bean会在bean的激活完成时调用。这个注释只适用于有状态的会话bean。

·@Init： 这个注释指定了有状态session bean初始化的方法。它区别于@PostConstruct注释在于：多个@Init注释方法可以同时存在于有状态session bean 中，但每个bean实例只会有一个@Init注释的方法会被调用。这取决于bean是如何创建的（细节请看EJB 3.0规范）。@PostConstruct在@Init之后被调用。

·@Remove: 对于有状态session bean。当应用通过存根对象调用使用了@Remove注释的方法时，容器就知道在该方法执行完毕后，要把bean实例从对象池中移走。

 

拦截器(Interceptor):

拦截器可以监听程序的一个或所有方法。拦截器对方法调用流提供了细粒度控制。可以在无状态会话 bean、有状态会话 bean 和消息驱动 bean 上使用它们。拦截器可以是同一 bean 类中的方法或是一个外部类。

@Interceptors 注释指定一个或多个在外部类中定义的拦截器。例如：

@Interceptors({Xxx.class})

public class A implements IA{

       …

       …

}

在此Xxx拦截器对A类中的所有方法进行拦截。

在Xxx类中，使用

@AroundInvoke 注释指定了要用作拦截器的方法。用@AroundInvoke注释指定的方法必须遵守以下格式：

public Object xxx（InvocationContext ctx) throws Exception

xxx 代表方法名可以任意。

 

除了可以在外部定义拦截器之外，还可以将Session Bean 中的一个或多个方法定义为拦截器。只需一个

@AroundInvoke 注释就指定了要用作拦截器的方法。其定义规则如上所述。

 

 

7．JBoss数据源的配置

Jboss 有一个默认的数据源DefaultDS，它使用Jboss内置的HSQLDB数据库。实际应用中你可能使用不同的数据库，如MySql、 MsSqlServer、Oracle等。各种数据库的数据源配置模版你可以在[Jboss安装目录]/docs/examples/jca 目录中找到，默认名称为：数据库名+ -ds.xml 。

不管你使用那种数据库都需要把他的驱动类Jar 包放置在[Jboss 安装目录]/server/all/lib 目录下，放置后需要启动Jboss服务器。

 

8．关系/对象映射

A．一对多：

@OneToMany指明关联关系为一对多关系，下面是@OneToMany 注释的属性：

1>targetEntity

Class 类型的属性。定义关系类的类型，默认是该成员属性对应的类类型，所以通常不需要提供定义。

2>mappedBy

String 类型的属性。

定义类之间的双向关系。如果类之间是单向关系，不需要提供定义，如果类和类之间形成双向关系，我们就需要使用这个属性进行定义，否则可能引起数据一致性的问题。

3>cascade

CascadeType[]类型。

该属性定义类和类之间的级联关系。定义的级联关系将被容器视为对当前类对象及其关联类对象采取相同的操作，而且这种关系是递归调用的。举个例子：Order 和OrderItem 有级联关系，那么删除Order 时将同时删除它所对应的OrderItem对象。而如果OrderItem还和其他的对象之间有级联关系，那么这样的操作会一直递归执行下去。cascade 的值只能从CascadeType.PERSIST（级联新建）、CascadeType.REMOVE（级联删除）、CascadeType.REFRESH

（级联刷新）、CascadeType.MERGE（级联更新）中选择一个或多个。还有一个选择是使用CascadeType.ALL，表示选择全部四项。

4>fatch

FetchType 类型的属性。

可选择项包括：FetchType.EAGER和FetchType.LAZY。前者表示关系类(本例是OrderItem类)在主类(本例是Order类)加载的时候同时加载，后者表示关系类在被访问时才加载。默认值是FetchType. LAZY。

@OrderBy(value = "id ASC")注释指明加载OrderItem 时按id 的升序排序。

 

       B．多对一：

@ManyToOne 注释，有四个属性：targetEntity、cascade、fetch 和optional，前三个属性的具体含义和@OneToMany注释的同名属性相同，但@ManyToOne 注释的fetch 属性默认值是FetchType.EAGER。

optional 属性是定义该关联类对是否必须存在，值为false 时，关联类双方都必须存在，如果关系被维护端不存在，查询的结果为null。值为true 时, 关系被维护端可以不存在，查询的结果仍然会返回关系维护端，在关系维护端中指向关系被维护端的属性为null。optional属性的默认值是true。 举个例：某项订单(Order)中没有订

单项 (OrderItem)，如果optional 属性设置为false，获取该项订单（Order）时，得到的结果为null，如果optional属性设置为true，仍然可以获取该项订单，但订单中 指向订单项的属性为null。实际上在解释Order 与OrderItem的关系成SQL时，optional属性指定了他们的联接关系

optional=false 联接关系为inner join,

optional=true 联接关系为left join。

@JoinColumn(name = "order_id")注释指定OrderItem 映射表的order_id 列作为外键与Order 映射表的主键列关联。

 

    C．一对一：

@OneToOne 注释，有五个属性：targetEntity、cascade、fetch、optional 和mappedBy, 前四个属性的具体含义与@ManyToOne 注释的同名属性一一对应， fetch 属性默认值是FetchType.EAGER。mappedBy属性的具体含义与@OneToMany 注释的同名属性相同。

如果optional = true 设置表明此属性可以为null,例如在身份证的处理时可以这样设置，因为未成年人就是没有身份证的。

 

D．多对多：

@ManyToMany 注释：表示此类是多对多关系的一边，mappedBy 属性定义了此类为双向关系的维护端，注意：mappedBy 属性的值为此关系的另一端的属性名。例如，在Student类中有如下方法：

            @ManyToMany(mappedBy = "students")

public Set<Teacher> getTeachers() {

return teachers;

}

那么这里的“students”就是Teachers的一个属性，通常应该是这样的：

Set<Student> students;

另一端的getStudents方法如下所示：

                            @ManyToMany(cascade = CascadeType.PERSIST, fetch = FetchType.LAZY)

@JoinTable(name = "Teacher_Student",

joinColumns = {@JoinColumn(name = "Teacher_ID", referencedColumnName = "teacherid")},

inverseJoinColumns = {@JoinColumn(name = "Student_ID", referencedColumnName ="studentid")})

public Set<Student> getStudents() {

return students;

}

@ManyToMany 注释表示Teacher 是多对多关系的一端。@JoinTable 描述了多对多关系的数据表关系。name 属性指定中间表名称，joinColumns 定义中间表与Teacher 表的外键关系。上面的代码中，中间表Teacher_Student的Teacher_ID 列是Teacher 表的主键列对应的外键列，inverseJoinColumns 属性定义了中间表与另外一端(Student)的外键关系。

 

9．查询

A． 位置参数查询，格式为：“?+位置编号”，例如：

        Query query = em.createQuery("select p from Person p where p.personid=?1");

query.setParameter(1,new Integer(1));

B． 命令参数查询，格式为：“: +参数名”，例如：

Query query = em.createQuery("select p from Person p where p.personid=:Id");

query.setParameter("Id",new Integer(1));

C．排序(order by)

"ASC"和"DESC"分别为升序和降序，如果不显式注明，EJB3 QL中默认为asc升序。

    D．查询中使用构造器(Constructor)

EJB3 QL支持将查询的属性结果直接作为一个java class的构造器参数，并产生实体作为结果返回。例如：

Query query = em.createQuery("select new com.foshanshop.ejb3.bean.SimplePerson(p.name,p.sex) from Person p order by p.personid desc");

//集合中的元素是SimplePerson对象

List result = query.getResultList();

         E．EJB3 QL也支持查询中的聚合函数。目前EJB3 QL支持的聚合函数包括：

1. AVG()

2. SUM()

3. COUNT()

4. MAX()

5. MIN()

用法与SQL里面的一样。

         F．group by，having，where等关键字的用法。和SQL语法一样。

    G．关联(join)

在EJB3 QL中，仍然支持和SQL中类似的关联语法：

a．left out join/left join

b．inner join

c．left join/inner join fetch

left out join/left join等，都是允许符合条件的右边表达式中的Entities 为空。需要显式使用left join/left outer join的情况会比较少。

inner join要求右边的表达式必须返回Entities。

left/left out/inner join fetch提供了一种灵活的查询加载方式来提高查询的性能。在默认的查询中，Entity中的集合属性默认不会被关联，集合属性默认是缓加载( lazy-load )

         H．比较Entity：

在查询中使用参数查询时，参数类型除了String, 原始数据类型( int, double等)和它们的对象类型( Integer, Double等),也可以是Entity的实例。例如：

Query query = em.createQuery("select o from Order o where o.ower =?1 order by o.orderid");

Person person = new Person();

person.setPersonid(new Integer(1));

//设置查询中的参数

query.setParameter(1,person);

I．                not in，between，in，like，exists，is null，is empty等关键字的用法。

J．字符串函数

EJB3 QL定义了内置函数方便使用。这些函数的使用方法和SQL中相应的函数方法类似。EJB3 QL中定义的字符串函数包括：

a. CONCAT          字符串拼接

b. SUBSTRING     字符串截取

c. TRIM                      去掉空格

d. LOWER            转换成小写

e. UPPER             转换成大写

f. LENGTH           字符串长度

g. LOCATE          字符串定位

       K．计算函数

EJB3 QL中定义的计算函数包括：

ABS 绝对值

SQRT 平方根

MOD 取余数

SIZE 取集合的数量

注意：size的用法，例如：

Query query = em.createQuery("select o.orderid, size(o.orderItems) from Order as o group by o.orderid");

 

10．事务管理服务

最 有用的容器服务可能就是事务管理服务，当应用出现失败或异常时，它保证了数据库的完整性。你可以简单地将为一个POJO 方法申明它的事务属性。这样容器就可以在合适的上下文中运行这个方法。最常见的事务是定义在session bean的方法上，方法中所有的数据库操作只有在方法正常退出时才会提交，如果方法抛出未捕获的异常，事务管理将回滚所有的变更。

@TransactionAttribute 注释用作定义一个需要事务的方法。例如：

    @TransactionAttribute(TransactionAttributeType.REQUIRED)

public void insertProduct(String name, Float price, boolean error) {

       …

       …

}

它可以有以下参数：

1.REQUIRED:方法在一个事务中执行，如果调用的方法已经在一个事务中，则使用该事务，否则将创建一个新的事务。

2.MANDATORY:方法必须在一个事务中执行，也就是说调用的方法必须已经有一个事务，否则新抛出一个错误（ERROR）。

3.REQUIRESNEW:方法将在一个新的事务中执行，如果调用的方法已经在一个事务中，则暂停旧的事务。

4.SUPPORTS:如果方法在一个事务中被调用，则使用该事务，否则不使用事务。

5.NOT_SUPPORTED：如果方法在一个事务中被调用，将抛出一个错误（ERROR）

如果没有指定参数，@TransactionAttribute 注释使用REQUIRED 作为默认参数。

 

11．Entity的生命周期和状态

在EJB3 中定义了四种Entity的状态:

1. 新实体(new)。Entity由应用产生，和EJB3 Persistence运行环境没有联系，也没有唯一的标示符(Identity)。

2. 持久化实体(managed)。新实体和EJB3 Persistence运行环境产生关联（通过persist(), merge()等方法)，在EJB3 Persistence运行环境中存在和被管理，标志是在EJB3 Persistence运行环境中有一个唯一的标示(Identity)。

3. 分离的实体(detached)。Entity有唯一标示符，但它的标示符不被EJB3 Persistence运行环境管理, 同样的该Entity也不被EJB3 Persistence运行环境管理。

4. 删除的实体(removed)。Entity被remove()方法删除，对应的纪录将会在当前事务提交的时候从数据库中删除。