JavaBean(EJB) 3.0 全新体验

　　引言

　　期待以久的ejb3.0规范在最近发布了它的初稿。在本文中将对新的规范进行一个概要性的介绍，包括新增的元数据支持，ejbql的修改，实体bean模型访问bean上下文的新方法和运行时环境等等。作者还讨论了ejb在未来要作出的调整以及ejb3.0与其他开发规范之间的关系。

　　开始

　　无论如何由于ejb的复杂性使之在j2ee架构中的表现一直不是很好。ejb大概是j2ee架构中唯一一个没有兑现其能够简单开发并提高生产力的组建。ejb3.0规范正尝试在这方面作出努力以减轻其开发的复杂性。ejb3.0减轻了开发人员进行底层开发的工作量，它取消或最小化了很多（以前这些是必须实现）回调方法的实现，并且降低了实体bean及o/r映射模型的复杂性。

　　在本文中，我首先会介绍ejb3.0中几个主要的改变。它对进一步深入了解ejb3.0是非常重要的。随后，我会从更高的层面来描述已经被提交到ejb3.0规范中的细节，并一个个的讲解新的规范中的改变：实体bean,o/r映射模型，实体关系模型和ejb ql(ejb查询语言)等等。

　　背景

　　ejb3.0中两个重要的变更分别是：使用了java5中的程序注释工具和基于hibernate的o/r映射模型。

　　java5中的元数据工具

　　java5（以前叫j2se1.5或tiger）中加入了一种新的程序注释工具。通过这个工具你可以自定义注释标记，通过这些自定义标记来注释字段、方法、类等等。这些注释并不会影响程序的语义，但是可以通过工具（编译时或运行时）来解释这些标记并产生附加的内容（比如部署描述文件），或者强制某些必须的运行时行为（比如ejb组件的状态特性）。注释的解析可以通过源文件的解析（比如编译器或这ide工具）或者使用java5中的apis反射机制。注释只能被定义在源代码层。由于所有被提交到ejb3.0草案中的注释标记都有一个运行时的retentionpolicy，因此会增加类文件占用的存储空间，但这却给容器制造商和工具制造商带来了方便。

　　hibernate

　　目前hibernate非常受欢迎，它是开发源代码的java o/r映射框架，目的是把开发人员从繁琐的数据持久化编程中解脱出来。它也有一个标准的hql（hibernate 查询语言）语言，你可以在新的ejb ql中看到它的影子。hibernate在处理如数据查询、更新、连接池、事务处理、实体关系处理等方面非常简单。

　　概览
　　
　　在已经提交的ejb3.0规范中主要涉及两个方面的改变：

　　1. 一套以注释为基础的ejb编程模型，再加上ejb2.1中定义的通过部署描述符和几个接口定义的应用程序行为。

　　2. 新的实体bean持久化模型，ejbql也有许多重要的改变。

　　还有一些有关上述的提议，比如：一个新的客户端编程模型，业务接口的使用以及实体bean的生命周期。请注意ejb2.1编程模型（包括部署描述符和home/remote接口）仍然是有效的。新的简化模型并没有完全取代ejb2.1模型。

　　ejb注释

　　ejb规范组织一个重要的目标是减轻原始代码的数量，并且他们为此给出了一个完美而简介的办法。在ejb3.0的里，任何类型的企业级bean只是一个加了适当注释的简单java对象(pojo)。注释可以用于定义bean的业务接口、o/r映射信息、资源引用信息，效果与在ejb2.1中定义部署描述符和接口是一样的。在ejb3.0中部署描述符不再是必须的了；home接口也没有了，你也不必实现业务接口（容器可以为你完成这些事情）。

　　比如，你可以使用@stateless注释标记类把java类声明为一个无状态回话bean。对于有状态回话bean来说，@remove注释可以用来标记一个特定的方法，通过这个注释来说明在调用这个方法之后bean的实例将被清除掉。

　　为了减少描述组件的说明信息，规范组织还采纳了由异常进行配置（configuration-by-exception）的手段，意思是你可以为所有的注释提供一个明确的缺省值，这样多数常规信息就可以据此推断得出。

　　新的持久化模型

　　新的实体bean也是一个加了注释的简单java对象(pojo)。一旦它被entitymanager访问它就成为了一个持久化对象，并且成为了持久化上下文（context）的一部分。一个持久化上下文与一个事务上下文是松耦合的；严格的讲，它隐含的与一个事务会话共存。

　　实体关系也是通过注释来定义的，o/r映射也是，并提供几种不同的数据库规范操作，在ejb2.1中这些要通过开发人员自己的设计模式或者其它技术来完成的（比如，自增长主键策略）。

　　深入研究

