J2EE编程起步
J2EE编程起步
胡德平（[email protected]， www.JavaUnion.org ）
【编按】为了帮助国内J2EE初学者，将J2EE部分文档进行编译，期望能够对广大Java爱好者有所帮助。如有需要对发布在JavaUnion.org论坛中文章发表或转载需求，请与作者联系。
本文将通过简单例子，描述如何利用EJB开发、部署和运行一个客户机/服务器应用。例子的客户端作为Java独立应用运行，由ConverterClient.java类实现。它实现一个简单的实时会话，主要通过客户端应用调用服务器端EJB类ConverterEJB.java来实现。如果你已经安装了J2EE，则可以在doc/guides/ejb/examples/converter目录中找到这些例子。
为了实现本文所描述的简单例子，你需要完成以下任务：
·编写和编译EJB程序
·创建J2EE应用
·打包EJB（.jar）
·部署J2EE应用
·编写和编译客户端程序
·运行客户端
下面章节我们将就上述工作任务以及所涉及的知识点进行简单阐述。
前提
实现本文提供例子的前提是您安装了Javasoft.com或相关操作系统厂商网站下载的J2SE SDK，以及安装了相应操作系统版本的J2EE SDK(www.javasoft.com下载)并进行了正确配置。关于J2SE和J2EE的安装、配置和其它进一步信息，请参阅产品相关文档。
EJB编码
每个EJB程序必须要求编写下述代码：
·远程接口（Remote interface ）
·本地接口（Home interface ）
·实现组件（Enterprise bean class ）
远程接口编码
远程接口定义了客户端能够调用的商业方法，这些商业方法是有服务器端的企业组件实现的，本文所涉及的Converter.java编码如下：
import javax.ejb.EJBObject;//引入必须的包
import java.rmi.RemoteException;
public interface Converter extends EJBObject {//必须继承EJBObject类
/*定义客户端可以调用的方法*/
public double dollarToYen(double dollars) throws RemoteException;
public double yenToEuro(double yen) throws RemoteException;
}
本地接口编码
本地接口定义了员徐客户端创建、查找或移动EJB的方法，本文所涉及的本地接口类ConverterHome接口只定义了一个create方法，返回远程接口类型，编码如下：
import java.io.Serializable;
import java.rmi.RemoteException;
import javax.ejb.CreateException;
import javax.ejb.EJBHome;
public interface ConverterHome extends EJBHome {
Converter create() throws RemoteException, CreateException;
}
企业组件类（EJB）编码
本文中的企业组件（EJB）是一个无状态会话组件，命名为ConverterEJB.java，该组件实现了两个商业方法：dollarToYen和yenToEuro，与远程接口Converter所定义客户端可访问方法一致，该类编码如下：
import java.rmi.RemoteException;
import javax.ejb.SessionBean;
import javax.ejb.SessionContext;
public class ConverterEJB implements SessionBean {
public double dollarToYen(double dollars) {
return dollars * 121.6000;
}
public double yenToEuro(double yen) {
return yen * 0.0077;
}
public ConverterEJB() {}
public void ejbCreate() {}
public void ejbRemove() {}
public void ejbActivate() {}
public void ejbPassivate() {}
public void setSessionContext(SessionContext sc) {}
}
编译EJB
现在需要对上述三个类进行编译，在UNIX平台和NT/9X平台上的编译略有区别，分别如下编译：
UNIX:
1. 在下面的脚本compileEJB.sh中，将该成实际J2EE安装目录。
#!/bin/sh
J2EE_HOME=
CPATH=.:$J2EE_HOME/lib/j2ee.jar
javac -classpath "$CPATH" ConverterEJB.java ConverterHome.java Converter.java
2. 运行compileEJB.sh 脚本
Windows:
1. 在下面的compileEJB.bat批处理文件中，将 该为实际J2EE安装目录。
set J2EE_HOME=
set CPATH=.;%J2EE_HOME%\lib\j2ee.jar
javac -classpath %CPATH% ConverterEJB.java ConverterHome.java Converter.java
2. 运行批处理文件compileEJB.bat。
创建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服务器没有运行。
J2EE编程起步
胡德平（[email protected]， www.JavaUnion.org ）
【编按】为了帮助国内J2EE初学者，将J2EE部分文档进行编译，期望能够对广大Java爱好者有所帮助。如有需要对发布在JavaUnion.org论坛中文章发表或转载需求，请与作者联系。
本文将通过简单例子，描述如何利用EJB开发、部署和运行一个客户机/服务器应用。例子的客户端作为Java独立应用运行，由ConverterClient.java类实现。它实现一个简单的实时会话，主要通过客户端应用调用服务器端EJB类ConverterEJB.java来实现。如果你已经安装了J2EE，则可以在doc/guides/ejb/examples/converter目录中找到这些例子。
为了实现本文所描述的简单例子，你需要完成以下任务：
·编写和编译EJB程序
·创建J2EE应用
·打包EJB（.jar）
·部署J2EE应用
·编写和编译客户端程序
·运行客户端
下面章节我们将就上述工作任务以及所涉及的知识点进行简单阐述。
前提
实现本文提供例子的前提是您安装了Javasoft.com或相关操作系统厂商网站下载的J2SE SDK，以及安装了相应操作系统版本的J2EE SDK(www.javasoft.com下载)并进行了正确配置。关于J2SE和J2EE的安装、配置和其它进一步信息，请参阅产品相关文档。
EJB编码
每个EJB程序必须要求编写下述代码：
·远程接口（Remote interface ）
·本地接口（Home interface ）
·实现组件（Enterprise bean class ）
远程接口编码
远程接口定义了客户端能够调用的商业方法，这些商业方法是有服务器端的企业组件实现的，本文所涉及的Converter.java编码如下：
import javax.ejb.EJBObject;//引入必须的包
import java.rmi.RemoteException;
public interface Converter extends EJBObject {//必须继承EJBObject类
/*定义客户端可以调用的方法*/
public double dollarToYen(double dollars) throws RemoteException;
public double yenToEuro(double yen) throws RemoteException;
}
本地接口编码
本地接口定义了员徐客户端创建、查找或移动EJB的方法，本文所涉及的本地接口类ConverterHome接口只定义了一个create方法，返回远程接口类型，编码如下：
import java.io.Serializable;
import java.rmi.RemoteException;
import javax.ejb.CreateException;
import javax.ejb.EJBHome;
public interface ConverterHome extends EJBHome {
Converter create() throws RemoteException, CreateException;
}
企业组件类（EJB）编码
本文中的企业组件（EJB）是一个无状态会话组件，命名为ConverterEJB.java，该组件实现了两个商业方法：dollarToYen和yenToEuro，与远程接口Converter所定义客户端可访问方法一致，该类编码如下：
import java.rmi.RemoteException;
import javax.ejb.SessionBean;
import javax.ejb.SessionContext;
public class ConverterEJB implements SessionBean {
public double dollarToYen(double dollars) {
return dollars * 121.6000;
}
public double yenToEuro(double yen) {
return yen * 0.0077;
}
public ConverterEJB() {}
public void ejbCreate() {}
public void ejbRemove() {}
public void ejbActivate() {}
public void ejbPassivate() {}
public void setSessionContext(SessionContext sc) {}
}
编译EJB
现在需要对上述三个类进行编译，在UNIX平台和NT/9X平台上的编译略有区别，分别如下编译：
UNIX:
1. 在下面的脚本compileEJB.sh中，将该成实际J2EE安装目录。
#!/bin/sh
J2EE_HOME=
CPATH=.:$J2EE_HOME/lib/j2ee.jar
javac -classpath "$CPATH" ConverterEJB.java ConverterHome.java Converter.java
2. 运行compileEJB.sh 脚本
Windows:
1. 在下面的compileEJB.bat批处理文件中，将 该为实际J2EE安装目录。
set J2EE_HOME=
set CPATH=.;%J2EE_HOME%\lib\j2ee.jar
javac -classpath %CPATH% ConverterEJB.java ConverterHome.java Converter.java
2. 运行批处理文件compileEJB.bat。
创建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服务器没有运行。
