kapok

本技術教學向您介紹 Enterprise JavaBeans 2.0（EJB）中容器管理的持久性（Container-Managed Persistence（CMP））和容器管理的關係（Container-Managed Relationships（CMR））。這些特性是 EJB Entity bean 特有的，與一般短時間存在的Session bean 相比較，Entity bean 通常長時間存在。

透過加入以下這些對Entity bean 的進階支援，Enterprise JavaBeans（EJB）2.0 擴充早期的版本 1.1︰

• 更新 Entity bean 的容器管理持久性（CMP）
• 對容器管理關係（CMR）的支援
• 在配置描述子中定義用於可移植的選擇(select)和尋找(find)方法的 EJB 查詢語言（EJB-Query Language（EJB-QL））
• 加入local interfaces和 local home interfaces來最佳化對同一容器中其它 bean 的存取

如果您想要購買或出售元件，您很可能希望在您的元件中有一個持久層，能夠在應用程式伺服器（例如，IBM WebSphere、BEA、WebLogic、JBoss/Tomcat 等等）和持久性儲存系統（比如，Oracle、DB2 等等）上跨平台工作。您不必在 EJB 中編寫底層的 JDBC呼叫來加入這些功能，這就節省大量時間並降低複雜程度。一旦您掌握 CMP/CMR，使用這種技術編寫Entity bean 比在bean-managed persistence（BMP）的 bean 內部使用 JDBC 進行編寫快。

這對您來說意味著什麼呢？對於初學者，您不必編寫低級的 JDBC 呼叫，並且不必編寫程式碼來管理關係。它都內建在 EJB 框架中。關係的介面直接透過大多數 EJB 工作人員已經很熟悉的流行的 java.util.Collection 和 java.util.Set 建置。非常酷﹗

這個額外功能包括對Entity bean 中持久性欄位的 JavaBeans 元件模式的支援。這樣，不用公開您的類別變數 ─ 這總讓我感到很奇怪 ─ 按照我們都知道並喜歡的 JavaBean 的標準命名模式來建立 get 和 set 方法。

我不會過於強調這一點。因為 EJB 2.0 容器將支援大多數通用的 SQL 資料庫（以及其它資料儲存），您可以編寫使用多種類型資料庫的元件。這使得出售要求持久儲存的元件更容易。例如，您可以出售將在使用 Oracle 的 IT 部門或使用 DB2 的商店發揮作用的元件。這樣，不用使用 SQL 編寫低級 JDBC 呼叫（特定於某個特殊的資料庫），您將使用 EJB-QL 來建立尋找程式和選擇方法，並在配置描述子中描述關係。

簡單地說，CMP/CMR 是跨平台元件建立中所缺少的環節。CMP/CMR 將刺激企業級元件市場的增長。此外，CMP/CMR 比低級 JDBC 呼叫更容易使用。CMP/CMR 改正很多不足之處，彌補了 CMR 早期版本中缺少的功能。雖然有很多持久性框架，但是沒有一個能和 EJB CMP/CMR 一樣，在那麼多的應用程式伺服器平臺上可用。

對於本技術教學我需要知道什麼？

本技術教學中的範例可在任何支持 EJB 2.0、遵循 J2EE 的應用程式伺服器上執行。範例程式碼盡可能是規範的；這樣，所有範例程式碼被部署到隨 Java 2 SDK，企業版 1.3 一起提供的 J2EE 參考實現中。只要您的應用程式伺服器支援 EJB 2.0（從而支援 CMP/CMR），那麼只修改 Ant 建立腳本和相應的部署描述子，就能將範例程式碼部署到選擇的應用程式伺服器。

儘管您不必是一位專家，但是本技術教學假設您對 Java 很熟悉，並且對 EJB 有一定程度的瞭解。因為我將講述用 XML 編寫的部署描述子，所以您應該具備 XML 的基礎知識。如果您不熟悉 EJB，我建議您閱讀一篇 developerWorks 技術教學，由 Richard Monson-Haefel 和 Tim Rohaly 合著的 Enterprise JavaBeans Fundamentals（請參閱參考資料）。這是一篇由傑出作者所著的優秀技術教學。即使您不逐字地閱讀該技術教學，我建議您至少將它作為參考。

