开发EJB

现在，从如下几个方面来介绍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接口定义了应用程序规定客户可以调用的逻辑操作。这些是一些可以由客户调用的公共的方法，通常由Enterprise beans类来实现。注意，Enterprise bean的客户并不直接访问Bean。而是通过remote接口来访问。

 

EJBObject基类：

Enterprise bean类的remote接口扩展了javax.ejb.EJBObject类的公共java接口。而Javax.ejb.EJBObject是所有remote接口的基类。其代码如下：

 

package javax.ejb;

public interface EJBObject extends java.rmi.Remote{

public EJBHome getEJBHome() throws java.rmi.RemoteException;

public Object getPrimaryKey() throws java.rmi.RemoteException;

public void Remove() throws java.rmi.RemtoeException, java.rmi.RemoveException

public Handle getHandle() throws java.rmi.RemoteException;

boolean isIdentical (EJBObject p0) throws java.rmi.RemoteException;

}

 

getEJBHome()方法允许你取得一个相关的Home接口。对于 实体Bean，用getPrimaryKey（）方法获得实体Bean的主键值。Remove（）可以删除一个Enterprise bean。具体的语义在各种不同类型的enterprise beans的生命周期中，由上下文中解释的。方法getHandle（）返回了一个Enterprise bean实例的持久的句柄。IsIndentical()方法允许你去比较Enterprise beans是否相同。

 

方法的要求：

所有的remote接口中的方法必须声明为公共（public）的，并必须抛出java.rmi.RemotException异常。另外，所有的remote接口中的方法定义的参数和都必须是在RMI-IIOP中有效的。对每一个在remote接口中定义的方法，在Enterprise bean 类里面都要有相应的方法。相应的方法必须要有同样的名字，同样类型和数量的参数，同样的返回值，而且还要抛出同样的例外。

 

如下代码显示了一个ATM例子的会话bean的remote接口Atm，。里面声明了一个应用方法transfer（）。黑体部分表示EJB规范中必须要有的内容。Remote接口必须扩展javax.ejb.EJBObject类。从客户端调用的Enterprise bean的每一个方法都必须在remote接口中声明。Transfer（）方法抛出了两个意外。其中InSufficientFundsException例外是应用程序定义的意外。

Public interface Atm extends javax.ejb.EJBObject{

Public void transfer(String Source, String Target, float amount)

Throws java.rmi.RemoteException, InSufficientFundsException;

}

对于remote接口的定义规则，会话bean和实体bean是一样的。

 

Home接口：

Enterprise bean的Home接口控制着bean的生命周期。提供了Enterprise bean对象（也就是对Enterprise bean的实例）的Create（），find（），remove（）操作。会话bean和实体bean有不同的生命周期。所以，它们的home接口必须定义不同的方法。

Enterprise bean的提供者必须定义home接口，而由EJB容器来实现home接口。

 

与Remote接口相似，Home接口中方法中的参数，返回值也必须是RMI-IIOP有效的。所有的方法必须抛出java.rmi.RemoteException例外。

Home接口必须定义一个或多个的Create()方法。每一个这样的Create()方法都必须命名为Create。并且，它的参数，不管是类型还是数量都必须与bean类里面的ejbCreate()方法对应。注意，home接口中的Create()方法和bean类中ejbCreate()方法的返回值类型是不同的。

实体bean的home接口还包含find（）方法。

 

　　每一个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;

lic 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规范定义了如下的命名约定：

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

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

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

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

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

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

1. 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()方法的定义：

$#@60;entity bean’s remote interface$#@62; findByPrimaryKey($#@60;primary key type$#@62; key)

throws java.rmi.RemoteException,FinderException

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

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

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

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

1. 必须抛出javax.ejb.FinderException异常。

1. 在home接口中的的throws子句与实体bean类的ejbCreate()方法的throws子句也必须对应。

　　另外，Entity的Home接口能够提供一个或多个的Create()方法。这些方法返回了实体bean的remote接口的对象引用类型。它们的参数必须由应用程序指定。

Home接口中的Create()方法必须遵守如下规则：

1. 必须抛出java.rmi.RemoteException异常
2. 必须抛出javax.ejb.CreateException异常
3. 返回是实体bean的remote接口类型
4. 方法的名字必须是create
5. 必须有一个方法与实体bean类里面的ejbCreate（）方法相对应。每一个create（）方法参数的个数和类型都必须与实体bean类中的相应的ejbCreate()方法一致。
6. Home接口中，create（）方法中的throws子句必须包括所有在实体bean类中相应的ejbCreate()方法和ejbPostCreate()方法中的throws子句抛出的例外。这就是说，Create（）方法抛出的例外集合必须是ejbCreate()方法和ejbPostCreate()方法抛出例外的并集的超集。EjbCreate（）方法的返回值是主键类。
7. Create（）方法的参数是用来初始化新实体bean对象的。

