| 订阅 | 在线投稿
分享
 
 
 

J2EE编程起步

来源:互联网  宽屏版  评论
2004-12-03 10:42:11

本文将通过简单例子,描述如何利用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服务器没有运行。

 
本文将通过简单例子,描述如何利用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服务器没有运行。
󰈣󰈤
 
 
 
>>返回首页<<
 
 热帖排行
 
 
 
静静地坐在废墟上,四周的荒凉一望无际,忽然觉得,凄凉也很美
©2005- 王朝网络 版权所有