雖然就本質而言，Ant（一種類似於 make 的基於 XML、開放源代碼的構建系統）方面的知識不是先決條件，但是將有助於您理解範例中出現的構建腳本。

您不需要 JDBC 方面的知識，因為本技術教學中將沒有低級呼叫，但是，SQL 和關聯資料庫理論的基本知識是需要的。

我沒有編寫要花費幾天時間來精讀的長篇大論式的技術教學。我將技術教學分為三部分，每部分可以在一小時左右看完。您可以在一個午餐休息時間內完成每篇技術教學的學習，那麼請帶上三明治和飲料，開始學習。

EJB 2.0 加入大量的特性和功能，本技術教學主要討論 CMP/CMR。這樣，本技術教學假設您具有 EJB 和Entity bean 方面的背景知識。要理解本技術教學，您不必是一位 EJB 專家。技術教學講述 local interfaces、配置描述子 CMP、CMR 欄位和關係元素。我們還將全面講解關係類型，如下所示︰

• 一對一
• 一對多
• 多對多

範例中的關係還包括單向支援和雙向支援。這些關係在 XML 配置描述子中定義。

在第 1 部分技術教學中，您將接觸到 CMP/CMR 和 EJB-QL，然後，我將深入到一個簡單的 EJB 2.0 風格的 CMP Entity bean 的範例中。這個範例的一部分展示了在不需要 Java 實作的情況下，如何使用簡單的 EJB-QL 來建立尋找程式方法。本技術教學正是要讓您適應這些術語和技術，技術教學中增加了一個饒有趣味的範例。下一部分，也即第 2 部分技術教學才是重點內容所在。

在第 2 部分技術教學中，我將以第一個範例為基礎，最終講述每一種類型的關係和每一種類型的方向（單向和雙向形式）。每個範例還有一個說明透過存取關係來加入、刪除和變更相關成員的Client。最後，以一對一關係範例和一對多關係範例的結果來說明串聯刪除(cascade-delete)。

在第 3 部分技術教學中，我將說明用進階 EJB-QL 來建置尋找程式和選擇方法。這篇技術教學使用我在前一技術教學中建置的關係來說明 EJB-QL 的來龍去脈。

每個範例包括下面這些程式碼︰配置描述子、實作類別文件、Interface 類別文件、Home Interface 類別文件和一個 Ant 建置腳本。對於這些範例，我將使用隨 Cloudscape RDBMS 系統提供的 J2EE 參考實作。

在這些技術教學將來的後續文章中，我們將把最後一個範例移植到  IBM WebSphere加上 DB2 和 JBOSS 加上HypersonicSQL 環境中，來說明怎樣能將 CMP 2.0 Entity bean 佈署到多種環境︰從輕量級單使用者資料庫到使用完全可伸縮的龐大資料庫的工業級的交易伺服器﹗這篇文章將討論不同 CMP 2.0 實作的一些缺陷。

既然我已經陳述技術教學將講述的內容，那麼我們來簡單地回顧一下我不會講述的內容。我將不會（詳細）講述對交易的支援，因為這對 EJB 2.0 來說並不是新東西。還因為本文主要討論 CMP/CMR，因此沒有必要講述 Message-driven bean 或 Session bean。（Session bean 和交易將出現，但我不作詳細解釋，因為它們在許多其它資源中詳細講述了，要獲取更多的詳細資訊，請參閱參考資料部分。）

請記住，要從本技術教學中獲益，您不必是一位 EJB 專家，而一些細節將留給其它參考資料來說明。雖然由於範例的需要涉及到一些 EJB-QL，但是我們也沒有很詳細地講述 EJB-QL。希望有深入講述 EJB-QL 的後續文章或技術教學。

本技術教學中全都是 EJB 範例，更不用說配置描述子和範例Client了。因此，您將需要 Java SDK 1.3 或更高版本和遵循 J2EE 的應用程式伺服器，參考實作也可以。這裡是必需的工具的清單︰

• 純文字編輯器。IDE 也可以。
• Java 開發環境，比如，Java SDK 1.3 或更高版本。
• 持久性資料儲存，也就是說，很可能是遵循 SQL 的資料庫。
• 您選擇的持久性資料儲存的 JDBC 驅動程式。
• 遵循 EJB 2.0 的 J2EE 應用程式伺服器。
• Ant 建置系統。用來建置和封裝這些範例。

