开发Enterprise JavaBeans

开发Enterprise JavaBeans

chinacomputerworld

Java (2001-11-01 23:06:39)

---

现在，从如下几个方面来介绍Enterprise bean的开发：

开发EJB的主要关键的步骤。如何使用使用Jbuilder。用Jbuilder之外的其它的开发工具。如何开发Eneterprise Beans的详细的细节。目前开发程序的限制。


开发EJB的主要步骤：


一般来说，整个的开发步骤（开发，配置，组装）包括如下几个方面：

开发：首先要定义三个类：Bean类本身，Bean的本地（Home）和远程（Remote）接口类。


配置：配置包括产生配置描述器--这是一个XML文件、声明了Enterprise Bean的属性、绑定了bean的class文件（包括stub文件和skeleton文件）。最后将这些配置都放到一个jar文件中。还需要在配置器中定义环境属性。


组装应用程序：包括将Enterprise beans安装到Server服务器中，测试各层的连接情况。程序组装器将若干个Enterprise Beans与其它的组件（Servlet,Applet,Script等等）结合起来。组合成一个完整的应用程序。或者将若干个Enterprise beans组合成一个复杂的Enterprise Bean。


管理Enterprise Bean。


二、使用Jbuilder：

Jbuilder与EJB Container能够进行无缝连接。Jbuilder和Inprise的应用服务器包括了所有的开发和配置Enterprise Beans的工具以及所需要的库：

运行和管理Enterprise Bean的容器。


命名服务。


事务服务。


Java数据库。


开发Enterprise Beans所需要的API。


一个增强的java-to-iiop编译器，支持值类型和RMI信号。


Jbuilder还提供了一个快速开发应用程序Enterprise Beans的工具和向导。通过简单而且直观的步骤，向导帮助你建立一个Enterprise Bean。自己设定某些缺省值，产生了bean的模板，在上面，我们可以增加我们自己的应用逻辑。

Jbuilder也提供了一个EJB的接口生成向导。向导在Enterprise Bean的公共方法基础上生成了Remote接口和Home接口。Jbuilder还提供一个配置器的向导帮助我们逐步的建立XML描述器文件。并将生成的Stubs集中到一个jar文件中。


三、使用Jbuilder之外的集成环境：

如果你使用其它的除了别的集成环境（IDE）。要确定使用了集成环境IDE所带的容器工具。也要验证IDE是否支持EJB规范的相应的版本，还要确定它是否正确的支持EJB的API。


要确定JD到所支持的EJB容器的版本。可以通过检查Inprise的安装说明来确定EJB容器所支持的支持JDK的版本。


在配置Enterprise Bean的时候，你必须使用Inprise的应用服务器所提供的工具。这些工具能够编辑和修改第三方的代理商提供的Inprise配置描述器。还能够验证配置描述器，能够验证bean的源代码。


四、Enterprise Beans的开发：

这一节我们主要讨论Enterprise bean的提供者要开发enterprise bean必须完成的任务上面。这些任务包括：

定义和编写Enterprise bean类：这是Enterprise bean内部应用逻辑的实现。


编写Enterprise bean的远程remote接口类。


编写Enterprise bean的本地home 接口类。


说明主键类，主键类只是对于Entity bean才需要的。在Enterprise bean的配置描述器中指定主键的名字。

Enterprise beans提供者定义了远程（Remote）接口和本地（home）接口，实现了Enterprise bean类本身。Remote接口中提供了客户调用Enterprise bean实现的应用逻辑函数的接口。而home接口提供了产生和定位remote接口实例的方法。


在Enterprise bean本身类的实现，本地home接口，远程remote接口之间并没有正式的联系（例如继承关系）。但是，在三个类里面声明的方法却必须遵守EJB里面定义的规范。例如： 你在Enterprise bean里面声明了一个应用程序的方法或者说应用逻辑。也在beans的remote接口中声明了这个方法，那么，这两个地方必须要同样的名字。Bean的实现里面必须至少有一个Create()方法：ejbCreate()。但是可以有多个带有不同参数的create()方法。在home接口中，也必须有相同的方法定义（参数的个数相同）。EjbCreate()方法返回的一个容器管理的持久对象。它们都返回一个容器管理持久性的主键值。但是，在home的相应的Create()方法中返回值的类型是remote接口。

