Enterprise bean的开发(二) |
作者:未知 发布时间:2005-03-12 来源:JSP天空网
|
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()方法。
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()方法的定义:
findByPrimaryKey(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子句也必须对应。 |
|
|
|
|