正如上面所陳述的，所有的範例都是在 J2EE 參考實作中完成的，該實作作為 J2EE SDK 1.3 的一部分，可免費得到。

應用程式設計

實體設計

本技術教學使用一個線上內容管理系統的虛擬認證子系統範例，它具有以下這些功能︰

• 將使用者登入到系統
• 認證使用者處於某種角色
• 容許將使用者組織成群組，從而容許進行群組作業
• 儲存諸如位址和連絡訊息這樣的使用者訊息
• 管理角色、使用者和群組

我之所以挑選這個領域是因為大多數工作人員對它有一定程度的瞭解，我希望本技術教學的內容用來講述技術，而不是範例所屬的領域。

圖 1︰我們範例中的 User、Group、Role 和 UserInfo 實體

圖 1 系統中的實體的概述表明有四個截然不同的實體︰User、Group、Role 和 UserInfo。這些實體中的每一個都有下面這三種關係︰

• User 與 Role 相關聯（多對多）
• 一個 User 有一條 UserInfo（一對一）
• 一個 Group 有多個 User（一對多）

在關係資料庫中，這些實體的每一個都很可能都有一個它自己的表格以及一個對應於任何多對多關係的表格。這樣，這個範例應用程式由五個表組成，使用關係資料庫為模型。

Client透過Session bean 存取系統

本範例中的所有Entity bean 都是 local Entity bean。Local bean 不能由遠端Client存取。它們也不能由一個方法返回。這樣，所有對本範例中實體的存取都透過一個

圖 2︰作業和關聯圖

從上面這個圖您可以看到，UserManagement

圖 3︰Client應用程式存取的 UserManagement 的塊圖。

圖 3 說明Client只存取 UserManagementBean。在本範例中，它不直接存取任何其它 bean。另請注意，Client在另一個位址空間內；實際上它可以在世界上任何地方的另一台電腦上。Client遠端存取Session bean UserManagementBean。

範例概述

當我閱讀一個技術教學時，有一件事我很討厭︰技術教學中的範例太複雜。我忍受不了陷入那些理解技術所不必要的細節中。

我還喜歡看原始碼，並且盡可能地編譯和執行它。直到您能夠使範例執行，這個範例才是很實在的，您可以瀏覽一下程式碼。請記住這一點，我們把技術教學範例分為難度逐漸增加的範例，每一個範例都有自動的建置文件。這樣，當您第一次檢視 CMP 時，您不必擔心 EJB-QL 等等。由於技術教學逐漸加深難度，我們建議您按照正確的順序進行學習。

範例如下︰

• 第一個範例向您介紹 CMP 的概念，包括在配置描述子中定義 CMP 欄位。這個範例還說明怎樣從另一個 bean 參照企業 bean，以及怎樣從一個Client參照企業 bean。這個範例只有兩個 bean︰UserBean 和 UserManagementBean。這個範例在第一篇技術教學，即第 1 部分中。
• 第二個範例使用 EJB-QL 將一個 findAll() 方法新增到 home 介面。這個範例只是對上一個範例稍做變更，目的是說明 EJB-QL。它有同樣數目的 bean。這個範例也在目前這篇技術教學，即第 1 部分中。
• 第三個範例講述了加入 UserInfoBean，以及在 UserBean 和 UserInfoBean 之間建立一對一的雙向關係。這個範例在第二篇技術教學，即第 2 部分中。
• 在第四個範例中，我們講述了加入 RoleBean，以及在 UserBean 和 RoleBeans 之間建立多對多的單向關係。這個範例在第二篇技術教學，即第 2 部分中。
• 在第五個範例中，我們講述了加入 GroupBean，以及在 GroupBean 和 UserBean 之間建立一對多的雙向關係。這個範例在第二篇技術教學，即第 2 部分中。
• 最後一個範例擴充了第五個範例，加入了 EJB-QL 來說明瀏覽物件的集合。這個範例在的第三篇技術教學，即第 3 部分中。

整個技術教學是以程式碼為中心的，每一部分的程式碼都涉及到︰Client、Entity bean 和Session bean。

建立Entity bean

CMP 基礎知識︰透過範例來說明

第一個範例向您介紹 CMP 的基本概念，包括下面這些︰

• 在配置描述子中定義 CMP 欄位，
• 怎樣從另一個 bean 參照一個企業 bean，
• 怎樣從一個Client參照一個企業 bean。

