JBoss3.0 下配置和部署EJB简介-CSDN博客

1．JBoss简介

JBoss 是一个运行 EJB 的 J2EE 应用服务器。它是开放源代码的项目，遵循最新的 J2EE 规范。从 JBoss 项目开始至今，它已经从一个 EJB 容器发展成为一个基于的 J2EE 的一个 web 操作系统（ operating system for web ），它体现了 J2EE 规范中最新的技术，并且它还在 the JavaWorld Editors' Choice 2002 评选中获得“最佳 Java 应用服务器”大奖。无论是学习还是应用， JBoss 为我们提供了一个非常优秀的平台。有关 JBoss 的详细信息请参阅其主页 http://www.jboss.org 。

刚开始使用 JBoss 进行 EJB 开发时，由于可供参考的资源不是很多，所以有一个比较困难的起步阶段。 JBoss 的配置和使用没有提供图形向导界面，所以开发部署 EJB 相对比较复杂。本文通过尽量具体的演示来对 JBoss3.0 下的 EJB 开发和部署的进行一个简单的介绍，从而使刚开始使用 JBoss 的用户可以很快地进入到真正的 J2EE 应用开发中。

由于本文主要介绍 JBoss3.0 中不同类型 EJB 的配置和部署，不对基本的 EJB 开发做太多的描述，所以希望读者具有 J2EE 和 EJB 的经验。想要了解有关信息请查阅参考资料 1 。

2．JBoss3.0中基本的ejb配置和部署

根据 J2EE 规范的要求，一个基本的 ejb jar 包使用的描述文件是 ejb-jar.xml 。 web 应用的 war 包使用的是 web.xml 。企业应用的 ear 包使用的是 application.xml 。这些配置文件都是中性的和平台无关的。同时应用服务器可以使用一些其他的配置文件用于描述特定服务器的相关信息。在 JBoss 中这样的文件有 jboss.xml ， jboss-web.xml 等。 JBoss 容器中这些文件不是必须的，如果提供了那么 jboss.xml 和 ejb-jar.xml 放在同一目录下， jboss-web.xml 和 web.xml 放在同一目录下。关于 jboss.xml 和 jboss-web.xml 的规范请参考 JBoss 安装目录下 docs/dtd/ 目录下的对应的 DTD 文件。

2．1 JBoss中关于EJB客户端的配置：

调用 EJB 的客户端可以是 JSP 、 Servlet 或客户端应用程序。如果客户端和服务器不在同一个 Java VM 上，那么在客户端必须提供一个 jndi.properties 文件告诉客户端进行有关 JNDI 命名服务的信息，并且把这个文件所在目录设定到环境变量 classpath 中。

以下是一个 jndi.properties 的样例：

java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory

java.naming.provider.url=localhost:1099  

(
服务器地址和端口号
)

java.naming.factory.url.pkgs=org.jboss.naming:org.jnp.interfaces

通过这个文件和 JBoss 的一些客户端类库，就可以使用 JBoss 提供的 EJB 对象服务了。

2．2 JBoss中部署EJB：

首先介绍 JBoss 容器中部署各类 EJB 对象的两种方法。下面的演示以 Session Bean 为例，客户端是一个本机上的 web 应用。这里不对演示程序进行具体介绍。

第一种方式：

把开发好的 ejb jar 包和 web 应用的 war 包公共放在 deploy 目录下。

演示 1 ：不需要 jboss.xml 文件和其他任何特殊的设置。

ejb-jar.xml:

<ejb-jar>

······

<ejb-name>ejbtest </ejb-name>

······

</ejb-jar>

客户端： web 应用中对 web.xml 不需要添加 ejb 信息，不需要 jboss-web.xml 文件。引用 ejb 对象的 jsp 文件如下：

······

InitialContext ctx = new InitialContext();

Object objref = ctx.lookup("ejbtest "); // 使用 <ejb-name> beanHome=(zcxejb1Home)PortableRemoteObject.narrow(objref,ejbtestHome.class);

······

演示 2 ：使用 jboss.xml 文件。

在缺省情况下 JBoss 的 JNDI 服务将通过 ejb-jar.xml 中 <ejb-name>XXX</ejb-name> 中的 XXX 来使用 EJB 的 home interface 。但是如果有多个 ejb 对象在相同的 ejb jar 包中，在 ejb-jar.xml 中通过 <ejb-name>XXX</ejb-name> 就可能不能很好的表示某一个 ejb 对象，所以一般我们希望可以提供一些附加的信息，例如采用这样的格式 "[ 应用名 ]/[bean 名 ]" 来引用一个 EJB 对象。这时 JNDI 服务就可能不能正确地找到你的 ejb 对象，我们就需要使用 jboss.xml 文件，通过它实现 jndi 名到 ejb 名的重定向。这个文件必须和 ejb-jar.xml 一起放到 META-INFO 目录下。

ejb-jar.xml:

<ejb-jar>

······

<ejb-name>ejbtest </ejb-name>

······

</ejb-jar>

jboss.xml:

<jboss>

<ejb-name>ejbtest </ejb-name>

