技术文章 > J2EE编程起步

J2EE编程起步

2018-12-13 18:51

文档管理软件,文档管理系统,知识管理系统,档案管理系统的技术资料:
胡德平(hudeping@263.net, 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.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服务器没有运行。