在這個範例中，我們將建立三個東西︰

• 一個使用CMP 的Entity bean（UserBean）。
• 一個存取Entity bean 的Session bean（UserManagementBean）。
• 一個存取Entity bean 的Client（Section2Client）。

UserBean

UserBean 代表系統中的使用者。UserBean 像所有企業 bean 一樣，需要下面這三個 Java 原始文件︰一個 home、一個介面和一個實作。這樣，我們需要定義下面這些程式碼︰

• local interfaces（LocalUser）
• local home interfaces（LocalUserHome）
• Entity bean 類別（UserBean）

這個範例的原始碼可以在 cmpCmr/section2/src 中找到。要編譯這個範例，請前往 cmpCmr/section2 並在指令提示符後輸入 ant。將在 cmpCmr/section2/final 目錄中建立一個樣本 .ear。如果您使用的是參考實作，您可以使用 deploytool 程式佈署這個 .ear。

第一步是定義 CMP 欄位。CMP 欄位是您希望 EJB 容器持久儲存的欄位。一個Entity bean 有多個 CMP 欄位，這些欄位是虛欄位。與 CMP 1.0 不同，在 CMP 2.0 中您不給 CMP 欄位定義成員變數。相反，您使用 JavaBeans 屬性命名約定，定義與您希望持久儲存的欄位名相對應的虛 getter 和 setter 方法。在介面和實作中，您都要加入這些抽象方法。下面的程式碼說明了這個概念︰

package com.rickhightower.auth;

import javax.ejb.EJBLocalObject;

public interface LocalUser extends EJBLocalObject {

    public String getEmail();
    public String getPassword();

}			 
			 

因為我們給 UserBean 的 email 和 password CMP 欄位只定義了 getter，所以它們都被認為是唯讀欄位。相反，即使屬性是唯讀的，實作Entity bean 也必須給該屬性定義 getter 和 setter 方法。

在Entity bean 類別中定義 CMP 欄位（實作）

與 local interfaces不同，即使 CMP 欄位是唯讀的，實作Entity bean 類別也必須給 CMP 欄位定義 getter 和 setter 方法。CMP 欄位的 getter 和 setter 方法是抽象方法，因為此處的實作將由 EJB 容器定義。實作類別的程式碼如下所示︰

package com.rickhightower.auth;
      
public abstract class UserBean implements EntityBean {
      
    public abstract String getEmail();
    public abstract void setEmail(String email);
    
    public abstract String getPassword();
    public abstract void setPassword(String password);
         
}			 

請注意Entity bean 被宣告為是抽象的，它的 CMP 欄位定義抽象的 getter 和 setter 方法。（請注意省略號簡化了清單關鍵的部分。）

很可能您將不得不把實體映射到一個資料庫表格並將 CMP 欄位映射到這個表格的列。以下展示一個樣本表格，這個表格可以用來與這個實體相結合。

UserBean 的樣本表格

UserBean 中的 CMP 欄位可以與關係表中的欄位對應，用下面的 SQL DDL 定義︰

            CREATE TABLE TBL_USER (
                email varchar (50)  PRIMARY KEY,
                password varchar (50) NOT NULL
            )
 

請注意，因為從實體到表格的映射留給各個 EJB 容器來做，所以我們在本技術教學中將不講述映射的細節問題。（這將在接下來的文章中講到，該文章將這些範例移植到 WebLogic 和 JBoss 中。）相反，我們使用由 J2EE 參考實作提供的預設映射。

在配置描述子中定義 CMP 欄位

每一個 CMP 欄位必須在配置描述子中定義，如下所示︰
        
      <cmp-field>
        <field-name>password</field-name>
      </cmp-field>

      <cmp-field>
        <field-name>email</field-name>
      </cmp-field>
 

雖然配置描述子中 CMP 欄位的定義由 EJB 規範指定，但是仍沒有將Entity bean 映射到 SQL 表格並將 CMP 欄位映射到 SQL 列的標準方法。（我希望這在 EJB 規範的下一個版本中得到解決。）

映射由 EJB 容器實作決定。這一點在 EJB 將來的發行版中很可能會改變。因為參考 J2EE 應用程式伺服器的實作不容許輕易地從Entity bean 映射到 SQL 表，所以這個範例採用透過使用 deploytool 所定義的映射。

