¡¡
J2EE编程起步
创建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服务器没有运行。