<jndi-name>example/ejbtest </jndi-name>

</jboss>

客户端：需要使用新的 jndi 名进行 ejb 定位。

······

InitialContext ctx = new InitialContext();

Object objref = ctx.lookup("example/ejbtest "); // 使用 <jndi-name> beanHome=(zcxejb1Home)PortableRemoteObject.narrow(objref,ejbtestHome.class);

······

第二种方式：

把 ejb 和 web 应用包装成一个企业应用包。部署 ear 时可以简单地把通过 application.xml 描述 ejb jar 包和 web 应用的 war 包，同样在 web.war 中不需要提供特殊的信息就可以和第一种方式一样使用 ejb 对象。客户端代码也不需要进行改动。这里不再举例说明。

此外我们可以进行更进一步的部署，这时需要使用到 web.xml 和 jboss-web.xml 。 jboss-web.xml 是 JBoss 提供的一个针对 web 应用进行配置的文件。 jboss-web.xml 和 web.xml 一起放在 web 应用的 WEB-INF 目录下。

演示 1 ：改动 web.xml 文件，添加 <ejb-ref> 标记，不使用 jboss-web.xml 文件。

（注意 <ejb-ref> 包括内部引用和外部引用。如果是同一个单元的可以通过 <ejb-link> 直接进行引用，而不用提供其他信息。）

web.xml:

······

<ejb-ref>

<ejb-ref-name>ejb/ejbtest </ejb-ref-name>

<ejb-ref-type>Session</ejb-ref-type>

<home>org.zcx.test.zcxejb1Home</home>

<remote>org.zcx.test.zcxejb1</remote>

<ejb-link>ejbtest </ejb-link>

</ejb-ref>

······

客户端：由于在 web.xml 中引入 ejb 引用描述这时 ejb 定位发生了变化：

······

InitialContext ctx = new InitialContext();

Object objref = ctx.lookup("java:comp/env/ ejb/ejbtest "); // 使用 java:comp/env 命名空间 beanHome=(zcxejb1Home)PortableRemoteObject.narrow(objref,ejbtestHome.class);

······

演示 2 ：联合使用 web.xml 和 jboss-web.xml

web.xml

······

<ejb-ref>

<ejb-ref-name>ejb/ejbtest </ejb-ref-name>

<ejb-ref-type>Session</ejb-ref-type>

<home>org.zcx.test.zcxejb1Home</home>

<remote>org.zcx.test.zcxejb1</remote>

</ejb-ref>

······

jboss-web.xml

<ejb-ref>

<ejb-ref-name> ejb/ejbtest </ejb-ref-name>

<jndi-name> example/ejbtest </jndi-name>

</ejb-ref>

客户端：

nitialContext ctx = new InitialContext();

Object objref = ctx.lookup("java:comp/env/ ejb/ejbtest "); beanHome=(zcxejb1Home)PortableRemoteObject.narrow(objref,ejbtestHome.class);

以上的所有演示说明了 ejb-jar.xml 、 jboss.xml 、 web.xml 、 jboss-web.xml 之间的基本关系和它们的使用方式。它们是部署各类 ejb 对象的关键文件。接下来介绍针对不同类型的 ejb 对象所需要的特殊配置。

3．JBoss3.0中对于CMP2.0 Entity Bean的有关配置

JBoss3.0 中 JBossCMP 引擎实现了 EJB2.0 CMP2.0 规范。 JBoss3.0 以前的版本 CMP 的引擎是 Jaws ，它通过 standardjaws.xml 和 jaws.xml 进行有关的配置。在新的 JBossCMP 引擎中 Jboss3.0 通过 standardjbosscmp-jdbc.xml 和 josscmp-jdbc.xml 来配置 Entity Bean 。 JBoss3.0 首先处理 standardjbosscmp-jdbc.xml 然后根据 ejb jar 中是否提供 jbosscmp-jdbc.xml 来做进一步处理。通过 standardjbosscmp-jdbc.xml 和 jbosscmp-jdbc.xml 可以为 entity bean 的部署提供如下的功能有：

l 指定所使用的数据源和对应的类型映射

l 指定一些引擎关心的属性

l 指定引擎如何创建和管理数据库表的原则

l 描述 finder 和 ejbSelect 方法

l 指定属性和字段的类型映射

这里主要根据 standardjbosscmp-jdbc.xml/jbosscmp-jdbc.xml 介绍 CMP2.0 的配置方法。 JBoss 中原有的 Jaws 引擎的配置方法和新的 JBossCMP 的配置方法类似。这些文件的具体的信息可以参考 JBoss 安装路径下 /docs/dtd 中对应的 DTD 文件。

3．1增加新的数据源

JBoss 自带的数据库是 Hypersonic 数据库，我们可以增加一些新的数据源。具体的步骤很简单，参照 Jboss 安装目录下 /docs/examples/jca 中的 *-service.xml 文件可以增加找到对应类型的数据库配置样本文件。以 mysql-service.xml 文件为例，它可以配置一个 MySQL 数据库作为 Entity Bean 的数据源。以下演示创建一个名为 MySQLDS 的 MySQL 数据源。