　　现在是时候详细了解ejb3.0草案了。让我们开始探讨所有ejb中四种企业级bean，并看看他们在新的规范中是什么样子。

　　无状态回话bean

　　在ejb3.0规范中，写一个无状态回话bean(slsb)只需要一个简单的java文件并在类层加上@stateless注释就可以了。这个bean可以扩展javax.ejb.sessionbean接口，但这些不是必须的。

　　一个slsb不再需要home接口，没有哪类ejb再需要它了。bean类可以实现业务接口也可以不实现它。如果没有实现任何业务接口，业务接口会由任意public的方法产生。如果只有几个业务方法会被暴露在业务接口中，这些方法可以使用@businessmethod注释。缺省情况下所有产生的接口都是local（本地）接口，你也可以使用@remote注释来声明这个接口为remote（远程）接口。

　　下面的几行代码就可以定义一个helloworldbean了。而在ejb2.1中同样的bean至少需要两个接口，一个实现类和几个空的实现方法，再加上部署描述符。

　　import javax.ejb.*;

　　/**
　　* a stateless session bean requesting that a remote business
　　* interface be generated for it.
　　*/
　　@stateless
　　@remote
　　public class helloworldbean {
　　public string sayhello() {
　　return "hello world!!!";
　　}
　　}

　　 有状态回话bean

　　除了几个sfsb的特别说明之外，有状态回话bean(sfsb)和slsb一样精简：

　　 一个sfsb应该有一个方法来初始化自己（在ejb2.1中是通过ejbcreate()来实现的）。在ejb3.0的规范中建议这些初始化操作可以通过自定义方法完成，并把他们暴露在业务接口中。在使用这个bean之前由客户端来调用相应的初始化方法。目前规范组织就是否提供一个注释来标记某个方法用于初始化还存在争议。

　　 bean的提供者可以用@remove注释来标记任何sfsb的方法，以说明这个方法被调用之后bean的实例将被移除。同样，规范组织仍然在讨论是否要有一种机制来处理这种特殊的情况，即当这个方法出现异常的情况下bean的实例是否被移除。

　　下面是对以上问题我个人的观点：

　　1) 是否应该有一个注释来标明一个方法进行初始化呢？我的观点是――应该有，这样容器就可以在调用其他方法之前至少调用一个方法来进行初始化。这不仅可以避免不必要的错误(由于没有调用初始化方法)而且可以使容器更明确的判断是否可以重用sfsb实例。我暂且把这个问题放一放，规范组织只考虑为一个方法提供一个注释来声明它是一个初始化方法。

　　2) 对于第二个问题我的观点也是肯定的。这有利于bean的提供者合客户端程序对其进行控制。只有一个遗留的问题：那就是一旦调用这个方法失败，是否能移除这个bean 的实例？答案是不能，但是它将会在回话结束的时候被移除。

　　消息驱动bean

　　消息驱动bean是唯一一种必须实现一个业务接口的bean。这个接口指出bean支持的是哪一种消息系统。对于以jms为基础的mdb来说，这个接口是javax.jms.messagelistener。注意mdb业务接口不是一个真正意义上的业务接口，它只是一个消息接口。

　　实体bean

　　 实体bean使用@entity注释来标记，所有实体bean中的属性/字段不必使用@transient注释来标记。实体bean的持久化字段可以通过javabean-style机制或者声明为public/protected字段来实现。

　　 实体bean可以使用助手类来描述其状态，但是这些类的实例并没有持久化唯一性（persistent identity）的特性(即，唯一标识这个bean的字段等)，实际上这些助手类与他们的实体bean实例是紧密结合的；并且这些对象还是以非共享方式来访问实体对象的。

　　实体关联

　　ejb3.0同时支持bean之间双向的合单向的关联，它们可以是一对一、一对多、多对一或者是多对多的关联。然而双向关联的两端还要分为自身端（owning side）和对方端（inverse side）不同的端。自身端负责向数据库通告关联的变更。对于多对多的关联自身端必须明确的声明。实际上对方端通过isinverse=true进行注释（由此自身端就不必说明了而是由另一段推断出）。看来上面的描述，规范组织还能说让ejb变的简单了吗？

　　o/r映射

　　ejb3.0中的o/r映射模型也有了重要的改变，它从原来的abstract-persistence-schema-based变成了现在的hibernate-inspired模式。尽管目前规范组织还在就此进行讨论但是一个明确的模型将会出现在下一个版本的草案中。

　　举例来说，o/r映射模型将通过bean类中的注释来声明。而且此方法还会指出对应的具体表和字段。o/r映射模型提供了一套自有的sql；而且除了提供一些基本的sql外还支持某些高层开发的功能。比如，有一个通过@column注释声明的字段columndefinition，那么可以写这样的sql：columndefinition="blob not null"