您將不必完成映射。映射由所包括的 Ant 建置腳本提供。

在配置描述子中定義主索引鍵欄位

每個Entity bean 必須有一個主索引鍵。UserBean 的主索引鍵是 email CMP 欄位。這樣，主索引鍵欄位及其類型必須在配置描述子中指定，就像Entity bean 那樣，如下所示︰
        
      <prim-key-class>java.lang.String</prim-key-class>
          
      <primkey-field>email</primkey-field>


配置描述子

您可能期望瞭解配置描述子的其它部分。請注意配置描述子使用 <cmp-version>2.x</cmp-version> 來指定所需要的 CMP 的版本。這一項加入進去，從而適應支援 CMP 1.0 和 2.0 風格的具有容器管理的持久性的 EJB 容器。完整的配置描述子如下所示︰

清單 1︰UserBean 的配置描述子

<?xml version="1.0" encoding="GB2312"?>

<!DOCTYPE ejb-jar PUBLIC '-//Sun Microsystems, Inc.//DTD Enterprise JavaBeans 2.0//EN' 'http://java.sun.com/dtd/ejb-jar_2_0.dtd'>

<ejb-jar>
  <display-name>user-mgmt-beans</display-name>
  <enterprise-beans>
    <entity>
      <display-name>UserBean</display-name>
      <ejb-name>UserBean</ejb-name>

      <local-home>com.rickhightower.auth.LocalUserHome</local-home>
      <local>com.rickhightower.auth.LocalUser</local>
      <ejb-class>com.rickhightower.auth.UserBean</ejb-class>

      <persistence-type>Container</persistence-type>
      <prim-key-class>java.lang.String</prim-key-class>

      <reentrant>True</reentrant>
      <cmp-version>2.x</cmp-version>

      <abstract-schema-name>UserBean</abstract-schema-name>

      <cmp-field>
        <description>no description</description>
        <field-name>password</field-name>
      </cmp-field>
      <cmp-field>
        <description>no description</description>
        <field-name>email</field-name>
      </cmp-field>

      <primkey-field>email</primkey-field>

       			 			 
    </entity>

  </enterprise-beans>
       			 			
</ejb-jar>
			

 尋找程式和建立方法

建立方法

到此為止，我們講述定義 CMP 欄位。另一個主要特性是 CMP 2.0 定義 findByPrimaryKey() 方法。請注意 Entity bean 類別中缺少 ejbFindByPrimaryKey()，因為 ejbFindByPrimaryKey() 由 EJB 容器定義。尋找程式方法，findByPrimaryKey() 必須在 home 介面中宣告（在下面列出）。

最後，我們來講述建立 UserBean 的能力。UserBean 實體類別定義了兩個建立方法，ejbCreate() 和 ejbPostCreate()。因為 email 和 password CMP 欄位是唯讀的（在local interfaces中，email 和 password CMP 欄位沒有 setter 方法），容許使用 ejbCreate() 方法來初始化它們是比較謹慎的，如下所示︰

package com.rickhightower.auth;

public abstract class UserBean implements EntityBean {

   public String ejbCreate(String email, String password)
                                                  throws CreateException {
        setEmail(email);
        setPassword(password);
        return null;
    }

   public void ejbPostCreate(String email, String password) { }

}

您要注意的一件事是這些方法的實作實際上是空的。另請注意，ejbCreate() 方法呼叫的 setEmail、setPassword 方法是抽象的；這樣，在它們由 EJB 容器在佈署過程中定義。

請記住，ejbCreate() 方法在容器將行插入到資料庫之前被呼叫，而 ejbPostCreate() 在容器將行插入到資料庫之後被呼叫。因為容器管理Entity bean 的建立，所以 ejbCreate() 方法返回 null。home 介面中適當的建立方法如下所列︰

package com.rickhightower.auth;

import javax.ejb.EJBLocalHome;
import javax.ejb.CreateException;
import javax.ejb.FinderException;

public interface LocalUserHome extends EJBLocalHome {

    public LocalUser create (String email, String password)
                                        throws CreateException;

    public LocalUser findByPrimaryKey (String email)
                                        throws FinderException;

}

請注意，home 介面建立方法的參數與 ejbCreate() 和 ejbPostCreate() 方法的參數匹配，這是任何經驗豐富的 EJB 工作人員都會料想到的。Entity bean 類別的完整的程式碼清單如下所列︰