注意：实体bean的实现的ejbCreate（）方法有点不同。实体bean可以不定义ejbCreate()方法。如果实体只是通过应用程序或通过数据库管理程序的的途径被加到数据库中，实体bean就省略了ejbCreate（）方法。ejbCreate（）返回的值是主键类型的。如果ejbCreate（）方法是容器管理持久性的实体bean的方法，它的返回值就是NULL类型。如果实体bean实现了Bean管理的持久性，ejbCreate（）方法就返回值类型就是主键类型。在以后，我们会详细讨论它们的不同。


Entereprise Bean提供者定义了Enterprise bean的语义。容器的任务是把home接口，remote接口和Enterprise bean的实现类结合起来。保证在编译时和运行时，remote接口和bean的实现类是相对应的。


Enterprise bean的继承关系：

Enterprise bean的实现类，remote接口，home接口都要从不同的基类中继承下来。Home接口是从javax.ejb.EJBHome中继承过来的。Remote接口从javax.ejb.EJBObject中继承而来。Remote和home接口的基类都是javax.rmi.Remote。


一个会话bean必须实现基类javax.ejb.SessionBean。而实体bean必须实现基类javax.ejb.EntiyBean。这些EJB的基类都是从javax.ejb.EnterpriseBean继承而来。而javax.ejb.EnterpriseBean又是从java.io.Serializable继承而来。

下图显示了它们之间的关系。在这里，CartBean，既可以是一实体bean，也可以是一个会话bean。它的Home接口是CartHome，remote接口是Cart。

(略)


Remote 接口：

每一个Enterprise Bean都必须有一个remote接口。Remote接口定义了应用程序规定客户可以调用的逻辑操作。这些是一些可以开发步骤（开发，配置，组装）包括如下几个方面：

开发：首先要定义三个类：Bean类本身，Bean的本地（Home）和远程（Remote）接口类。


配置：配置包括产生配置描述器--这是一个XML文件、声明了Enterprise Bean的属性、绑定了bean的class文件（包括stub文件和skeleton文件）。最后将这些配置都放到一个jar文件中。还需要在配置器中定义环境属性。


组装应用程序：包括将Enterprise beans安装到Server服务器中，测试各层的连接情况。程序组装器将若干个Enterprise Beans与其它的组件（Servlet,Applet,Script等等）结合起来。组合成一个完整的应用程序。或者将若干个Enterprise beans组合成一个复杂的Enterprise Bean。


EJBHome的基类：

　　每一个Home接口都扩展了javax.ejb.EJBHome接口。如下代码显示了javax.ejb.EJBHome接口的定义：

package javax.ejb;


public interface EJBHome extends java.rmi.Remote() {

void remove(Handle handle) throws java.rmi.RemoteException,RemoveException;

void remove(Object primarykey) throws java.rmi.RemoteException,RemoveException;

EJBMetaData getEJBMetaData() throws RemoteException;

Homehandle getHomeHandle() throws RemoteException;

}


　　这里提供了两个remove（）方法来删除Enterprise bean的实例。第一个remove方法是通过句柄来删除一个Enterprise bean的实例。第二个remove方法通过主键来删除一个Enterprise bean的实例。


　　在众多的Enterprise bean实例中，句柄唯一的标识一个实例。一个句柄与它引用的Enterprise bean有相同的生命期。考虑一个实体对象，客户可以通过一个句柄来重新获得相应的Enterprise bean的实例。一个句柄能够对应一个Enterprise bean对象的多个实例。例如，即使当Enterprise bean对象所在的主机崩溃了，或者Enterprise bean对象在不同的机器之间移动，句柄仍是有效的。这里的句柄是Serialized句柄，与CORBA中的字符串化的CORBA对象的引用是相似的概念。