　　客户端程序模型

　　一个ejb客户端可以通过@inject注释以一种“注入”的方式获得一个bean的业务接口引用。你也可以使用另一个注释@javax.ejb.ejbcontext.lookup()来完成上面的操作，但是规范中没有告诉我们一个普通的java客户端怎样获得一个bean的实例，因为这个普通的java客户端是运行在一个客户端容器中，它无法访问@javax.ejb.ejbcontex对象。现在还有另外一种机制来完成上面的工作那就是使用一个超级上下文环境对象：@javax.ejb.context()。但是规范中没有指出该如何在客户端中使用这个对象。

　　ejb ql

　　ejb ql可以通过@namedquery来注释。这个注释有两个成员属性分别是name和querystring.一旦定义了这些属性，就可以通过entitymanager.createnamedquery(name)来指向这个查询。你也可以创建一个标准的jdbc风格的查询并使用entitymanager.createquery(ejbqlstring)或entitymanager.createnativequery(nativesqlstring)(这个方法用于执行一个本地查询)来执行查询。

　　ejb ql有两个地方可以定义其参数。javax.ejb.query接口提供了定义参数、指向查询、更新数据等等方法。下面是一个ejbql指向查询的例子：


　　.. ..
　　@namedquery(
　　name="findallcustomerswithname",
　　querystring="select c from customer c where c.name like :custname"
　　)
　　.. ..
　　@inject public entitymanager em;
　　customers = em.createnamedquery("findallcustomerswithname")
　　.setparameter("custname", "smith")
　　.listresults();


　　下面列出了一些ejb ql的增强特性：

　　1) 支持批量更新和删除。

　　2) 直接支持内连接和外连接。fetch join运行你指出关联的实体，order可以指定只查询某个字段。

　　3) 查询语句可以返回一个以上的结果值。实际上，你可以返回一个依赖的类比如下面这样：

　　select new customerdetails(c.id, c.status, o.count)
　　from customer c join c.orders o
　　where o.count > 100

　　4) 支持group by 和having。

　　5) 支持where子句的嵌套子查询。

　　在提交的ejb3.0草案中，ejb ql与标准sql非常的接近。实际上规范中甚至直接支持本地的sql(就像我们上面提到的那样)。这一点对某些程序员来说也许有些不是很清楚，我们将在下面进行更详细的讲解。

　　 　多样性

　　方法许可(method permissions)可以通过@methodpermissions或@unchecked注释来声明；同样的，事务属性也可以通过@transactionattribute注释来声明。规范中仍然保留资源引用和资源环境引用。这些一样可以通过注释来声明，但是有一些细微的差别。比如，上下文(context)环境要通过注入工具控制。容器根据bean对外部环境引用自动初始化一个适当的已经声明的实例变量。比如，你可以象下面这样获得一个数据源（datasource）：

　　@resource(name="mydatasource") //type is inferred from variable
　　public datasource customerdb;

　　在上面的例子中如果你不指定引用资源的名称(name)那么其中的customerdb会被认为是默认值。当所有的引用属性都可得到时，@injec注释就可以这样写：

　　@inject public datasource customerdb;

　　容器负责在运行时初始化customerdb数据源实例。部署人员必须在此之前在容器中定义好这些资源属性。

　　更好的消息是：那些以前必须检测的异常将一去不复返。你可以声明任意的应用程序异常，而不必在再抛出或捕获其他类似createexception和finderexception这样的异常。容器会抛出封装在javax.ejb.ejbexception中的系统级异常或者只在必要时候抛出illegalargumentexception或illegalstateexception异常。

　　ejb文件处理模式

　　在我们结束本节之前，让我的快速的浏览一下容器提供商在ejb处理模式方面可能的变更。规范中对此并没有明确的表态，但我可以想到至少两种模式。

　　 一种办法是首先利用ejb文件生成类似于ejb2.1部署模式的文件（包括必要的接口和部署描述符）然后再用类似于ejb2.1的方式来部署这个ejb组件。当然，这样产生的部署描述符可能并不标准但是它可以解决同一个容器对ejb2.1和ejb3.0兼容的问题。下面这幅图描述了这一过程。

　　 另一种方法是一种类似于jsp托放的部署模式。你可以把一个ejb文件放到一个预先定义的目录下，然后容器会识别这个ejb并处理它，然后部署并使之可以使用。这种方法可以建立于上面那种方法之上，在支持反复部署时有很大的帮助。考虑到部署的简单性也是ejb3.0规范的目的之一，我真诚的希望在下一个草案出来时能够确定一个模式(至少能有一个非正式的)。

　　你有什么想法？

