五、EJB的編程環境：

1、 使用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文件中。

2、使用Jbuilder之外的集成環境：
　　如果你使用其它的除了別的集成環境（IDE）。要確定使用了集成環境IDE所帶的容器工具。也要驗證IDE是否支持EJB規范的相應的版本，還要確定它是否正確的支持EJB的API。
　　要確定JD到所支持的EJB容器的版本。可以通過檢查Inprise的安裝說明來確定EJB容器所支持的支持JDK的版本。
　　在配置Enterprise Bean的時候，你必須使用Inprise的應用服務器所提供的工具。這些工具能夠編輯和修改第三方的代理商提供的Inprise配置描述器。還能夠驗證配置描述器，能夠驗證bean的源代碼。

六、一個簡單的HELLO例子

1、安裝Apusic Application Server
　　Note:以下以Linux為例，來說明Apusic Application Server的安裝過程。其他平臺的安裝，可參考Apusic Application Server安裝手冊。
　　下載JDK1.2，Apusic Application Server必須運行在JDK1.2以上環境中。可從以下站點下載最新JDK。
http://java.sun.com
　　下載Apusic Application Server
Apusic Application Server 試用版可從以下網址得到：
　　http://www.apusic.com/download/enter.jsp
　　在下載完成后，你可以得到一個包裹文件apusic.zip，選定安裝目錄，假設安裝到/usr下，則用以下命令：
cd /usr
jar xvf apusic.zip
/usr下會出現一個目錄apusic，Apusic Application Server的所有程序都被解壓到/usr/apusic下。
將以下路徑加入到CLASSPATH中
/usr/apusic/lib/apusic.jar
$JAVA_HOME/lib/tools.jar
用以下命令運行Apusic Application Server
java -Xms64m com.apusic.server.Main -root /usr/apusic

2、定義EJB遠程接口(Remote Interface)
　　任何一個EJB都是通過Remote Interface被調用，EJB開發者首先要在Remote Interface中定義這個EJB可以被外界調用的所有方法。執行Remote Interface的類由EJB生成工具生成。
　　以下是HelloBean的Remote Inteface程序：
package ejb.hello;

import java.rmi.RemoteException;
import java.rmi.Remote;
import javax.ejb.*;

public interface Hello extends EJBObject, Remote {

//this method just get "Hello World" from HelloBean.
public String getHello() throws RemoteException;
}

3、定義Home Interface
　　EJB容器通過EJB的Home Interface來創建EJB實例，和Remote Interface一樣，執行Home Interface的類由EJB生成工具生成。
以下是HelloBean 的Home Interface程序：
package ejb.hello;

import javax.ejb.*;
import java.rmi.Remote;
import java.rmi.RemoteException;
import java.util.*;

/**
* This interface is extremely simple it declares only
* one create method.
*/
public interface HelloHome extends EJBHome {

public Hello create() throws CreateException,
RemoteException;

}

4、寫EJB類
　　在EJB類中，編程者必須給出在Remote Interface中定義的遠程方法的具體實現。EJB類中還包括一些 EJB規范中定義的必須實現的方法，這些方法都有比較統一的實現模版，編程者只需花費精力在具體業務方法的實現上。
以下是HelloBean的代碼：
package ejb.hello;

import javax.ejb.*;
import java.util.*;
import java.rmi.*;

public class HelloBean implements SessionBean {
static final boolean verbose = true;

private transient SessionContext ctx;

// Implement the methods in the SessionBean
// interface
public void ejbActivate() {
if (verbose)
System.out.println("ejbActivate called");
}

public void ejbRemove() {
if (verbose)
System.out.println("ejbRemove called");
}

public void ejbPassivate() {
if (verbose)
System.out.println("ejbPassivate called");
}

/**
* Sets the session context.
*
* @param SessionContext
*/
public void setSessionContext(SessionContext ctx) {
if (verbose)
System.out.println("setSessionContext called");
this.ctx = ctx;
}

/**
* This method corresponds to the create method in
* the home interface HelloHome.java.
* The parameter sets of the two methods are
* identical. When the client calls
* HelloHome.create(), the container allocates an
* instance of the EJBean and calls ejbCreate().
*/
public void ejbCreate () {
if (verbose)
System.out.println("ejbCreate called");
}
/**
* **** HERE IS THE BUSINESS LOGIC *****
* the getHello just return a "Hello World" string.
*/
public String getHello()
throws RemoteException
{
return("Hello World");
}
}