　　在EJBHome接口中的第二个remove操作通过其主键来决定要删除的Enterprise bean。主键可以是扩展了Java Object类的任何类型，但是，必须要实现Java的Serializable接口。主键是标识实体bean的主要的方法。通常，主键是数据库中的一个关键字，唯一的定义了由实体bean代表的数据。

　　方法getEJBMetaData（）返回了Enterprise bean对象的metadata接口。这个接口允许客户获得Enterprise bean的metadata信息。当开发工具来编译链接应用程序的时候，或者配置工具来配置的时候，可能会用到metadata信息。Javax.ejb.EJBMetadata接口提供了获得javax.ejb.EJBHome接口，home类，remote接口，还有获得主键的方法。也提供了一个isSesson()的方法来确定在放这个home接口的对象是会话bean还是实体bean。IsStatelessSession()方法指示这个会话bean是有状态还是无状态的。如下代码显示了javax.ejb.EJBMetadata接口的定义部分的代码。

Public javax.ejb;

Public interface EJBMetaData{

EJBHome getEJBHome();

Class getHomeInterfaceClass();

Class getRemoteInterfaceClasss();

Class getPrimaryKeyClass();

Boolean isSession();

Boolean isStatelesssSession();

}


会话bean的home接口：

　　在前面我们说过，一个会话bean只有一个客户。这就是说，当一个客户创建一个会话bean的时候，这个会话bean的实例只是为了这个创建它的客户而存在（这里，我们指的是有状态的会话bean。无状态的会话bean因为并不保持会话的状态，所以可以多个客户）。

　　因为home 接口包括了一个或多个的Create()方法的定义，成为会话bean的工厂。对每一个Create（）方法，EJB规范定义了如下的命名约定：


它的返回值是会话bean的remote接口的类型。


方法的名字只能是Create()。


对会话bean类中的每一个ejbCreate()方法都必须有一个Create()与之对应。


对于每一个Create()方法的参数的类型和数量都必须与会话bean类中的ejbCreate()方法相对应。


方法必须抛出java.rmi.RemoteException例外。


方法必须抛出javax.rmi.CreateExeption例外。


Create（）方法的参数是用来初始化新的会话bean对象的。


如下代码显示了一个会话bean对象的不同的Create()方法，其中必须的部分用粗体显示：

public interface AtmHome extends javax.ejb.EJBHome{

Atm create() throws java.rmi.RemoteException,javax.ejb.CreateException;

Atm create(Profile preferredProfile)

Throws java.rmi.RemoteExeption,javax.ehrows java.rmi.RemoteException,RemoveException;

EJBMetaData getEJBMetaData() throws RemoteException;

Homehandle getHomeHandle() throws RemoteException;

}


　　这里提供了两个remove（）方法来删除Enterprise bean的实例。第一个remove方法是通过句柄来删除一个Enterprise bean的实例。第二个remove方法通过主键来删除一个Enterprise bean的实例。


　　在众多的Enterprise bean实例中，句柄唯一的标识一个实例。一个句柄与它引用的Enterprise bean有相同的生命期。考虑一个实体对象，客户可以通过一个句柄来重新获得相应的Enterprise bean的实例。一个句柄能够对应一个Enterprise bean对象的多个实例。例如，即使当Enterprise bean对象所在的主机崩溃了，或者Enterprise bean对象在不同的机器之间移动，句柄仍是有效的。这里的句柄是Serialized句柄，与CORBA中的字符串化的CORBA对象的引用是相似的概念。 　　在EJBHome接口中的第二个remove操作通过其主键来决定要删除的Enterprise bean。主键可以是扩展了Java Object类的任何类型，但是，必须要实现Java的Serializable接口。主键是标识实体bean的主要的方法。通常，主键是数据库中的一个关键字，唯一的定义了由实体bean代表的数据。

