ejb-core.htm

写给JSP初级程序员的书

              public void Remove() throws java.rmi.RemtoeException, java.rmi.RemoveException 
              <br>
              public Handle getHandle() throws java.rmi.RemoteException;<br>
              boolean isIdentical (EJBObject p0) throws java.rmi.RemoteException; 
              <br>
              } <br>
              　　getEJBHome()方法允许你取得一个相关的Home接口。对于 实体Bean，用getPrimaryKey（）方法获得实体Bean的主键值。Remove（）可以删除一个Enterprise 
              bean。具体的语义在各种不同类型的enterprise beans的生命周期中，由上下文中解释的。方法getHandle（）返回了一个Enterprise 
              bean实例的持久的句柄。IsIndentical()方法允许你去比较Enterprise beans是否相同。</p>
            <p>2、方法： <br>
              　　所有的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例外是应用程序定义的意外。 
              <br>
              Public interface Atm extends javax.ejb.EJBObject{ <br>
              Public void transfer(String Source, String Target, float amount)<br>
              Throws java.rmi.RemoteException, InSufficientFundsException; <br>
              } <br>
              　　Home接口必须定义一个或多个的Create()方法。每一个这样的Create()方法都必须命名为Create。并且，它的参数，不管是类型还是数量都必须与bean类里面的ejbCreate()方法对应。注意，home接口中的Create()方法和bean类中ejbCreate()方法的返回值类型是不同的。实体bean的home接口还包含find（）方法。 
              每一个Home接口都扩展了javax.ejb.EJBHome接口。如下代码显示了javax.ejb.EJBHome接口的定义： 
              <br>
              package javax.ejb; <br>
              public interface EJBHome extends java.rmi.Remote() { <br>
              void remove(Handle handle) throws java.rmi.RemoteException,RemoveException; 
              <br>
              void remove(Object primarykey) throws java.rmi.RemoteException,RemoveException; 
              <br>
              EJBMetaData getEJBMetaData() throws RemoteException; <br>
              Homehandle getHomeHandle() throws RemoteException; <br>
              }<br>
              　　这里提供了两个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代表的数据。 
              <br>
              　　方法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接口的定义部分的代码。<br>
              Public javax.ejb; Public interface EJBMetaData{ <br>
              EJBHome getEJBHome();<br>
              Class getHomeInterfaceClass(); <br>
              Class getRemoteInterfaceClasss();<br>
              Class getPrimaryKeyClass(); <br>
              Boolean isSession();<br>
              Boolean isStatelesssSession(); <br>
              } <br>
              　　对每一个Create（）方法，EJB规范定义了如下的命名约定。它的返回值是会话bean的remote接口的类型。方法的名字只能是Create()。对会话bean类中的每一个ejbCreate()方法都必须有一个Create()与之对应。 
              对于每一个Create()方法的参数的类型和数量都必须与会话bean类中的ejbCreate()方法相对应。方法必须抛出java.rmi.RemoteException例外。 
              方法必须抛出javax.rmi.CreateExeption例外。 Create（）方法的参数是用来初始化新的会话bean对象的。 
              如下代码显示了一个会话bean对象的不同的Create()方法，其中必须的部分用粗体显示： <br>
              public interface AtmHome extends javax.ejb.EJBHome{ <br>
              Atm create() throws java.rmi.RemoteException,javax.ejb.CreateException; 
              <br>
              Atm create(Profile preferredProfile) <br>
              Throws java.rmi.RemoteExeption,javax.ehrows java.rmi.RemoteException,RemoveException; 
              <br>
              EJBMetaData getEJBMetaData() throws RemoteException; <br>
              Homehandle getHomeHandle() throws RemoteException; <br>
              }<br>
              　　这里提供了两个remove（）方法来删除Enterprise bean的实例。第一个remove方法是通过句柄来删除一个Enterprise 
              bean的实例。第二个remove方法通过主键来删除一个Enterprise bean的实例。在众多的Enterprise bean实例中，句柄唯一的标识一个实例。一个句柄与它引用的Enterprise 
              bean有相同的生命期。考虑一个实体对象，客户可以通过一个句柄来重新获得相应的Enterprise bean的实例。一个句柄能够对应一个Enterprise 
              bean对象的多个实例。例如，即使当Enterprise bean对象所在的主机崩溃了，或者Enterprise bean对象在不同的机器之间移动，句柄仍是有效的。这里的句柄是Serialized句柄，与CORBA中的字符串化的CORBA对象的引用是相似的概念。 
              <br>
              　　在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接口的定义部分的代码。<br>
              Public javax.ejb; <br>
              Public interface EJBMetaData{ <br>
              EJBHome getEJBHome(); <br>
              Class getHomeInterfaceClass();<br>
              Class getRemoteInterfaceClasss(); <br>
              Class getPrimaryKeyClass(); <br>
              Boolean isSession(); <br>
              Boolean isStatelesssSession(); <br>
              } </p>
            <p>五、EJB的编程环境：</p>
            <p>1、 使用Jbuilder<br>
              　　Jbuilder与EJB Container能够进行无缝连接。Jbuilder和Inprise的应用服务器包括了所有的开发和配置Enterprise 
              Beans的工具以及所需要的库：运行和管理Enterprise Bean的容器、命名服务、 事务服务、Java数据库、开发Enterprise 
              Beans所需要的API、一个增强的java-to-iiop编译器，支持值类型和RMI信号等等。 <br>
              　　Jbuilder还提供了一个快速开发应用程序Enterprise Beans的工具和向导。通过简单而且直观的步骤，向导帮助你建立一个Enterprise 
              Bean。自己设定某些缺省值，产生了bean的模板，在上面，我们可以增加我们自己的应用逻辑。Jbuilder也提供了一个EJB的接口生成向导。向导在Enterprise 
              Bean的公共方法基础上生成了Remote接口和Home接口。Jbuilder还提供一个配置器的向导帮助我们逐步的建立XML描述器文件。并将生成的Stubs集中到一个jar文件中。</p>
            <p>2、使用Jbuilder之外的集成环境： <br>
              　　如果你使用其它的除了别的集成环境（IDE）。要确定使用了集成环境IDE所带的容器工具。也要验证IDE是否支持EJB规范的相应的版本，还要确定它是否正确的支持EJB的API。 
              <br>
              　　要确定JD到所支持的EJB容器的版本。可以通过检查Inprise的安装说明来确定EJB容器所支持的支持JDK的版本。 <br>
              　　在配置Enterprise Bean的时候，你必须使用Inprise的应用服务器所提供的工具。这些工具能够编辑和修改第三方的代理商提供的Inprise配置描述器。还能够验证配置描述器，能够验证bean的源代码。 
            </p>
            <p>六、一个简单的HELLO例子 </p>
            <p>1、安装Apusic Application Server <br>
              　　Note:以下以Linux为例，来说明Apusic Application Server的安装过程。其他平台的安装，可参考Apusic 
              Application Server安装手册。 <br>
              　　下载JDK1.2，Apusic Application Server必须运行在JDK1.2以上环境中。可从以下站点下载最新JDK。 
              <br>
              http://java.sun.com <br>
              　　下载Apusic Application Server<br>
              Apusic Application Server 试用版可从以下网址得到： <br>
              　　http://www.apusic.com/download/enter.jsp <br>
              　　在下载完成后，你可以得到一个包裹文件apusic.zip，选定安装目录，假设安装到/usr下，则用以下命令： <br>
              cd /usr<br>
              jar xvf apusic.zip <br>
              /usr下会出现一个目录apusic，Apusic Application Server的所有程序都被解压到/usr/apusic下。 
              <br>
              将以下路径加入到CLASSPATH中 <br>
              /usr/apusic/lib/apusic.jar<br>
              $JAVA_HOME/lib/tools.jar <br>
              用以下命令运行Apusic Application Server <br>
              java -Xms64m com.apusic.server.Main -root /usr/apusic </p>
            <p>2、定义EJB远程接口(Remote Interface)<br>
              　　任何一个EJB都是通过Remote Interface被调用，EJB开发者首先要在Remote Interface中定义这个EJB可以被外界调用的所有方法。执行Remote 
              Interface的类由EJB生成工具生成。 <br>
              　　以下是HelloBean的Remote Inteface程序： <br>
              package ejb.hello;</p>
            <p>import java.rmi.RemoteException;<br>
              import java.rmi.Remote;<br>
              import javax.ejb.*;</p>
            <p>public interface Hello extends EJBObject, Remote {</p>
            <p>//this method just get &quot;Hello World&quot; from HelloBean.<br>
              public String getHello() throws RemoteException;<br>
              }</p>
            <p>3、定义Home Interface<br>
              　　EJB容器通过EJB的Home Interface来创建EJB实例，和Remote Interface一样，执行Home Interface的类由EJB生成工具生成。 
              <br>
              以下是HelloBean 的Home Interface程序： <br>
              package ejb.hello; </p>
            <p>import javax.ejb.*;<br>
              import java.rmi.Remote;<br>
              import java.rmi.RemoteException;<br>
              import java.util.*;</p>
            <p>/**<br>
              * This interface is extremely simple it declares only<br>
              * one create method.<br>
              */<br>
              public interface HelloHome extends EJBHome {</p>
            <p>public Hello create() throws CreateException, <br>
              RemoteException;</p>
            <p>}</p>
            <p>4、写EJB类<br>
              　　在EJB类中，编程者必须给出在Remote Interface中定义的远程方法的具体实现。EJB类中还包括一些 EJB规范中定义的必须实现的方法，这些方法都有比较统一的实现模版，编程者只需花费精力在具体业务方法的实现上。 
              <br>
              以下是HelloBean的代码： <br>
              package ejb.hello;</p>
            <p>import javax.ejb.*;<br>
              import java.util.*;<br>
              import java.rmi.*;</p>
            <p>public class HelloBean implements SessionBean {<br>
              static final boolean verbose = true;</p>
            <p>private transient SessionContext ctx;</p>
            <p>// Implement the methods in the SessionBean<br>
              // interface<br>
              public void ejbActivate() {<br>
              if (verbose)<br>
              System.out.println(&quot;ejbActivate called&quot;);<br>
              }</p>
            <p>public void ejbRemove() {<br>
              if (verbose)<br>
              System.out.println(&quot;ejbRemove called&quot;);<br>