5、創建ejb-jar.xml文件
　　ejb-jar.xml文件是EJB的部署描述文件，包含EJB的各種配置信息，如是有狀態Bean(Stateful Bean) 還是無狀態Bean(Stateless Bean)，交易類型等。ejb-jar.xml文件的詳細信息請參閱EJB規范。以下是HelloBean的配置文件：
<?xml version="1.0"?>
<!DOCTYPE ejb-jar PUBLIC "-//Sun Microsystems Inc.//DTD Enterprise JavaBeans 1.2//EN" "http://java.sun.com/j2ee/dtds/ejb-jar_1_2.dtd">
<ejb-jar>
<enterprise-beans>
<session>
<ejb-name>Hello</ejb-name>
<home>ejb.hello.HelloHome</home>
<remote>ejb.hello.Hello</remote>
<ejb-class>ejb.hello.HelloBean</ejb-class>
<session-type>Stateless</session-type>
<transaction-type>Container</transaction-type>
</session>
</enterprise-beans>
<assembly-descriptor>
<container-transaction>
<method>
<ejb-name>Hello</ejb-name>
<method-name>*</method-name>
</method>
<trans-attribute>Required</trans-attribute>
</container-transaction>
</assembly-descriptor>
</ejb-jar>

6、編譯和部署
編譯Java源文件并將編譯后class和ejb-jar.xml打包到Hello.jar
mkdir build
mkdir build/META-INF
cp ejb-jar.xml build/META-INF
javac -d build *.java
cd build
jar cvf Hello.jar META-INF ejb
cd ..
用EJB工具生成可部署到Apusic Application Server中運行的jar文件:
java com.apusic.ejb.utils.EJBGen -d /usr/apusic/classes/Hello.jar build/Hello.jar
增加/usr/apusic/classes/Hello.jar到CLASSPATH中
將Hello.jar加入到Apusic Application Server配置文件中。在/usr/apusic/config/server.xml 加入以下幾行：
<module>
<ejb>
<ejb-uri>classes/Hello.jar</ejb-uri>
<bean>
<ejb-name>Hello</ejb-name>
<jndi-name>HelloHome</jndi-name>
</bean>
</ejb>
</module>
啟動服務器
java -Xms64m com.apusic.server.Main -root /usr/apusic

7、寫客戶端調用程序
　　您可以從Java Client，JSP，Servlet或別的EJB調用HelloBean。
　　調用EJB有以下幾個步驟：
　　通過JNDI(Java Naming Directory Interface)得到EJB Home Interface
　　通過EJB Home Interface 創建EJB對象，并得到其Remote Interface
　　通過Remote Interface調用EJB方法

以下是一個從Java Client中調用HelloBean的例子：
package ejb.hello;

import javax.naming.Context;
import javax.naming.InitialContext;
import java.util.Hashtable;
import javax.ejb.*;
import java.rmi.RemoteException;

/**
* @author Copyright (c) 2000 by Apusic, Inc. All Rights Reserved.
*/
public class HelloClient{
public static void main(String args[]){
String url = "rmi://localhost:6888";
Context initCtx = null;
HelloHome hellohome = null;
try{
Hashtable env = new Hashtable();
env.put(Context.INITIAL_CONTEXT_FACTORY,
"com.apusic.jndi.InitialContextFactory");
env.put(Context.PROVIDER_URL, url);
initCtx = new InitialContext(env);
}catch(Exception e){
System.out.println("Cannot get initial context: " + e.getMessage());
System.exit(1);
}
try{
hellohome = (HelloHome)initCtx.lookup("HelloHome");
Hello hello = hellohome.create();
String s = hello.getHello();
System.out.println(s);
}catch(Exception e){
System.out.println(e.getMessage());
System.exit(1);
}
}

}
運行HelloClient，可得到以下輸出：
Hello World