作者：胡德平 hudeping@263.net

 

创建J2EE应用

你不能够直接将企业组件(EJB)部署到J2EE服务器，必须将组件加到一个J2EE 应用中然后再部署。在本节，你将创建一个叫做ConverterApp的新J2EE应用并保存为ConverterApp.ear。

1. 在命令行提示符下启动J2EE服务器：

j2ee ?verbose
(停止服务器命令 j2ee -stop.)

2. 在另一个终端窗口运行部署工具：

deploytool
(按F1获取部署工具帮助)

3. 创建新的J2EE应用

a. 在部署工具中选择“文件”菜单
b. 从“文件”菜单中选择“新应用”
c. 点击浏览
d. 在文件选择框中定位存放.ear文件的目录
e. 文件命名为ConverterApp.ear.
f. 点击“新应用”
g. 点击“确定”

企业组件（EJB）打包

本部分你将运行部署工具的创建EJB向导来完成下述任务：

·创建组件部署描述符
·将描述符和组件类打包为.jar文件
·将EJB.jar文件打包到J2EE应用ConverterApp.ear 文件

从“文件”菜单中选择创建EJB来开始创建新的EJB，这个向导将显示下面的对话框：

介绍对话框：

a. 阅读向导特性说明文档
b. 点击“下一步”

EJB JAR 对话框:

a. 在标有"Enterprise Bean will go in," 的组合框中选择ConverterApp.
b.在JAR Display Name域输入ConverterJAR，声明EJB .jar文件包含该组件，该名字会在树形应用结构中呈现。
c. 点击增加内容文本域
d. 在内容编辑对话框顶部，输入包含.class文件的目录
e. 选择该目录下相关.class加入：Converter.class, ConverterEJB.class, 和ConverterHome.class.
f. 点击确定
g. 点击下一步

综合对话框：

a. 在组件类型中选择“会话”
b. 选择“无状态”
b. 在EJB类组合框中选择ConverterEJB.
c. 在本地接口组合框中选择ConverterHome.
d. 在远程接口组合框中选择Converter.
e. 在企业组件命名域中输入ConverterBean.
f. 点击下一步

环境入口对话框：

因为你可以跳过后面的对话框，所以可以点击完成结束创建EJB应用任务。

部署J2EE应用

现在J2EE应用中已经包含企业组件(EJB)了，可以对其进行部署。

1.指定企业组件的JNDI名字
a. 在应用部署波农工具中，在应用树形结构中选择ConverterApp
b. 选择JNDI名字标签
c. 在JNDI 名字域中，输入MyConverter并确认。 客户端将使用该名字来定位本地接口。

2.部署J2EE应用
a. 从工具菜单中选择“部署”
b. 在第一个对话框中选择ConverterApp为部署对象，Localhost为目标服务器
c. 选择标有"Return Client Jar." 的选择框
d. 在文本域中敲入ConverterAppClient.jar的确切目录，如J2EE的例子目录doc/guides/ejb/examples/converter
e. 点击下一步
f. 在第二个对话框中，核实ConverterBean 的JNDI命名为MyConverter.
g.点击下一步
h. 在第三个对话框中点击结束
i. 在部署进程对话框中，点击OK完成部署

开发客户端

客户端程序ConverterClient是一个独立运行的Java应用，创建ConverterClient主要包括以下步骤：

1. 客户端编码
2. 客户端编译

客户端编码

ConverterClient.java 源码展示了EJB客户端最基本的任务实现，即：

·定位本地接口
·创建企业组件（EJB）
·调用商业方法

定位本地接口

ConverterHome接口定义了EJB声明周期方法如create，在中ConverterClient 可以调用create方法之前ConverterHome对象必须被实例化，包括三个步骤：

1. 创建JNDI命名上下文
Context initial = new InitialContext();

2. 查找与JNDI命名MyConverter绑定的对象
java.lang.Object objref = initial.lookup("MyConverter");