　　方法getEJBMetaData（）返回了Enterprise bean对象的metadata接口。这个接口允许客户获得Enterprise bean的metadata信息。当开发工具来编译链接应用程序的时候，或者配置工具来配置的时候，可能会用到metadata信息。Javax.ejb.EJBMetadata接口提供了获得javax.ejb.EJBHome接口，home类，remote接口，还有获得主键的方法。也提供了一个isSesson()的方法来确定在放这个home接口的对象是会话bean还是实体bean。IsStatelessSession()方法指示这个会话bean是有状态还是无状态的。如下代码显示了javax.ejb.EJBMetadata接口的定义部分的代码。

Public javax.ejb;

Public interface EJBMetaData{

EJBHome getEJBHome();

Class getHomeInterfaceClass();

Class getRemoteInterfaceClasss();

Class getPrimaryKeyClass();

Boolean isSession();

Boolean isStatelesssSession();

}


会话bean的home接口：

　　在前面我们说过，一个会话bean只有一个客户。这就是说，当一个客户创建一个会话bean的时候，这个会话bean的实例只是为了这个创建它的客户而存在（这里，我们指的是有状态的会话bean。无状态的会话bean因为并不保持会话的状态，所以可以多个客户）。

　　因为home 接口包括了一个或多个的Create()方法的定义，成为会话bean的工厂。对每一个Create（）方法，EJB规范定义了如下的命名约定：


它的返回值是会话bean的remote接口的类型。


方法的名字只能是Create()。


对会话bean类中的每一个ejbCreate()方法都必须有一个Create()与之对应。


对于每一个Create()方法的参数的类型和数量都必须与会话bean类中的ejbCreate()方法相对应。


方法必须抛出java.rmi.RemoteException例外。


方法必须抛出javax.rmi.CreateExeption例外。


Create（）方法的参数是用来初始化新的会话bean对象的。


如下代码显示了一个会话bean对象的不同的Create()方法，其中必须的部分用粗体显示：

public interface AtmHome extends javax.ejb.EJBHome{

Atm create() throws java.rmi.RemoteException,javax.ejb.CreateException;

Atm create(Profile preferredProfile)

Throws java.rmi.RemoteExeption,javax.ehrows java.rmi.RemoteException,RemoveException;

EJBMetaData getEJBMetaData() throws RemoteException;

Homehandle getHomeHandle() throws RemoteException;

}


　　这里提供了两个remove（）方法来删除Enterprise bean的实例。第一个remove方法是通过句柄来删除一个Enterprise bean的实例。第二个remove方法通过主键来删除一个Enterprise bean的实例。


　　在众多的Enterprise bean实例中，句柄唯一的标识一个实例。一个句柄与它引用的Enterprise bean有相同的生命期。考虑一个实体对象，客户可以通过一个句柄来重新获得相应的Enterprise bean的实例。一个句柄能够对应一个Enterprise bean对象的多个实例。例如，即使当Enterprise bean对象所在的主机崩溃了，或者Enterprise bean对象在不同的机器之间移动，句柄仍是有效的。这里的句柄是Serialized句柄，与CORBA中的字符串化的CORBA对象的引用是相似的概念。

　　在EJBHome接口中的第二个remove操作通过其主键来决定要删除的Enterprise bean。主键可以是扩展了Java Object类的任何类型，但是，必须要实现Java的Serializable接口。主键是标识实体bean的主要的方法。通常，主键是数据库中的一个关键字，唯一的定义了由实体bean代表的数据。

　　方法getEJBMetaData（）返回了Enterprise bean对象的metadata接口。这个接口允许客户获得Enterprise bean的metadata信息。当开发工具来编译链接应用程序的时候，或者配置工具来配置的时候，可能会用到metadata信息。Javax.ejb.EJBMetadata接口提供了获得javax.ejb.EJBHome接口，home类，remote接口，还有获得主键的方法。也提供了一个isSesson()的方法来确定在放这个home接口的对象是会话bean还是实体bean。IsStatelessSession()方法指示这个会话bean是有状态还是无状态的。如下代码显示了javax.ejb.EJBMetadata接口的定义部分的代码。