清單 2︰UserBean 的程式碼
package com.rickhightower.auth;


import javax.ejb.EntityBean;
import javax.ejb.EntityContext;
import javax.ejb.CreateException;


public abstract class UserBean implements EntityBean {

    public String ejbCreate(String email, String password)
                                                  throws CreateException {
        setEmail(email);
        setPassword(password);
        return null;
    }
        
    public void ejbPostCreate(String email, String password) { }

    public abstract String getEmail();
    public abstract void setEmail(String email);
   
    public abstract String getPassword();
    public abstract void setPassword(String password);
   
    public void setEntityContext(EntityContext context){ }
    public void unsetEntityContext(){ }
    public void ejbRemove(){ }
    public void ejbLoad(){ }
    public void ejbStore(){ }
    public void ejbPassivate(){ }
    public void ejbActivate(){ }

}
 

我們完成第一個範例的實際工作。那是我們編寫一個 CMP Entity bean 必須做的所有事情；範例 1 的其它部分只說明了怎樣存取，以及怎樣將這個 bean 封裝以便在網路上使用。

CMP 欄位將由容器管理。我們所必須做的是用虛 getter 和 setter 方法來表示 CMP 欄位。

此外，findByPrimaryKey() 方法完全由容器定義。我們必須定義特定於應用程式的建立方法，而建立方法的實作實際上是空的﹗

我們前面已經講過，CMP Entity bean 通常是local bean。您不能直接從遠端Client存取 local bean。於是，接下來我們定義用來存取這個Entity bean 的Session bean。

 建立Session bean

UserManagementBean（Session bean）

C

UserManagementBean 有用來建立、刪除以及驗證使用者密碼的操作。目前為止，它是唯一會直接訪問 UserBean 的類別。

圖 4：UserManagement 操作和關聯圖

為了讓 UserManagementBean 管理使用者，它將不得不尋找 UserBean 的 home 介面。

UserManagement 透過尋找 UserBean 的 home 介面來存取 UserBean 實體，如下所示︰

package com.rickhightower.auth;


import javax.naming.Context;
import javax.naming.InitialContext;

import javax.naming.NamingException;

public class UserManagementBean implements SessionBean {

		
   private LocalUserHome getUserHome() throws NamingException {
        Context initial = new InitialContext();
        return (LocalUserHome) initial.lookup("java:comp/env/ejb/LocalUser");
   }
	
			 

請注意 getUserHome() 方法是一個私有的助手方法(helper method)，它返回對 UserBean 方法的 home 介面（LocalUserHome）的參照。為了使 UserManagementBean 能夠存取 UserBean 的 home 介面，必須將下面的內容新增到 UserManagementBean 的配置描述子的 session 元素中，如下所示︰

<session>

      ...
      <ejb-local-ref>
        <ejb-ref-name>ejb/LocalUser</ejb-ref-name>
        <ejb-ref-type>Entity</ejb-ref-type>
        <local-home>com.rickhightower.auth.LocalUserHome</local-home>
        <local>com.rickhightower.auth.LocalUser</local>
        <ejb-link>userEntity.jar#UserBean</ejb-link>
      </ejb-local-ref>
	...			
			

請注意 ejb-local-ref 定義對 UserBean 的參照。（UserBean 包括在叫做 userEntity.jar 的 .jar 文件中，我們將在以下詳細講述如何將您的應用程式封裝。）

UserManagementBean 將對 home 介面的參照作為私有成員變數儲存。Session bean 在 ejbCreate() 和 ejbActivate 方法的建立和活化期間尋找Entity bean，如下所示︰

package com.rickhightower.auth;


public class UserManagementBean implements SessionBean {
			 
			 
    private  LocalUserHome userHome = null;
			 
    public void ejbCreate() throws CreateException {

        try {
            userHome = getUserHome();
        } catch (NamingException e) {
            throw new CreateWrapperException(
                "Unable to find local user home in ejbCreate", e);
        }
    }
    