如下代码显示了不同类型的finder()和Create()方法。必须的部分用粗体表示：

public interface AccountHome extends javax.ejb.EJBHome{

Account create(String accoundId)

throws java.rmi.RemoteException,javax.ejb.CreateException;

Account create(String accoundId, float initialBalance)

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

Account findByPrimaryKey(String key)

Throws java.rmi.RemoteException, javax.ejb.FinderException;

Enumeration findBySocialSecurityNumber(String socialSecurityNumber)

Throws java.rmi.RemoteException,javax.ejb.FinderException;

}

Enterprise bean实现：

　　Enterprise bean的实现包括了所有的应用程序指定的语义。这是Bean提供者的主要工作。一个会话bean类实现了javax.ejb.SessionBean接口。而一个实体bean实现了一个javax.ejb.EntityBean接口。这两个接口都扩展了同一个基类javax.ejb.EnterpriseBean。但是会话bean的实现和实体bean的实现不同。 

Enterprise bean接口：

　　Enterprise bean接口javax.ejb.EntpriseBean定义了一个通用的基类，并扩展了java.io.Serializable接口。它并没有定义任何方法。其定义代码如下：

Package javax.ejb;

Public interface EnterpriseBean extends java.io.Serializable{}

Handle句柄：

　　Handle是远程对象引用Enterprise bean对象它的Home接口的一种抽象的方式。所有的Enterprise bean对象句柄都实现了javax.ejb.Handle接口。这个接口提供了对Enterprise bean对象的持久的引用。其定义代码如下：

Public interface javax.ejb.Handle extends java.io.Serializable{

Public EJBObject getEJBObject() throws java.rmi.RemoteException;

}

 

　　通过Serialize类(这个类实现了handle接口)的实例，handle可以持久的存储一个Enterprise bean对象的引用。这与CORBA IOR的字符串化相似。Javax.ejb.Handle扩展了java.io.Serializable接口。

Javax.ejb.HomeHandle接口也提供了Enterprise bean的home接口的持久的引用。Javax.ejb.HomeHandle由所有的Home对象handle实现。其定义代码如下：

Public interface HomeHandle extends java.io.Serializable{

Public EJBHome getEJBHome() throws RemoteException;

}

　　通常，Handle是由容器实现的。

 

五、编程限制：

下面列举了一些EJB1.1规范的编程限制：

1. Enterprise bean不允许管理线程和线程组。不能启动一个新的线程，不能继续一个挂起的线程，也不允许中断或挂起一个正在运行的线程。另外，Enterprise bean不能改变一个线程的优先级，也不能改变线程的名字。

1. Enterprise bean不能使用既可读又可写的静态的字段。但可以使用只读的静态的字段。这样，所有的静态字段就必须声明为final。

1. Enterprise bean不允许使用线程同步原语来同步多个实例的执行。

1. Enterprise bean不能使用java的AWT函数来输出信息显示到屏幕。也不能从键盘接受信息。

1. Enterprise bean也不能使用java.io包来访问文件系统的文件和目录。 

1. Enterprise bean应该尽量少使用sockets。特别的，Enterprise bean不能够监听Sockets，不能接受Socket上的连接，或使用Socket来进行广播。也不应该使用由SeverSocket,Socket建立的Socket工厂，或者由URL使用的流工厂。

1. Enterprise bean不能访问classes或package，也不能获得关于classes的信息。在某种程度上不允许通过Java程序设计语言。或者说，classes对Enterprise bean是不可用的。

1. Enteprise bean通常不允许访问环境函数，这些环境函数通常是由容器来控制。例如：产生一个类装载器，访问或者修改上下文，设置或产生安全管理器，停止JVM，改变输入，输出或错误流。

1. Enterprise bean不能为一段代码获得安全方针信息，否则会危及安全。

1. Enterprise bean不能装载本地库。

1. Enterprise bean不能在package中定义类。这个功能由于安全的原因被容器所保留。

1. Enterprise bean不能使用子类或Java Serialiazation Protocol中的对象取代特性。

1. 如果Enterprise bean使用了this作为参数或方法的返回值，需要万分小心。使用SessionContext.getEJBObject()或EntityContext.getEJBObject来传递结果更安全一些。

1. Enterprise bean不允许改变对象的安全配置。例如，不允许改变它的java.security.Identify。任何这样的企图都会抛出一个java.security.SecurityException异常。