< 上一個課程 | 下一個課程 >

第 2 課:開發 EJB

關於這項作業

在本課程中,您將建立 Session Bean、開發本端介面,以及開發 Bean 的實作類別。您也將使用「管理 EJB 匯出項目」對話框,將 EJB 顯露成一項 OSGi 服務。

建立 Session Bean

關於這項作業

在本節中,您將建立 Session Bean,並指定本端介面。

程序

  1. 開啟 Session Bean 精靈。 在 EJB 專案中,用滑鼠右鍵按一下 ejbModule,並選取新建 > Session Bean (EJB 3.x)。
  2. 建立 Bean。 在精靈中輸入下列值:
    專案
    EJB
    Java™ 套件
    com.ibm.example.impl
    類別名稱
    EJBConverter
    狀態類型
    Stateless
    本端
    選取本端勾選框,並輸入下列值:com.ibm.example.EJBConverterLocal
    無介面視圖
    清除無介面視圖
    建立 EJB 3.x Session Bean
    註: 本指導教學中所開發的應用程式使用的是本端介面。如果您想使用遠端介面,請在精靈中選取遠端勾選框,然後開發對應的介面。遠端介面的 JNDI 查閱方式會有所不同。如果使用遠端介面,請調整查閱碼。下一課會提供範例。
  3. 按一下完成。 會建立 Session Bean,並在編輯器中開啟類別。

開發本端介面

關於這項作業

建立 Session Bean 之後,會在 EJBClient 專案中建立 EJBConverterLocal 介面。在本節中,您將新增兩個方法至介面。這些方法說明基本溫度轉換運算。

程序

  1. 開啟 EJBConverterLocal 介面。 在 EJBClient 專案中,展開 ejbModule 資料夾和 com.ibm.example 套件。按兩下 EJBConverterLocal 介面。該介面會在編輯器中開啟。
  2. 新增方法至介面。 新增下列方法至介面:
    public double convertToFahrenheit(double celsius);
    public double convertToCelsius(double fahrenheit);
    下列程式碼為結果:
    package com.ibm.example;
    
    public interface EJBConverterLocal {
    
       public double convertToFahrenheit(double celsius);
    
       public double convertToCelsius(double fahrenheit);
    
    }
  3. 儲存變更。 請注意,在您儲存介面檔時,會顯示 EJBConverter 類別錯誤,這是因為它尚未實作您新增至介面的方法。

開發實作類別

關於這項作業

在本節中,您將實作本端介面所需的溫度轉換方法。

程序

  1. 開啟 EJBConverter 類別。 在 EJB 專案中,展開 ejbModule 資料夾和 com.ibm.example.impl 套件。按兩下 EJBConverter 類別。該類別會在編輯器中開啟。
  2. 移除預設建構子。
  3. 針對您新增至 EJBConverterRemote 介面的兩個方法,新增其實作。 新增下列方法實作至類別:
    public double convertToCelsius(double fahrenheit) {
       return (fahrenheit - 32) * (5 / 9d);
    }
    
    public double convertToFahrenheit(double celsius) {
       return celsius * (9 / 5d) + 32;
    }
    已完成的類別與下列程式碼相仿。請注意,精靈產生的原始程式碼含有 @Stateless 註釋及 @Local 註釋,而 @Local 註釋是指定您在 Session Bean 精靈中所輸入的本端介面。
    package com.ibm.example.impl;
    
    import com.ibm.example.EJBConverterLocal;
    import javax.ejb.Local;
    import javax.ejb.Stateless;
    
    @Stateless
    @Local(EJBConverterLocal.class)
    public class EJBConverter implements EJBConverterLocal {
    
       public double convertToCelsius(double fahrenheit) {
          return (fahrenheit - 32) * (5 / 9d);
       }
    
       public double convertToFahrenheit(double celsius) {
          return celsius * (9 / 5d) + 32;
       }
    }
  4. 儲存變更。

將 EJB 顯露成 OSGi 服務

關於這項作業

依預設,當您在具備 EJB 支援的 OSGi 專案中新增 EJB 時,會將這些 EJB 自動顯露成 OSGi 服務。您是透過 OSGi 資訊清單中的 Export-EJB 標頭,來控制 OSGi 服務的顯露。在本節中,您將檢查資訊清單,並使用「管理 EJB 匯出項目」對話框,來確認 EJBConverter 會顯露成 OSGi 服務。

程序

  1. 開啟資訊清單。 在 EJB 專案中,按兩下資訊清單:EJB。即會開啟資訊清單。按一下 MANIFEST.MF 標籤,以文字格式來檢視檔案。請注意,Export-EJB 標頭會有一個 EJBConverter EJB 項目。請注意,您可以手動新增項目至 Export-EJB 標頭,來管理 EJB 匯出項目。EJB 可新增成以逗點區隔的清單。
    註: Export-EJB 標頭有兩種特殊情況要注意:
    NONE
    如果您指定 NONE 作為 Export-EJB 標頭的項目,則不會將任何 EJB 顯露成服務。如果您指定 NONE,之後卻將 EJB 新增至清單,則工具會顯示警告。
    BLANK
    如果資訊清單中有 Export-EJB 標頭,但卻無任何項目,依預設,會將專案中的所有 EJB 顯露成服務。
  2. 開啟「管理 EJB 匯出項目」對話框。 用滑鼠右鍵按一下 EJB 專案,並選取 OSGi > 將 EJB 顯露成 OSGi 服務。即會開啟「管理 EJB 匯出項目」對話框。在對話框中,確認已選取 EJBConverter EJB 旁的方框,然後按一下確定。您可以在專案中使用這個對話框,來新增與移除顯露成服務的 EJB。如果您變更這個對話框中選取的 EJB,則會變更資訊清單中之 Export-EJB 標頭的項目。
    「管理 EJB 匯出項目」對話框
    註: 如果您在專案中建立新的 EJB,會自動將它們顯露成 OSGi 服務。您可以使用「管理 EJB 匯出項目」對話框,來清除您不想顯露的任何 EJB。
< 上一個課程 | 下一個課程 >
Icon that indicates the type of topic Tutorial lesson topic
Timestamp icon Last updated: last_date

File name: osgi_ejb_2.html