欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

【翻译】深入浅出 EJB3.1(上)

程序员文章站 2022-03-13 23:31:44
...

终于有空将EJB3.1的最新文章与大家分享,原文请看:

http://www.theserverside.com/tt/articles/article.tss?l=EJB3-1Maturity

 

已经更新:【翻译】深入浅出 EJB3.1(下)

 

 

 

引言

 

 

Enterprise Java Beans( 简称 EJB) Java Enterprise Edition( 简称 Java EE) 平台上的服务端组件架构模型,目标极力于快速并简化分布式,事务处理,安全以及便携式的应用程序。

 

EJB 在其 2.* 时代也叱诧风云过,由于能够解决许多企业应用程序的需求而被广泛采纳。但这只是 EJB 成功的表象,越来越多的质疑声开始抨击 EJB 的复杂。“缺乏好的持久层策略,又臭又长的布署描述符,能力有限的单元测试”等等这些常用却又不好用的技术导致了大量开发人员开始寻找新的“*”。

 

Sun 的反应的确有些迟钝,但还是它花费大量精力来修订规范,使得 EJB 得到很大的改观。 EJB3 摈弃了许多现有的缺点,呈现给开发人员的解决方案在社区中大受好评。 EJB 又一次变成了切实可行的解决方案,并且现在已经有许多放弃它的团队,再次接收 EJB

 

虽然它成功了,但 EJB3 还没有当初预计的那么理想。反观 EJB2.1 ,新规范要面对两个主要的挑战:

 

1.   为了改变 EJB2.1 现有的特性, ( 比如说需要强大的持久层框架来代替 Entity Beans ;支持使用 Annotation 来代替布署描述符;抛弃 home interface 等等。 ) ,需要进行大量的重建工作。