    public void ejbActivate() {

        try {
            userHome = getUserHome();
        } catch (NamingException e) {
            throw new EJBException(
                "Unable to find local user home in Activate", e);
        }
    }

}		
			 

這樣 home 介面對於Session bean 的商業方法總是可用的。

建立Client應用程式

/** Client code */			 
package com.rickhightower.client;

import com.rickhightower.auth.UserManagement;
import com.rickhightower.auth.UserManagementHome;

import javax.naming.Context;
import javax.naming.InitialContext;
import javax.rmi.PortableRemoteObject;

public class Section2Client {

   public static void main(String[] args) {
       try {
           Context initial = new InitialContext();
           Object ref = 
                 initial.lookup("java:comp/env/ejb/UserManagement");
           UserManagementHome home = 
            (UserManagementHome)PortableRemoteObject
                              .narrow(ref,UserManagementHome.class);

           /* Create the users--Rick and Nick */
           UserManagement userMgmt = home.create();
           userMgmt.addUser("rick@rickhightower.com", "mypassword");
           userMgmt.addUser("nick@rickhightower.com", "oxford");

           /* Verify Rick's Password */
           boolean login = false;
           login = userMgmt.verifyPassword("rick@rickhightower.com",
                                                      "mypassword");

           System.out.println("Login =" + login);
           
           /* Remove the users--Rick and Nick */
           userMgmt.removeUser("rick@rickhightower.com");
           userMgmt.removeUser("nick@rickhightower.com");
           
       } catch (Exception e) {
           System.err.println("MESSAGE:" + e.getMessage());
           e.printStackTrace(System.err);
       }
   }

}
			

						
<?xml version="1.0" encoding="GB2312"?>

<!DOCTYPE application-client PUBLIC '-//Sun Microsystems, Inc.//DTD
J2EE Application Client 1.3//EN'
'http://java.sun.com/dtd/application-client_1_3.dtd'>

<application-client>
  <display-name>Section2Client</display-name>
  <ejb-ref>
    <ejb-ref-name>ejb/UserManagement</ejb-ref-name>
    <ejb-ref-type>Session</ejb-ref-type>
    <home>com.rickhightower.auth.UserManagementHome</home>
    <remote>com.rickhightower.auth.UserManagement</remote>
    <ejb-link></ejb-link>
  </ejb-ref>
</application-client>

  		    

						
Manifest-Version: 1.0
Main-Class: com.rickhightower.client.Section2Client
  		    

 編譯和包裝應用程式

編譯和包裝您的應用程式

 尋找程式方法和 EJB-QL

編譯和佈署 findAll() EJB-QL 範例

結論

我們完成最前面的兩個範例。所有其它的範例都是基於這兩個範例的。

我講述 CMP Entity bean 的定義；建立參照和使用Entity bean 的Session bean；並建立參照和使用Session bean 的Client。然後，透過將一個尋找程式方法新增到實體的 bean home 介面，我對Entity bean 進行擴充。尋找程式方法的實作是在Entity bean 配置描述子中使用 EJB-QL 定義的。

如果您對此已經理解得很透徹，恭喜您﹗您已經登峰造極。所有比這裡的主題更簡單的內容都可以迎刃而解。

本系列的下一篇技術教學將講述定義容器管理的關係。

• 關於 EJB CMP/CMR 和 EJB-QL 的優秀技術教學 http://www.caucho.com/products/resin-ejb/ejb-tut/cmp-tut.xtp
• Sun 的 J2EE 技術教學 http://developer.java.sun.com/developer/onlineTraining/J2EE/Intro/
• Developer's Guide to Understanding EJB 2.0（由 Rick Hightower 更新）http://www.triveratech.com/dloads/index.html
• Enterprise JavaBeans fundamentals http://www-105.ibm.com/developerWorks/education.nsf/java-onlinecourse-bytitle/EB2ADE177F8C3EF386256A0A006DCBCD?OpenDocument

• Ed Roman、Scott W. Ambler、Tyler Jewell、Floyd Marinescu 合著的 Mastering Enterprise JavaBeans (2nd Edition)，EJB 的百科全書﹗ http://www.amazon.com/exec/obidos/ASIN/0471417114
• Richard Monson-Haefel 所著的 Enterprise JavaBeans (3nd Edition)，也請買下這本書﹗ http://www.amazon.com/exec/obidos/ASIN/0596002262
• Richard Hightower、Nicholas Lesiecki 合著的 Java Tools for Extreme Programming，講述了用 EJB 建置和佈署 J2EE。http://www.amazon.com/exec/obidos/ASIN/047120708X