作者：未知 来源：月光软件站 加入时间：2005-2-28　月光软件站

创建J2EE^TM应用程序客户端

J2EE应用程序客户端由Java^TM语言编写，在运行的时候，客户端程序和J2EE SERVER执行在不同的虚拟机(VM)中

在这个例子中，J2EE应用程序客户端需要两个不同的JAR文件.第一个JAR文件是客户端的J2EE组件.这个JAR文件包含客户端的deployment descriptor和它的类文件.当你运行New Application Client wizard,deploytool自动创建JAR文件然后把它存到应用程序的EAR文件中. 由J2EE规范定义的JAR文件可以方便的跨越所有兼容J2EE的服务器.

第二个JAR文件包含客户端程序运行时必需的stub类.这些stub类使客户端可以访问运行在J2EE server上的enterprise beans. Because this second JAR file is not covered by the J2EE Specifications, it is implementation-specific, intended only for the J2EE SDK.

J2EE应用程序客户端源代码在examples/src/ejb/converter/ConverterClient.java中.在这个章节中，你已经把它随同enterprise bean代码一起编译, 编译源码文件.

编写J2EE应用程序客户端

ConverterClient.java源代码说明了enterprise bean的客户端执行的基本任务:

• 定位home interface
• 创建enterprise bean实例
• 调用商务方法

定位Home Interface

ConverterHome接口定义象create一样具有生命周期的方法.在ConverterClient能调用create方法之前,它必须例示(instantiate)ConverterHome类型的对象. 它分为3步处理:

1. 创建JNDI naming context.

    Context initial = new InitialContext(); 
   

2. 取得绑定到ejb/SimpleConverter的对象.

   Object objref = initial.lookup
      ("java:comp/env/ejb/SimpleConverter"); 
   

3. Narrow the reference to a ConverterHome object.

    ConverterHome home =
       (ConverterHome) PortableRemoteObject.narrow(objref,
       ConverterHome.class); 
   

创建一个Enterprise Bean实例

要创建bean实例,客户端调用ConverterHome中的create方法并且返回一个Converter类型的对象.远程Converter接口定义客户端可以调用的在bean中的商务方法.当客户端调用create方法时,EJB容器例示(instantiates)bean然后调用ConverterBean.ejbCreate方法. 客户端调用create方法如下所示:

Converter currencyConverter = home.create(); 

调用商务方法

调用一个商务方法非常容易--你只是调用Converter对象上的方法。EJB容器将在运行于服务端的ConverterEJB实例上调用相应的方法. 下面一行代码是客户端调用dollarToYen上的商务方法.

double amount = currencyConverter.dollarToYen(100.00); 

ConverterClient源代码

完整的ConverterClient源码如下.

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
              ("java:comp/env/ejb/SimpleConverter");
           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();
       }
   } 
}  

编译应用程序客户端

应用程序客户端文件和enterprise bean文件同时被编译，可参考编译源文件中所述.

打包J2EE应用程序客户端

打包应用程序客户端组件, 你需要运行deploytool的New Application Client Wizard. 在这个过程中, 向导把客户端文件编译成一个JAR文件然后把这个JAR文件加到应用程序的ConverterApp.ear文件中.

启动New Application Client Wizard,选择File->New Application Client. 向导显示下面的对话框.

1. Introduction对话框:
   1. 阅读关于向导特性概览的说明.
   2. 单击 Next.
2. JAR File Contents对话框
   1. 在这个组合框中,选择 ConverterApp.
   2. 单击 Edit.
   3. 在Available Files目录树中, 定位到examples/build/ejb/converter目录.
   4. 选择ConverterClient.class file文件然后单击Add.
   5. 单击 OK.
   6. 单击 Next.
3. 常规对话框:
   1. 在Main Class组合框,选择 ConverterClient.
   2. 检验Display Name栏的内容是ConverterClient.
   3. 在Callback Handler Class组合框,选择 container-managed authentication.
   4. 单击 Next.
   5. 单击 Finish.

指定应用程序客户端的Enterprise Bean Reference

当调用lookup方法时,ConverterClient引用一个enterprise bean:

Object objref = initial.lookup
   ("java:comp/env/ejb/SimpleConverter"); 

如下指定reference:

1. 在树目录中,选择ConverterClient.
2. 选择EJB Ref's tab.
3. 单击 Add.
4. 在Coded Name列输入ejb/SimpleConverter.
5. 在Type列,选择 Session.
6. 在Interfaces列,选择Remote.
7. 在Home列输入ConverterHome.
8. 在Remote列输入Converter.

相关软件：