图一是配置好的 mysql-service.xml 文件的一段代码样本，通过属性设置可以定制数据源的名称和有关连接的其他属性。注意该文件中所有 name 属性必须保持一致。

图一 mysql-servic.xml 的样本代码

在配置好这个文件后，把它部署在 JBoss 的 deploy 目录下，把对应的 jdbc 驱动也放在 lib 目录下。重新启动 Jboss 就会加载这个新的数据源。

3．2 Entity Bean 对数据源的使用

第一种方式：

直接改动 standardjbosscmp-jdbc.xml 。把原有的数据源 java:/DefautlDS 屏蔽掉使用新的数据源 java:/MySQLDS 。（ Java 前缀是必须的。）不需在其他地方作改动。 JBoss 会实现新的数据源做为缺省的数据源。图二是一个配置好的文件片断。

图二 standardjbosscmp-jdbc.xml 的样本代码

第二种方式：

由于有可能不同的 Entity Bean 使用不同的数据源，而不是都使用同样的缺省配置，所以必须为单独的 Entity Bean 提供定制数据源信息的支持。这时不需要改动 standardjbosscmp-jdbc.xml 文件，可以通过在 Entity Bean 的 jar 包中 META-INFO 目录下添加新的部署文件 jbosscmp-jdbc.xml 来完成。通过这个文件可以描述特定的 Entity Bean 的关于数据源的配置信息。图三是一个配置好的文件片断。

图三 jbosscmp-jdbc.xml 的样本代码

4．JBoss3.0中对于Message Driven Bean的配置

在 JBoss 中开发 MDB 需要使用 JMS 功能。 JMS 是 Sun 公司开发的面向消息的中间件 API 。它的主要目的是创造一种统一的面向消息编程的 JavaAPI ，从而避免使用提供商特定的 API 。现在有几种不同的 JMS 系统可供使用。 JBoss3.0 中提供的是 JBossMQ 。

4．1 JBoss3.0中配置JMS服务

在 JBoss3.0 中与 JMS 服务相关的配置文件包括两个文件： jbossMQ-service.xml 和 jbossMQ-destinations-service.xml 。 jbossMQ-service.xml 配置了 jbossMQ 服务中的核心对象信息。一般我们不需要处理这个配置文件。 jbossMQ-destinations-service.xml 用于定义具体应用所需的目的地信息。通过编辑它我们可以创建新的 Topic 和 Queue 用于具体的 JMS 应用的目的地。在 JBoss 中创建应用特定的 Topic 和 Queues 的步骤比较简单，参照 jbossMQ-destinations-service.xml 文件格式在该文件中添加自己应用程序所需的 Topic 名为 myTestAppTopic 和 Queue 名为 myTestAppQueue 。如图四所示。

图四 jbossMQ-destinations-service.xml 的样本代码

4．2 JBoss3.0中EJB使用JMS服务的配置

在开发 MDB 时要在部署文件中指定所使用的 JMS 服务中的目的地信息。 JBoss 中通过 ejb-jar.xml 和 jboss.xml 共同说明。在 jboss.xml 中通过 <destination-jndi-name> 标记描述所使用的目的地信息。

Ejb-jar.xml

<message-driven>

<ejb-name>HelloTopicMDB</ejb-name>

<ejb-class>org.zcx.test.HelloMDB</ejb-class>

<message-selector></message-selector>

<transaction-type>Container</transaction-type>

<message-driven-destination>

<destination-type>javax.jms.Topic</destination-type>

<subscription-durability>NonDurable</subscription-durability>

</message-driven-destination>

</message-driven>

jboss.xml

<message-driven>

<ejb-name>HelloTopicMDB</ejb-name>

<configuration-name>Standard Message Driven Bean</configuration-name>

<destination-jndi-name>topic/myAppTestTopic </destination-jndi-name>

</message-driven>

客户端：

······

Context context = new InitialContext();

// Get the connection factory

// Create the connection

// Create the session

······

// Look up the destination

topic = (Topic)context.lookup("topic/myTestAppTopic ");

// Create a publisher

// Publish the message

······

5．JBoss3.0中EJB使用JavaMail服务的配置。

由于 JBoss 提供了 JavaMail 服务的实现，所以在 JBoss 中使用 JavaMail 是非常方便地。它所需要配置的是 mail.service 文件。这个文件非常地简单不用多介绍。按照 mail.service 文件的的注释就可以顺利地完成配置。

图五是使用 JavaMail 服务的一个 sessionBean 的代码片断

图五使用 javamail 的样本代码

以上通过例子简单的介绍了 JBoss3.0 中 Session Bean 、 Entity Bean 和 Message Drive Bean 最基本的配置和部署方法，通过这些介绍现在已经可以在 JBoss 中进行基本的 EJB 应用的开发了。本文中对于 EJB 应用中比较复杂的一些配置像权限设置、资源管理和 CMP2.0 中的众多配置等都没有涉及到，希望大家可以在不断的实践和交流中更好地掌握 JBoss 的使用和配置。