2.   为了引入新的解决方案,需要加入原先规范中没有的新技术。(比如说支持 Singletons ;支持方法拦截;支持异步调用;改进并增强现有的 Timer Service 特性

 

对于 EJB ,优先考虑的就是全部重建。“我们只有先清空杯子里的水,才能接纳新的东西”。现在杯子已经清空了,这对我们来说是非常有利的,而且还可以没有包袱的大胆前进。

 

EJB3.1 又一次引入了一系列新的特性,倾向于挖掘技术的潜力。依我来看, EJB3.1 绝对是一个重要的发布版本,它将那些长期让人渴望的特性带到开发者面前,更加能够满足最新的企业应用程序开发,同时对 EJB 再次被人们采纳将做出巨大的贡献。

 

近期, EJB 3.1 提议最终草案已经发布了,现在我们已经非常接近最终发行版了。本文会贯穿大多数新的特性,对每一个新特性都有会有一定程度的介绍。

 

 

 

No-Interface View( 非接口视图 )

 

EJB3.1 引入了 no-interface view 的概念——将一个 bean 的所有的 public method 通过一个 Local View 暴露出来。 ( 具体访问可见参见本文后面的 Global JNDI names ) Session Beans 并不强迫你再去实现任何接口。 EJB 容器提供一个指向 no-interface view 的引用实现,允许客户端调用该 bean 的任何 public method ,并且 no-interface view 也可以确保事务,安全以及拦截的行为与原先的用法一致。

 

通过 non-interface view ,所有 bean public method( 当然也包括定义在其父类上的 public method) 都是可用的。一个客户端可以通过依赖注入或 JNDI lookup 得到该 view 的引用,用起来感觉就好像它是 local remote view 一样。

 

但与 local remote view 不同的是, local remote view 必须与其所实现的的业务接口同时存在 ,而 no-interface view 的引用则只是 bean 这个类本身。注意, no-interface view 不再依赖于接口

 

下面的代码样例说明了一个 servlet 使用 no-interface view 是一件多么容易事啊。这个被引用的 no-interface view 叫作 ByeEJB ,其实就是一个普普通通的 JavaBean 。该 EJB 并未实现任何接口,也没有提供什么多余的布署描述符。最后但并不是最不重要的一点就是,这里 EJB 引用的获得使用了依赖注入进行简化。

 

 

ByeServlet

(...)
@EJB
private ByeEJB byeEJB;

public String sayBye() {
    StringBuilder sb = new StringBuilder();
    sb.append("<html><head>");
    sb.append("<title>ByeBye</title>");  
    sb.append("</head><body>");
    sb.append("<h1>" + byeEJB.sayBye() + "</h1>");
    sb.append("</body></html>");
    return sb.toString();                       
} 
(...)

ByeEJB
@Stateless
public class ByeEJB {

    public String sayBye() {
        return "Bye!";
    }   
}

 

 

 

实际上如果引用类型为 java 类而不是接口的话,还是有些硬性的限制条件:

 

l          客户端永远无法使用 new 操作符来获得引用。 ( 很明显如果是你自己 new 出来的, EJB 容器自然无法托管 )

 

l          除了 public method 外,如果其它方法如果出错,也会抛出 EJBException 异常。

 

l          一个指向该 view 的引用可以作为任何本地接口或其它 no-interface view 方法的参数进行传递或返回。

 

 

如果 bean 没有暴露任何 local remote view ,则容器必须默认提供一个可用的 no-interface view 。如果 bean 提供了至少一个 local remote view ,则窗口不会提供 no-interface view( 除非使用 @LocalBean 显式要求提供 ).

 

 

Bean 和其父类的所有 public method 都会通过 no-interface view 被暴露出来。这也意味着任何 public callback method 也会暴露出来,因此在使用的时候要注意这一点。

 

本特性避免了接口的编写,简化了程序的开发(实际上并不是所有的类都需要接口)。也许在不久的将来还会加入 remote no-interface view

 

 

 

Singleton

 

 

大多数的应用程序都有过至少需要一个 singleton bean( 对每个应用程序来说,它意味着只需要初始化一次 ) 的经历。许多供应商已经满足了这方面的需求,通过使用描述布署符来限定一个 bean 所允许的最大实例数量。供应商这种“各自为政”的方式破坏了 JAVA 到处宣扬的“一次编写,到处布署”的口号,因此迫切的再推出一套类似特性的规范来很有必要。 EJB 3.1 最终还是引入了 singleton session beans

 

现在主流的 session beans 有三类—— stateless stateful singleton Singleton session beans 可通过使用 Singleton Annotation 来标注,然后每个应用程序会确保只实例化一次。 Singleton session beans 支持与客户端共享,当然也支持并发访问 ( 后面有会具体谈到 )

 

singleton bean 的生命周期始于容器下列任意初始化阶段:

 

1.   直接实例化某个 singleton

2.   通过依赖注入实例化某个 singleton ,这样其依赖的那些 singleton 也会被跟着实例化,如此递推下去。

3.   通过执行 PostConstruct 回调

 

缺省情况下,容器有义务决定 singleton bean 何时被创建 ( 比如在 spring 中,默认是将所有的 singleton 在启动时就初始化 ) ,但是也允许开发人员使用 Startup annotation 在应用程序启动时,要求容器去对 singleton 进行初始化。此外, Startup annotation 还允许你去定义 singleton beans 之间的依赖关系。当容器开始处理任何客户端发过来的请示时,所有标注有 startup singletons 都必须初始化完成。

 

下面的代码样例大致演示了依赖是如何实现的。 singleton A 的没有使用 @Startup 也没有别的 singleton 依赖于它,于是 A 的实例化由容器来决定 ( 说白了,此时 A 的实例化由具体 EJB 实现来决定,规范没有硬性规定 ) singleton B 在应用程序启动过程中被实例化,但必须早于 singleton D singleton E( 很明显,没有 B 的实例, C D 可能都无法正常初始化 ) 。即使这个时候的 B 没有使用 @Startup ,但由于有其它的 singletons 依赖于它,它还是要先实例化的。 singleton C 由于使用了 @Startup ,它会在应用程序启动过程中被实例化,但必须比 singleton E 先完成。同理 D 也必须在 E 之前完成实例化。因此, E 是应用程序中会最后一个被初始化。 ( 注意,再重申一下 A 是否会初始化与供应商的实现有关,也许供应商的实现是预先加载,也许是延迟加载,但当你真正使用 A 的时候,肯定会保证被初始化了 )

 

 

@Singleton
public class A { (...) }

@Singleton
public class B { (...) }

@Startup
public class C { (...) }

@Startup(DependsOn="B")
@Singleton
public class D { (...) }

@Startup(DependsOn=({"C", "D"})
@Singleton
public class E { (...) }

 

 

 

有一点需要注意的是,如果一个 bean 依赖于多个 bean 的注入,那么这些被依赖的 beans 之间的初始化时机是不确定的。 E 依赖于 C D ,并没有说 C 一定要在 D 之前被实例化,除非 D 本身也是依赖于 C 的。

 

singleton 可以 @Startup 定义依赖于现存其它模块中的 singletons

 

当应用程序关闭时,容器有义务执行 singletons PreDestory 回调,将所有的 singletons 全部销毁。这个时候,启动时候的依赖关系在销毁时变得有意义了,比如说 A 依赖于 B ,当 A 被销毁时, B 还是存活的,刚好与初始化相反。

 

Singleton bean 会维护服务端与客户端调用而产生的状态,但当应用程序关闭或容器挂掉时,该状态并不会保存下来。 ( 大家一定想到这种情况如果使用序列化机制将状态保存下来,然后当程序再次启动时,再反序列化还原状态也是一种选择。不过,至于你 singleton 中装的是什么内容,是否需要被序列化,是否可以被序列化对容器来说还是未知数,所以干脆挂就挂吧。 ) 为了处理服务端与客户端的并发调用问题,开发人员必须定义一个并发策略。规范中定义了两种方式:

 

l          CMC(Container-managed concurrency 容器托管的并发机制 ) :顾名思义,由容器来管理该 bean 实例的并发调用。这也是 EJB 的默认策略。

 

l          BMC(Bean-managed concurrency  Bean 托管的并发机制 ) :容器此时并不会干涉该 bean 实例的并发,把并发的同步调用推回给开发人员。 BMC 允许使用合法的同步原语(如 synchronized volatile 关键字),来协调不同客户端不同线程对同一个 singleton 的并发访问。

 

( 呵呵,这不正是声明式与编程式的又一次实践吗 ? )

 

大多数情况下, CMC 肯定是首选。容器的管理并发问题时,还是使用“ Lock ( ) ”。每个方法都关联上一个 read lock write lock Read lock 表示应该方法可以尽可能的被多个线程并发调用,而 write lock 表示该方法在每次只能每一个线程访问。

 

缺省情况下, lock 的属性值是 write 。当然你可以通过使用 @Lock 来修改默认属性值。 @Lock 可以用于类,接口和方法。如其它 Annotation 类似, @Lock 也有继承性。在类级别使用 @Lock ,它的所有相关方法也会被应用上,除非你单独限制某一个具体的方法。

 

当某个方法持有 write lock 时,容器只允许其中一个并发线程去调用该方法。其它线程并必须等待,直到该方法再次变得可用。客户端的等待也许是无限期的,这个时候可以使用 @ AccessTimeout 来指定一个最大等待时间。如果超时了,会抛出 ConcurrentAccessTimeoutException 异常。

 

下面的代码示例中演示了如果使用 CMC Singleton A 明确指定为 CMC( 尽管这么没有必要,因为默认就是 CMC ,主要还是为了演示 ) Singleton B 并未定义任何并发策略,但按照规范,它还是属性 CMC 范畴,它的所有方法显示指定 CMC 使用 write lock 方式。 Singleton C Singleton B 几乎一模一样,只是使用的是 read lock 方式。 Singleton D Singleton C 一样,但是 D 中的 sayBye 方法重新定义为 write lock Singleton E 总要是演示 @AccessTimeout 的使用,当有因等待 E 中某方法而被阻塞的客户端超过 10 秒时,就会招出 ConcurrentAccessTimeoutException 异常。

 

 

 

@Singleton
@ConcurrencyManagement(CONTAINER) 
public class A { (...) }

@Singleton
@Lock(WRITE)
public class B { (...) }

@Singleton
@Lock(READ)
public class C { (...) }

@Singleton
@Lock(READ)
public class D { 
(...)
@Lock(WRITE)
public String sayBye() { (...) }
(...)
 }

@Singleton
@AccessTimeout(10000)
public class E { (...) }

 

 

如果是在集群环境下,当应用程序布署在不同的 JVM 上,则每个 JVM 都有该 singleton 的一个实例。

 

直到 EJB 3 ,任何由 EJB 抛出系统异常都会导致实例被废弃和销毁。但这个原则并不适用于 singleton beans ——它们必须一直存活下来,至少应用程关闭时才销毁。因此任何在业务对像方法或回调抛出系统异常时,业务对象并不会被销毁。

 

stateless beans 一样, singletons 也可以暴露成 web services

 

 

 

Asynchronous Invocations( 异步调用 )

 

 

Session beans 方法的异步调用是这些新特性中最重要的特性之一。它可以应用于所有类型的 session beans 。规范规定:在容器开始执行某个 bean 实例的调用之前,异步调用的控制权一定要返回给客户端。这又将 session beans 提高到了一个崭新的高度——使有潜在异步调用需求开发人员从 session beans 中获得更多好处,也允许客户端触发并行处理的流程。

 

通过使用 @ Asynchronous 就可以将一个类或方法标记为异步调用。下面的示例演示了该 annotation 不同场合下的应用。 Bean A 将其所有方法标注为异步; Singleton B 中,只有定义的 flushBye 方法才是异步的;对 stateless C 而言,所有的通过 local interface Clocal 接口调用的方法都是异步的;而通过 Cremote 接口调用却是同步的。因此,同一个方法还可能由于所引用的不同接口而表现出不同的行为。最后, bean D flushBye 肯定是异步的,于 Dlocal 是否是不是异步已经无关了。

 

 

@Stateless
@Asynchronous
public class A { (...) }

@Singleton
public class B { 
(...) 
    @Asynchronous
    public void flushBye() { (...) }
(...)
}

@Stateless
public class C implements CLocal, CRemote { 

    public void flushBye() { (...) }
}
@Local
@Asynchronous
public interface CLocal { 
    public void flushBye();
} 
@Remote
public interface CRemote { 
    public void flushBye();
} 

@Stateless
public class D implements DLocal { (...) }

@Local
public interface DLocal {
(...) 
    @Asynchronous
    public void flushBye();
(...)
}
 

 

 

注意异步方法调用的返回类型必须是 void Future<V> (其中 V 表示返回值的类型)。如果方法的返回值为 void ,则不允许声明任何应用程序异常。

 

Future 接口在 Java 5 中就被引入,提供四个主要方法:

 

  • cancel(boolean mayInterruptIfRunning) :尝试取消异步方法的执行。如果某个 bean 的实例方法还未开始调用,容器会尝试取消这个调用。如果为参数为 true:执行中的任务可以被interrupt;如果参数为false:允许这个任务执行完毕 。标志位“ mayInterruptIfRunning ”用于控制目标 bean 是否对客户端是否可见,免得该异步调用被客户端不小心给取消了。
  • get :当方法调用完成时,返回结果。该 get 方法有两个重载版本,一个是调用后一直处于阻塞状态,直到方法调用完成;另一个则可以设置一个超时的参数。
  • isCancelled :指示该方法是否被取消。
  •  isDone :指示该方法是否执行完成。

 

 

 

规范要求容器提供 AsyncResult<V> 类作为 Future<V> 接口的实现,它可以将执行后的返回结构作为构造函数的参数,请看下面代码:

 

@Asynchronous
public Future<String> sayBye() {
    String bye = executeLongQuery();
    return new AsyncResult<String>(bye);
}

 

 

 

Future<V> 的返回类型因不同的客户端角度而异。因此,如果在一个标有 @Asynchronous

接口中定义了方法 m ,那么请注意,只有这个接口中的方法允许返回类型为 Future<V> ,在其它别的非异步接口中的定义中不能带有 Future<V> ,只能返回普通的 V 注意 V 在这里表示的是泛型 )。请看下面示例:

 

 

@Stateless
public class ByeEJB implements ByeLocal, ByeRemote { 

    public String sayBye() { (...) }

}

@Local
@Asynchronous
public interface sayBye { 
    public Future<String> flushBye();
} 

@Remote
public interface ByeRemote { 
    public String sayBye();
} 

 

 

 

SessionContext 接口有一个 wasCancelCalled 方法,用于判断客户端是否调用了 Future cancel 方法。如果 Future cancel 方法的 mayInterruptIfRunning 参数设置为 true ,那么 wasCancelCalled 自然也会返回 true ,也就是说异步调用被终止了。(也就是说 SessionContext 可以用于判断某个异步方法是否被取消,提高程序的健壮性 )。请看代码示例:

 

@Resource
SessionContext ctx;

@Asynchronous
public Future<String> sayBye() {
    String bye = executeFirstLongQuery();
    if (!ctx.wasCancelCalled()){
        bye += executeSecondLongQuery();
    }
    return new AsyncResult<String>(bye);
}

 

 

( 下面代码似乎有笔误,根本无法通过编译 )

如果异步方法抛出了一个普通应用程序异常,则这个异常传播到客户端时必须为 ExecutionException 。原始的异常信息仍然可以通过调用 getCause 来获得的。

 

@Stateless
public class ByeEJB implements ByeLocal { 

    public String sayBye() throws MyException { 
        throw new MyException();
    }

}

@Local
@Asynchronous
public interface ByeLocal { 
    public Future<String> sayBye();
} 

//Client
@Stateless
public class ClientEJB { 

    @EJB
    ByeLocal byeEjb;

    public void invokeSayBye() { 
        try {
            Future<String> futStr = byeEjb.sayBye();
        } catch(ExecutionException ee) {
            String originalMsg = ee.getCause().getMessage();
            System.out.println("Original error message:" + originalMsg);
        }
    }

}

 

 

 

对于异步方法的执行,客户端的事务上下文并不会传播到。因此,当下列异步事务方法调用时,可以得到的结论分别为:

 

  • 如果方法 m 的事务属性定义为“ REQUIRED ”,那么它的表现形式将永远为“ REQUIRES_NEW ”。
  • 如果方法 m 的事务属性定义为“ MANDATORY ”,那么它的表现形式永远是抛出 TransactionRequiredException 异常。
  • 如果方法 m 的事务属性定义为“ SUPPORTS ”,那么它的表现形式永远是不会参与在事务上下文中。

 

 

 

对安全性的传播的也是同理。

 

-----------------------------------------------------------

文章有点长,后续部分会很快发出。 接下的内容包括:Global JNDI naming,Timer Service,EJB Lite,Simplified EJB Packaging,Embeddable EJB Containers等等。