Public javax.ejb;

Public interface EJBMetaData{

EJBHome getEJBHome();

Class getHomeInterfaceClass();

Class getRemoteInterfaceClasss();

Class getPrimaryKeyClass();

Boolean isSession();

Boolean isStatelesssSession();

}


会话bean的home接口：

　　在前面我们说过，一个会话bean只有一个客户。这就是说，当一个客户创建一个会话bean的时候，这个会话bean的实例只是为了这个创建它的客户而存在（这里，我们指的是有状态的会话bean。无状态的会话bean因为并不保持会话的状态，所以可以多个客户）。

　　因为home 接口包括了一个或多个的Create()方法的定义，成为会话bean的工厂。对每一个Create（）方法，EJB规范定义了如下的命名约定：


它的返回值是会话bean的remote接口的类型。


方法的名字只能是Create()。


对会话bean类中的每一个ejbCreate()方法都必须有一个Create()与之对应。


对于每一个Create()方法的参数的类型和数量都必须与会话bean类中的ejbCreate()方法相对应。


方法必须抛出java.rmi.RemoteException例外。


方法必须抛出javax.rmi.CreateExeption例外。


Create（）方法的参数是用来初始化新的会话bean对象的。


如下代码显示了一个会话bean对象的不同的Create()方法，其中必须的部分用粗体显示：

public interface AtmHome extends javax.ejb.EJBHome{

Atm create() throws java.rmi.RemoteException,javax.ejb.CreateException;

Atm create(Profile preferredProfile)

Throws java.rmi.RemoteExeption,javax.ejb.CreateException;

}


　　注意，会话Bean的home 接口并没有定义finder方法来定位对象。因为一个有状态的会话bean只是给创建它的客户使用。如果不是客户自己创建的会话Bean，没有必要也不允许去定位这样的一个会话Bean。


实体bean的home接口：

　　跟会话bean的home接口一样，实体bean的home接口提供了Create()的方法。另外，实体

　　bean的Home接口还提供了finder方法，这样，客户就能够定位并使用实体bean的对象。Finder操作是必要的，因为实体bean是长时间存活的，可以被多个客户所使用。对于大多数的应用程序而言，实体bean的实例是存在的，客户只需要找到一个用来使用就可以了。


　　一个Entity bean的home接口必须提供一个缺省的finder方法：finderByPrimary(primaryKey)。这个方法允许客户通过主键来定位Entity bean。方法只有一个唯一的参数：主键。方法的返回值类型是实体bean的remote接口类型。主键的类型可以是扩展了Java Object类型的任何Java类型。在配置描述器中，你必须告诉容器主键的类型。注意，根据定义，findByPrimaryKey()方法总是返回一个单个的Entity 对象。而其它的finder()方法可以返回Entity对象的集合。

下面是findByPrimaryKey()方法的定义：

<entity bean’s remote interface> findByPrimaryKey(<primary key type> key)

throws java.rmi.RemoteException,FinderException;


　　home接口还可以定义别的finder()方法。每一个finder()方法都必须在Enterprise bean类里面有一个对应的实现。每一个finder方法都必须符合如下的约定。


返回值的类型是remote接口类型，或者finder方法能够返回不止一个的Entity对象，或者一个以remote接口为内容类型的集合类型。有效的Java集合类型是java.util.Enumeration接口（JDK1.1规范）或java.util.Collection接口（java 2规范）。


finder方法总是以前缀find开头。在实体bean 类里面以前缀ejbFind开头。


必须抛出java.rmi.RemoteException异常。


必须抛出javax.ejb.FinderException异常。 在home接口中的的throws子句与实体bean类的ejbCreate()方法的throws子句也必须对应。