下载本文示例代码
p align="JUSTIFY"> 为了使大家对EJB容器和Enterprisebeans有一个感性的认识，我们介绍一个简单的client/server例子。就是Inprise的应用服务器自带的例子--SortClient。是一个无状态的会话beans，它实现了一个排序（sort）算法。本例子演示了如何编译Enterprise beans例子，如何在EJB容器中运行Bean的一些基本操作。还演示了如何将一个对象放在JNDI命名服务中。
首先，我们来看一下Enterprise bean的原代码。通常由Enerprise beans的提供者来编写。（sort例子已经提供了代码，所以我们实际上什么都不用写。*_^）。下面，我们演示如何编译和链接此Enterprise bean。如何配置，如何打包成应用程序。然后演示如何编译链接客户。最后才运行客户和服务程序。
以下是开发具有Enterprisebeans的C/S应用程序的一些基本的步骤。
编写Enterprise beans的代码，包括beans的代码中远程（remote）接口和本地（home）接口的代码。
编写客户端代码。
编译和链接源代码，包括beans的和客户的源代码。
在目录META-INF中产生一个配置描述器。
打包Enterprise bean。
将Enterprise bean配置到jar文件中。
运行客户端。
编写一个Enterprise bean：
所有的Enterprisebeans都由三个部分组成，都必须由Enterprisebeans的提供者编写。这三个部分是：
实现类implementation class：这是一个Enterprisebean类，包括Enterprise beans应用逻辑的实现、和本地（home）、远程（remote）接口的功能定义。对于Sort例子，实现类就是SortBean.java文件。
本地（home）接口：本地接口定义了createing，finding，removing Enterprise beans的操作。在我们这个例子中，本地接口就是SortHome.java文件。
远程（remote）接口：远程接口定义了一些对客户可用的应用逻辑的方法。由Enterprisebeans提供。本例中，远程接口就是Sort.java文件。
客户要能够调用Bean的应用逻辑方法，Bean必须由这三个组成部分。客户应用程序使用Home接口来定位beans的remote接口。一旦客户拥有了remote接口的引用(refereenece)，就? 调用在remote接口中声明的任何方法。客户并不知道方法是在本地还是在远程系统中执行。对客户而言，调用Enterprise beans的方法就和调用本地方法一样简单。EJB容器将远程调用传递给实际的Enterprisebeans的实例。控制所有的通信协议，并通过remote接口将返回值传给客户。
下图显示了当SortClient客户需要调用SortBean 会话bean的merge()方法的时候的可能发生的调用情况。注意，SortClient首先调用SortHome接口的Create()方法。返回了Sort的remote接口的一个引用。然后，客户端才调用Sort remote接口的merge()方法。方法传回了所需要的结果。
EJB 容器
Create Sort 的实例
Sort的引用
Merge函数
结果
例子Sort是一个无状态的会话bean。大多数的会话beans都有状态。在会话中，应客户的要求，容器产生一个bean的实例。并且在整个会话中，这个实例都为这个这个特定的客户服务。根据定义，一个有状态的会话bean在整个会话的过程中都保持着与客户的会话状态。
另一方面，无状态的状态bean并没有指向某一个特定的客户，也就是说，说它并没有保持着与客户会话的任何状态。当客户调用一个无状态的会话bean方法时，容器给客户指定一个在缓冲池中的beans实例为之服务。被指定的实例保持着方法有关的变量，一直到完成方法调用。实例在方法调用的时候就返回的状态是任意值。而自己却不保存任何的状态，也不再与调用它的客户相联系。容器可以将实例归还给实例缓冲池，也可以不归还给缓冲池而由系统自动处理。
编写本地（home）接口：
home接口定义了创建（create）,查找（find）,删除（remove）等方法。无状态会话bean的home接口要比有状态的会话bean或者实体bean的home接口要来得简单。SortHome的home接口扩展了javax.ejb.EJBHome接口，声明了create()方法。Create()方法没有参数，抛出两个异常：RemoteException和CreateException。
Create（）返回了一个类型为Sort的对象，它实际上是一个对remote接口的一个引用。注意，客户并没有直接调用beans实例的任何方法。客户只是调用了通过beans的remote接口调用在remote接口定义了的方法。
因为有状态的会话bean和实体bean保持了客户的状态，可以有多个方法来产生实例，可以传递初始的参数给Create()方法。而无状态的会话bean并不需要保存客户的状态，可以只有一个Create()方法。这个唯一的Create()方法不能含有任何参数。将beans实例从实例缓冲池中取消的方法是Remove()方法，这是从EJBHome中继承过来的，而不需要另外在SortHome的Home接口中声明。
Sorthome的home接口如以下代码所示：
//SortHome.java
public interface SortHome extends javax.ejb.EJBHome(
Sort create() throws java.rmi.RemoteException, javax.ejb.CreateExcepion;)
编写remote接口代码：
remote接口定义、发布了Enterprise bean的应用方法，使这些应用方法可以在客户端被调用。它扩展了javax.ejb.EJBObject接口。Remote接口中的每一个方法都必须与SortBean实现类中的声明相匹配。方法必须有同样的名字和标识。另外，在sort的remote接口中必须抛出java.rmi.RemoteException异常，必须返回有效的RMI类型。Sort的remote接口声明了两个方法：sort()和merge()。两个方法都抛出了java.rmi.RemoteException异常，都返回了Vector类型。如下代码就是Sort的Remote接口：
//Sort.java
import java.util.Vector;
public interface Sort extends javax.ejb.EJBObject{
Vector Sort(Vector v, Compare c) throws java.rmi.RemoteExcetpion;
Vector merge(Vector a, Vector b, Compare c) throws java.rmi.RemoteException;
}
编写会话bean的实现代码：
因为SortBean是一个会话bean。必须实现javax.ejb.SessionBean接口。同时也要注意，SortBean类要定义成公共的。
SortBean的实现类定义了一些应用方法可以供客户端调用。在这个例子中，SortBean定义了sort（）和merge（）两个方法的实现。运行客户应用程序时，将会调用两个方法。
一个会话bean实现了ejbCreate()的方法，并且与home接口中的Create()方法相对应。SortHome的home接口定义了一个无参数的Create()方法，抛出了一个java.rmi.RemoteException异常。但是，与Sorthome接口的create()方法不同，create()返回了一个sort类型的对象，而ejbCreate()方法返回的是void类型。
会话bean可以有一个公共的构造函数，而SortBean却不可以。SortBean除了创建和应用方法以外，另外有四个方法，它们是：ejbRemove()，ejbActivate()，ejbPassivate()，和setSessionContext()。容器拥有这些方法的句柄，在Sortbean里，只需要将这些方法声明为public并将返回值置为void。
下面是会话bean：SortBean的实现类的源代码：为简洁起见，我们并没有完全显示sort()方法和merge()方法的实现部分。也没有把调试信息给显示出来。
//SortBean.java
import java.util.Vector
public class SortBean implements javax.ejb.SessionBean{
public void setSessionContext {javax.ejb.SessionContext
sessionContext} {}
public void ejbCreate() throws java.rmi.RemoteException {}
public void ejbRemove() throws java.rmi.RemoteException {}
public void ejbActivate() throws java.rmi.RemoteException {}
public void ejbPassivate() throws java.rmi.RemoteException {}
public Vector sort (Vector v, Compare c) throws java.rmi.RemoteExcetpion{
try{
……
return result;
}
catch(javax.ejb.CreateException e){
throw new java.rmi.ServerException(“Could not create sort instance”,
e);
}
catch(javax.ejb.RemoveException e){
throw new java.rmi.ServerException(“Could not remove sort instance”,e);
}
}
public Vector merge(Vector a, Vector b, Compare c) throws java.rmi.RemoteException{
…….
}
}
}
编写客户端代码：
客户端程序SortClient,必须首先使用JNDI的API来定位Enterprise beans的Home接口。在下面的例子代码中，SortClient客户首先端生成了一个JNDI上下文，使用JDNI的的lookup方法来为sort定位home接口。
//SortClient.java
public class SortClient{
…
public static void main(String[] args) throw Exception{
java.name.Context context;
{ //get a JNDI context using the Naming Service
context = new java.naming.InitialContext{};
}
Object objref = {SortHome} context.lookup(“sort”);
SortHome home = {SortHome} javax.rmi.PotableRemoteObject.narrow{
Objref, SortHome.class}
Sort sort = home.create();
…//do zhe sort and zhe merge work.
Sort.remove();
}
}
在获得了SortHome的引用之后，客户就能够调用home接口的create()方法来获得Sort的remote接口的引用。一旦客户有了SortBeans的remote接口引用。就能够象调用普通方法一样调用remote接口的sort（）方法和merge（）方法。
编译链接Sort会话bean和它的客户端：
我们用一个makefile文件编译链接了sort 会话 bean和它的客户端。Makefile文件做了java2iiop，jar，verify等实用工具做的工作。首先，正确的设置环境变量-CLASSPATH和PATH
然后编译和build你的例子：
prompt% makeall
make文件非常简单，需要的话，可以自己修改它。
Sort的makefile文件如下：
#makefile
default: all
include ../Makefile.rules
SRCS=\
SortClient.java \
SortHome.java\
SortBean.java
CLASSES = $(SRCS:.java=.class)
Beans.jar: $(CLASSES}
$(JAVA2IIOP) SortHome
$(JAR) cMf beans.jar META-INF *.class
$(VERIFY) beans.jar
all: $(CLASSES) beans.jar
生成配置描述器：
配置描述器是一个XML文件， 在XML文件里面定义了Enterprise bean的属性。可以通过标准的XML编辑工具来生成XML文件。然后，就可以用配置描述编辑器来编辑。
注意：如果你用的是标准的XML编辑器，必须保证符合EJB1.1的规范要求。这样，Enterprise bean才能够与EJB容器一起工作。必须使用Inprise的文件类型定义（DTD）。目前，必须用标准的配置描述生成器来生成一个配置描述。一旦配置描述成为了jar文件的一部分。就可以用配置描述编辑器来修改它。配置描述器提供了Enterprise bean代码的配置信息，可以通过编辑器来更改它。
Enterprise beans是可以用在不同的应用程序，而不修改其源代码的。但是，因为每个应用程序按照它自己的方式来使用Enterprise beans。使用配置描述器就能够让beans适应这样的不同。SortBean的描述器定义了它的类型（无状态的Session），指定了其home接口（SortHome）和remote接口（Sort）的名字。还指定了其事务的类型（容器管理的事务）。
最后，运行例子Sort：
要运行例子，首先要启动VisiBroker Smart Agent来处理初始化的接口调用（例如客户如何定位命名服务等）。Smart Agent是通过应用服务器来运行的。
用如下命令启动EJB容器：
prompt% vbj com.inprise.ejb.Container. ejbcontainer sort_beans.jar
-jts -jns
从一个终端窗口用如下命令运行客户端程序：
promtp% vbj SortClient
客户定位并调用SortBean来对一组数组进行排序。输入输出如下：输入（用in标志的行），输出（用out标志的行）的数据。当然，并不一定要一模一样。根据你的输入数据的不同，将产生不同的输出。但其形式是这样的。
in: [1]
out:[1]
in: [1,2]
out:[1,2]
………
……….
In:[this is a test]
p align="JUSTIFY"> 为了使大家对EJB容器和Enterprisebeans有一个感性的认识，我们介绍一个简单的client/server例子。就是Inprise的应用服务器自带的例子--SortClient。是一个无状态的会话beans，它实现了一个排序（sort）算法。本例子演示了如何编译Enterprise beans例子，如何在EJB容器中运行Bean的一些基本操作。还演示了如何将一个对象放在JNDI命名服务中。
首先，我们来看一下Enterprise bean的原代码。通常由Enerprise beans的提供者来编写。（sort例子已经提供了代码，所以我们实际上什么都不用写。*_^）。下面，我们演示如何编译和链接此Enterprise bean。如何配置，如何打包成应用程序。然后演示如何编译链接客户。最后才运行客户和服务程序。
以下是开发具有Enterprisebeans的C/S应用程序的一些基本的步骤。
编写Enterprise beans的代码，包括beans的代码中远程（remote）接口和本地（home）接口的代码。
编写客户端代码。
编译和链接源代码，包括beans的和客户的源代码。
在目录META-INF中产生一个配置描述器。
打包Enterprise bean。
将Enterprise bean配置到jar文件中。
运行客户端。
编写一个Enterprise bean：
所有的Enterprisebeans都由三个部分组成，都必须由Enterprisebeans的提供者编写。这三个部分是：
实现类implementation class：这是一个Enterprisebean类，包括Enterprise beans应用逻辑的实现、和本地（home）、远程（remote）接口的功能定义。对于Sort例子，实现类就是SortBean.java文件。
本地（home）接口：本地接口定义了createing，finding，removing Enterprise beans的操作。在我们这个例子中，本地接口就是SortHome.java文件。
远程（remote）接口：远程接口定义了一些对客户可用的应用逻辑的方法。由Enterprisebeans提供。本例中，远程接口就是Sort.java文件。
客户要能够调用Bean的应用逻辑方法，Bean必须由这三个组成部分。客户应用程序使用Home接口来定位beans的remote接口。一旦客户拥有了remote接口的引用(refereenece)，就? 调用在remote接口中声明的任何方法。客户并不知道方法是在本地还是在远程系统中执行。对客户而言，调用Enterprise beans的方法就和调用本地方法一样简单。EJB容器将远程调用传递给实际的Enterprisebeans的实例。控制所有的通信协议，并通过remote接口将返回值传给客户。
下图显示了当SortClient客户需要调用SortBean 会话bean的merge()方法的时候的可能发生的调用情况。注意，SortClient首先调用SortHome接口的Create()方法。返回了Sort的remote接口的一个引用。然后，客户端才调用Sort remote接口的merge()方法。方法传回了所需要的结果。
EJB 容器
Create Sort 的实例
Sort的引用
Merge函数
结果
例子Sort是一个无状态的会话bean。大多数的会话beans都有状态。在会话中，应客户的要求，容器产生一个bean的实例。并且在整个会话中，这个实例都为这个这个特定的客户服务。根据定义，一个有状态的会话bean在整个会话的过程中都保持着与客户的会话状态。
另一方面，无状态的状态bean并没有指向某一个特定的客户，也就是说，说它并没有保持着与客户会话的任何状态。当客户调用一个无状态的会话bean方法时，容器给客户指定一个在缓冲池中的beans实例为之服务。被指定的实例保持着方法有关的变量，一直到完成方法调用。实例在方法调用的时候就返回的状态是任意值。而自己却不保存任何的状态，也不再与调用它的客户相联系。容器可以将实例归还给实例缓冲池，也可以不归还给缓冲池而由系统自动处理。
编写本地（home）接口：
home接口定义了创建（create）,查找（find）,删除（remove）等方法。无状态会话bean的home接口要比有状态的会话bean或者实体bean的home接口要来得简单。SortHome的home接口扩展了javax.ejb.EJBHome接口，声明了create()方法。Create()方法没有参数，抛出两个异常：RemoteException和CreateException。
Create（）返回了一个类型为Sort的对象，它实际上是一个对remote接口的一个引用。注意，客户并没有直接调用beans实例的任何方法。客户只是调用了通过beans的remote接口调用在remote接口定义了的方法。
因为有状态的会话bean和实体bean保持了客户的状态，可以有多个方法来产生实例，可以传递初始的参数给Create()方法。而无状态的会话bean并不需要保存客户的状态，可以只有一个Create()方法。这个唯一的Create()方法不能含有任何参数。将beans实例从实例缓冲池中取消的方法是Remove()方法，这是从EJBHome中继承过来的，而不需要另外在SortHome的Home接口中声明。
Sorthome的home接口如以下代码所示：
//SortHome.java
public interface SortHome extends javax.ejb.EJBHome(
Sort create() throws java.rmi.RemoteException, javax.ejb.CreateExcepion;)
编写remote接口代码：
remote接口定义、发布了Enterprise bean的应用方法，使这些应用方法可以在客户端被调用。它扩展了javax.ejb.EJBObject接口。Remote接口中的每一个方法都必须与SortBean实现类中的声明相匹配。方法必须有同样的名字和标识。另外，在sort的remote接口中必须抛出java.rmi.RemoteException异常，必须返回有效的RMI类型。Sort的remote接口声明了两个方法：sort()和merge()。两个方法都抛出了java.rmi.RemoteException异常，都返回了Vector类型。如下代码就是Sort的Remote接口：
//Sort.java
import java.util.Vector;
public interface Sort extends javax.ejb.EJBObject{
Vector Sort(Vector v, Compare c) throws java.rmi.RemoteExcetpion;
Vector merge(Vector a, Vector b, Compare c) throws java.rmi.RemoteException;
}
编写会话bean的实现代码：
因为SortBean是一个会话bean。必须实现javax.ejb.SessionBean接口。同时也要注意，SortBean类要定义成公共的。
SortBean的实现类定义了一些应用方法可以供客户端调用。在这个例子中，SortBean定义了sort（）和merge（）两个方法的实现。运行客户应用程序时，将会调用两个方法。
一个会话bean实现了ejbCreate()的方法，并且与home接口中的Create()方法相对应。SortHome的home接口定义了一个无参数的Create()方法，抛出了一个java.rmi.RemoteException异常。但是，与Sorthome接口的create()方法不同，create()返回了一个sort类型的对象，而ejbCreate()方法返回的是void类型。
会话bean可以有一个公共的构造函数，而SortBean却不可以。SortBean除了创建和应用方法以外，另外有四个方法，它们是：ejbRemove()，ejbActivate()，ejbPassivate()，和setSessionContext()。容器拥有这些方法的句柄，在Sortbean里，只需要将这些方法声明为public并将返回值置为void。
下面是会话bean：SortBean的实现类的源代码：为简洁起见，我们并没有完全显示sort()方法和merge()方法的实现部分。也没有把调试信息给显示出来。
//SortBean.java
import java.util.Vector
public class SortBean implements javax.ejb.SessionBean{
public void setSessionContext {javax.ejb.SessionContext
sessionContext} {}
public void ejbCreate() throws java.rmi.RemoteException {}
public void ejbRemove() throws java.rmi.RemoteException {}
public void ejbActivate() throws java.rmi.RemoteException {}
public void ejbPassivate() throws java.rmi.RemoteException {}
public Vector sort (Vector v, Compare c) throws java.rmi.RemoteExcetpion{
try{
……
return result;
}
catch(javax.ejb.CreateException e){
throw new java.rmi.ServerException(“Could not create sort instance”,
e);
}
catch(javax.ejb.RemoveException e){
throw new java.rmi.ServerException(“Could not remove sort instance”,e);
}
}
public Vector merge(Vector a, Vector b, Compare c) throws java.rmi.RemoteException{
…….
}
}
}
编写客户端代码：
客户端程序SortClient,必须首先使用JNDI的API来定位Enterprise beans的Home接口。在下面的例子代码中，SortClient客户首先端生成了一个JNDI上下文，使用JDNI的的lookup方法来为sort定位home接口。
//SortClient.java
public class SortClient{
…
public static void main(String[] args) throw Exception{
java.name.Context context;
{ //get a JNDI context using the Naming Service
context = new java.naming.InitialContext{};
}
Object objref = {SortHome} context.lookup(“sort”);
SortHome home = {SortHome} javax.rmi.PotableRemoteObject.narrow{
Objref, SortHome.class}
Sort sort = home.create();
…//do zhe sort and zhe merge work.
Sort.remove();
}
}
在获得了SortHome的引用之后，客户就能够调用home接口的create()方法来获得Sort的remote接口的引用。一旦客户有了SortBeans的remote接口引用。就能够象调用普通方法一样调用remote接口的sort（）方法和merge（）方法。
编译链接Sort会话bean和它的客户端：
我们用一个makefile文件编译链接了sort 会话 bean和它的客户端。Makefile文件做了java2iiop，jar，verify等实用工具做的工作。首先，正确的设置环境变量-CLASSPATH和PATH
然后编译和build你的例子：
prompt% makeall
make文件非常简单，需要的话，可以自己修改它。
Sort的makefile文件如下：
#makefile
default: all
include ../Makefile.rules
SRCS=\
SortClient.java \
SortHome.java\
SortBean.java
CLASSES = $(SRCS:.java=.class)
Beans.jar: $(CLASSES}
$(JAVA2IIOP) SortHome
$(JAR) cMf beans.jar META-INF *.class
$(VERIFY) beans.jar
all: $(CLASSES) beans.jar
生成配置描述器：
配置描述器是一个XML文件， 在XML文件里面定义了Enterprise bean的属性。可以通过标准的XML编辑工具来生成XML文件。然后，就可以用配置描述编辑器来编辑。
注意：如果你用的是标准的XML编辑器，必须保证符合EJB1.1的规范要求。这样，Enterprise bean才能够与EJB容器一起工作。必须使用Inprise的文件类型定义（DTD）。目前，必须用标准的配置描述生成器来生成一个配置描述。一旦配置描述成为了jar文件的一部分。就可以用配置描述编辑器来修改它。配置描述器提供了Enterprise bean代码的配置信息，可以通过编辑器来更改它。
Enterprise beans是可以用在不同的应用程序，而不修改其源代码的。但是，因为每个应用程序按照它自己的方式来使用Enterprise beans。使用配置描述器就能够让beans适应这样的不同。SortBean的描述器定义了它的类型（无状态的Session），指定了其home接口（SortHome）和remote接口（Sort）的名字。还指定了其事务的类型（容器管理的事务）。
最后，运行例子Sort：
要运行例子，首先要启动VisiBroker Smart Agent来处理初始化的接口调用（例如客户如何定位命名服务等）。Smart Agent是通过应用服务器来运行的。
用如下命令启动EJB容器：
prompt% vbj com.inprise.ejb.Container. ejbcontainer sort_beans.jar
-jts -jns
从一个终端窗口用如下命令运行客户端程序：
promtp% vbj SortClient
客户定位并调用SortBean来对一组数组进行排序。输入输出如下：输入（用in标志的行），输出（用out标志的行）的数据。当然，并不一定要一模一样。根据你的输入数据的不同，将产生不同的输出。但其形式是这样的。
in: [1]
out:[1]
in: [1,2]
out:[1,2]
………
……….
In:[this is a test]
下载本文示例代码
一个无状态的会话beans示例(5)一个无状态的会话beans示例(5)一个无状态的会话beans示例(5)一个无状态的会话beans示例(5)一个无状态的会话beans示例(5)一个无状态的会话beans示例(5)一个无状态的会话beans示例(5)一个无状态的会话beans示例(5)一个无状态的会话beans示例(5)一个无状态的会话beans示例(5)一个无状态的会话beans示例(5)一个无状态的会话beans示例(5)一个无状态的会话beans示例(5)一个无状态的会话beans示例(5)一个无状态的会话beans示例(5)