　　ejb3.0规范的制定正在有序的进行，为了使ejb的开发变得更加容易，ejb规范组织作出的努力是有目共睹的。就像他们说的那样，一切对会变得简单，但做到这一点并不容易。目前已经定义了50个注释标记(还有几个将在下一个草案中发布)，每一个都有自己的缺省规则和其他的操作。当然，我真的不希望ejb3.0变成ejb2.1的一个翻版"ejb 3.0 = ejb 2.1 for dummies"（希望这个等式不要成立）。最后，我还是忍不住要提一些我自己的观点：

　　1) 首先，规范确实使反复部署变得容易了，并且有一个简单的模式来访问运行时环境。我还是觉得home接口应该放弃。

　　2) 在早期的ejb规范中，实体bean用于映射一个持久化存储。理论上(也许只是理论上)可能需要把实体bean映射到一个遗留的eis(enterprise information system)系统中。出于将来扩展的考虑这样作是有好处的，并且可以使更多的业务数据模型采用实体bean。也因此其伴随的复杂性使得实体bean不被看好。在本次提交的草案中，一个实体bean只是一个数据库的映射。并且是基于非抽象持久化模式和简单的数据访问模式的更加简单开发。

　　3) 我对模型变更持保留态度，我认为在ejb中包含sql脚本片断并不是个好注意。一些开发人员完全反对包含某些“sql片段（sqlness）”（比如@table 和 @column注释）。我的观点是这些sqlness是好的，据此我们可以清楚的知道我们到底要数据库作些什么。但是某些sql段我看来并不是很好，比如columndefinition="blob not null"，这使得ejb代码和sql之间的耦合太过紧密了。

　　4) 尽管对于本地sql的支持看似很诱人，其实在ejb代码中嵌入sql是一个非常糟糕的主意。当然，有些办法可以避免在ejb中硬编码sql，但是这应该在规范中说明，而不能是某些开发人员自己定义的模式。

　　5) 假设@table注释只用于类。在运行时通过@table注释的name属性定义的表名称将必须对应一个实际的数据库表。规范对此应该给予清楚的说明和一致的模式。

　　6) 规范还需要更清楚的说明客户端编程模型，尤其是普通java客户端。规范中所有的参考都假设或者隐含的使用ejb客户端。而且规范中对客户端的向后兼容方面也没有给出明确的说法。

　　7) transient注释应该重新命名以避免和已有的transient关键字发生冲突。事实上，在这一点上我们更乐于稍微的背离一下configuration-by-exception原则并且定义一个@persistent注释来明确的定义持久化字段。@persistent注释可以仅仅是一个标记注释或者它可以有几个属性来关联o/r映射注释。

　　与其他规范的关联

　　目前可能影响到ejb3.0的jsr有jsr175（java语言元数据工具）和jsr181（java web服务元数据）

　　jsr175已经初步完成并且不会和ejb3.0有太大的冲突；但是jsr181与ejb3.0有两个关联的地方：

　　1) web service接口：ejb规范将采用一种机制适应jsr181以便可以把一个bean实现为一个web service并告诉web service如何被客户端调用。

　　2) jsr 181计划采用不同的机制来处理安全问题。在早期的规范中ejb建议使用一个一致的机制（methodpermissions），但是jsr 181计划使用一个稍微不同的方式（securityroles和securityidentity注释）。同样的runas注释的定义也存在这些许差别。这一问题还在解决中最终会在j2ee层的规范中维持其一致性。

　　在j2ee 1.5中的一些开发规范可能与ejb3.0有关联。除了上面说到的几个关联之外现在没有其他的开发规范与ejb3.0有冲突。

　　结束语

　　在使ejb的开发变得简单高效之前，我们还有很长一段路要走。规范组织在降低ejb的开发难度方面起了个好头。o/r映射模型的提议还处在早期阶段，规范组织正在完善它。我希望它不要太复杂也不要与sql过分的耦合。让我们不要只是停留在期望、希望、思考和请求中：提出你的想法并把你的建议发送给规范组织[e-mail]。jcp并不是很*的组织，但是你的建议一定是有价值的。

　　本文的观点是作者的个人主张与作者所在的公司没有任何关系。作者非常感谢hemant khandelwal对发表此文的帮助。

　　提供下载的代码是ejb3.0草案的示例代码。由于没有工具和环境的支持这个例子是没有经过验证的。这些代码只是示例了未来的ejb3.0大概的样子。

　　anil sharma是bea system公司开发weblogic integration产品的资深程序员。在加入bea之前曾就职于oracle 和 pramati，并一直致力于研究j2ee技术。在业余时间它喜欢听音乐看电影；他还参加一些开源项目的开发工作。