3. 限定指向ConverterHome对象的参考
ConverterHome home =
(ConverterHome) PortableRemoteObject.narrow(objref,
ConverterHome.class);

创建企业组件（EJB）实例

客户端通过调用本地接口ConvertHome对象的create方法创建ConverterEJB类对象， create 方法返回组件Converter类型的对象。然后，远程方法定义的在ConverterEJB实现的商业方法可以被客户端调用。当客户端调用create 方法时，EJB容器将实例化ConverterEJB，然后调用ConverterEJB.ejbCreate 方法。

Converter currencyConverter = home.create();

调用商业方法

完成上述任务后，调用商业方法就比较简单了。你调用Converter对象的方法， EJB容器将相应的调用运行在J2EE服务器中的ConverterEJB 实例的方法。客户端调用商业方法dollarToYen的代码如下：

double amount = currencyConverter.dollarToYen(100.00);

ConverterClient源码

下面是ConverterClient.java的完整源码：

import javax.naming.Context; import javax.naming.InitialContext; import javax.rmi.PortableRemoteObject; import Converter; import ConverterHome; public class ConverterClient { public static void main(String[] args) { try { Context initial = new InitialContext(); Object objref = initial.lookup("MyConverter"); ConverterHome home = (ConverterHome)PortableRemoteObject.narrow(objref, ConverterHome.class); Converter currencyConverter = home.create(); double amount = currencyConverter.dollarToYen(100.00); System.out.println(String.valueOf(amount)); amount = currencyConverter.yenToEuro(100.00); System.out.println(String.valueOf(amount)); currencyConverter.remove(); } catch (Exception ex) { System.err.println("Caught an unexpected exception!"); ex.printStackTrace(); } } }

编译客户端代码

UNIX:

1. 在下面脚本compileClient.sh, 对 根据J2EE实际安装目录作相应改动。

#!/bin/sh
J2EE_HOME=
CPATH=.:$J2EE_HOME/lib/j2ee.jar


javac -classpath "$CPATH" ConverterClient.java

2. 运行脚本文件compileClient.sh

Windows:

1. 在下面批处理文件compileClient.bat中，对根据实际J2EE安装目录进行修改。

set J2EE_HOME=
set CPATH=.;%J2EE_HOME%\lib\j2ee.jar

javac -classpath %CPATH% ConverterClient.java

2. 运行批处理文件compileClient.bat

运行客户端

运行客户端你需要ConverterAppClient.jar文件，该文件包含允许客户端与EJB容器中EJB实例通信所需的存根类， ConverterAppClient.jar 文件在部署J2EE应用过程中创建。

UNIX:

1. 在下面脚本testClient.sh, 对 根据J2EE实际安装目录作相应改动。

#!/bin/sh
J2EE_HOME=
CPATH=$J2EE_HOME/lib/j2ee.jar:ConverterAppClient.jar:.
java -classpath "$CPATH" ConverterClient

2. 运行脚本文件testClient.sh

Windows:

1. 在下面批处理文件testClient.bat中，对根据实际J2EE安装目录进行修改。

set J2EE_HOME=
set CPATH=.;%J2EE_HOME%\lib\j2ee.jar;ConverterAppClient.jar
java -classpath "%CPATH%" ConverterClient

2. 运行批处理文件 testClient.bat

常见问题处理

当运行ConverterClient 时发现下面错误：

1. java.lang.ClassCastException
可能无法找到ConverterAppClient.jar文件。

2. java.lang.NoClassDefFoundError: ConverterClient
无法定位ConverterClient.class 文件。

3. java.lang.NoClassDefFoundError: javax/naming/Context
无法找到所需的j2ee.jar 文件，确认CLASSPATH设置。

4. javax.naming.NameNotFoundException: Lookup of name MyConverter failed.
J2EE服务器无法定位JNDI名字MyConverter所绑定的组件。

5. javax.naming.NamingException: Error accessing repository: Cannot connect to ORB at . . . .
J2EE服务器没有运行。