本文将通过简单例子,描述如何利用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.valuesOf(amount));
?????amount = currencyConverter.yenToEuro(100.00);
?????System.out.println(String.valuesOf(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服务器没有运行。