开发EJB（下）

下载本文示例代码
P >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; 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规范定义了如下的命名约定： 它的返回值是会话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()方法的定义： $#@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方法都必须符合如下的约定。 返回值的类型是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子句也必须对应。 　　另外，Entity的Home接口能够提供一个或多个的Create()方法。这些方法返回了实体bean的remote接口的对象引用类型。它们的参数必须由应用程序指定。 Home接口中的Create()方法必须遵守如下规则： 必须抛出java.rmi.RemoteException异常 必须抛出javax.ejb.CreateException异常 返回是实体bean的remote接口类型 方法的名字必须是create 必须有一个方法与实体bean类里面的ejbCreate（）方法相对应。每一个create（）方法参数的个数和类型都必须与实体bean类中的相应的ejbCreate()方法一致。 Home接口中，create（）方法中的throws子句必须包括所有在实体bean类中相应的ejbCreate()方法和ejbPostCreate()方法中的throws子句抛出的例外。这就是说，Create（）方法抛出的例外集合必须是ejbCreate()方法和ejbPostCreate()方法抛出例外的并集的超集。EjbCreate（）方法的返回值是主键类。 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规范的编程限制： Enterprise bean不允许管理线程和线程组。不能启动一个新的线程，不能继续一个挂起的线程，也不允许中断或挂起一个正在运行的线程。另外，Enterprise bean不能改变一个线程的优先级，也不能改变线程的名字。 Enterprise bean不能使用既可读又可写的静态的字段。但可以使用只读的静态的字段。这样，所有的静态字段就必须声明为final。 Enterprise bean不允许使用线程同步原语来同步多个实例的执行。 Enterprise bean不能使用java的AWT函数来输出信息显示到屏幕。也不能从键盘接受信息。 Enterprise bean也不能使用java.io包来访问文件系统的文件和目录。 Enterprise bean应该尽量少使用sockets。特别的，Enterprise bean不能够监听Sockets，不能接受Socket上的连接，或使用Socket来进行广播。也不应该使用由SeverSocket,Socket建立的Socket工厂，或者由URL使用的流工厂。 Enterprise bean不能访问classes或package，也不能获得关于classes的信息。在某种程度上不允许通过Java程序设计语言。或者说，classes对Enterprise bean是不可用的。 Enteprise bean通常不允许访问环境函数，这些环境函数通常是由容器来控制。例如：产生一个类装载器，访问或者修改上下文，设置或产生安全管理器，停止JVM，改变输入，输出或错误流。 Enterprise bean不能为一段代码获得安全方针信息，否则会危及安全。 Enterprise bean不能装载本地库。 Enterprise bean不能在package中定义类。这个功能由于安全的原因被容器所保留。 Enterprise bean不能使用子类或Java Serialiazation Protocol中的对象取代特性。 如果Enterprise bean使用了this作为参数或方法的返回值，需要万分小心。使用SessionContext.getEJBObject()或EntityContext.getEJBObject来传递结果更安全一些。 Enterprise bean不允许改变对象的安全配置。例如，不允许改变它的java.security.Identify。任何这样的企图都会抛出一个java.security.SecurityException异常。 P >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; 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规范定义了如下的命名约定： 它的返回值是会话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()方法的定义： $#@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方法都必须符合如下的约定。 返回值的类型是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子句也必须对应。 　　另外，Entity的Home接口能够提供一个或多个的Create()方法。这些方法返回了实体bean的remote接口的对象引用类型。它们的参数必须由应用程序指定。 Home接口中的Create()方法必须遵守如下规则： 必须抛出java.rmi.RemoteException异常 必须抛出javax.ejb.CreateException异常 返回是实体bean的remote接口类型 方法的名字必须是create 必须有一个方法与实体bean类里面的ejbCreate（）方法相对应。每一个create（）方法参数的个数和类型都必须与实体bean类中的相应的ejbCreate()方法一致。 Home接口中，create（）方法中的throws子句必须包括所有在实体bean类中相应的ejbCreate()方法和ejbPostCreate()方法中的throws子句抛出的例外。这就是说，Create（）方法抛出的例外集合必须是ejbCreate()方法和ejbPostCreate()方法抛出例外的并集的超集。EjbCreate（）方法的返回值是主键类。 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规范的编程限制： Enterprise bean不允许管理线程和线程组。不能启动一个新的线程，不能继续一个挂起的线程，也不允许中断或挂起一个正在运行的线程。另外，Enterprise bean不能改变一个线程的优先级，也不能改变线程的名字。 Enterprise bean不能使用既可读又可写的静态的字段。但可以使用只读的静态的字段。这样，所有的静态字段就必须声明为final。 Enterprise bean不允许使用线程同步原语来同步多个实例的执行。 Enterprise bean不能使用java的AWT函数来输出信息显示到屏幕。也不能从键盘接受信息。 Enterprise bean也不能使用java.io包来访问文件系统的文件和目录。 Enterprise bean应该尽量少使用sockets。特别的，Enterprise bean不能够监听Sockets，不能接受Socket上的连接，或使用Socket来进行广播。也不应该使用由SeverSocket,Socket建立的Socket工厂，或者由URL使用的流工厂。 Enterprise bean不能访问classes或package，也不能获得关于classes的信息。在某种程度上不允许通过Java程序设计语言。或者说，classes对Enterprise bean是不可用的。 Enteprise bean通常不允许访问环境函数，这些环境函数通常是由容器来控制。例如：产生一个类装载器，访问或者修改上下文，设置或产生安全管理器，停止JVM，改变输入，输出或错误流。 Enterprise bean不能为一段代码获得安全方针信息，否则会危及安全。 Enterprise bean不能装载本地库。 Enterprise bean不能在package中定义类。这个功能由于安全的原因被容器所保留。 Enterprise bean不能使用子类或Java Serialiazation Protocol中的对象取代特性。 如果Enterprise bean使用了this作为参数或方法的返回值，需要万分小心。使用SessionContext.getEJBObject()或EntityContext.getEJBObject来传递结果更安全一些。 Enterprise bean不允许改变对象的安全配置。例如，不允许改变它的java.security.Identify。任何这样的企图都会抛出一个java.security.SecurityException异常。 下载本文示例代码


开发EJB（下）开发EJB（下）开发EJB（下）开发EJB（下）开发EJB（下）开发EJB（下）开发EJB（下）开发EJB（下）开发EJB（下）开发EJB（下）开发EJB（下）开发EJB（下）开发EJB（下）开发EJB（下）开发EJB（下）