練習 1.1:安裝

開始在這個指導教學中開發 Portlet 和入口網站之前,您必須先執行一系列的步驟:

  1. 建立專案,並匯入必要資源來開發 Portlet。
  2. 安裝和配置 WebSphere Portal 5.1 版測試環境,這可讓我們測試我們要建置的應用程式。
  3. 配置資料庫伺服器,來提供要在應用程式中執行的資料。

第一步驟就是將預先建置的 EJB 和 EJB 用戶端專案匯入指導教學要用的 Portlet 專案中。您建立 Portlet 專案時所建立的 AuctionPortletEAR 會包含匯入的資源。 這些專案會提供將用來建立 Portlet 專案所包含之 Portlet 的後端服務。

建立新的 Portlet 專案

所有 Portlet 開發作業都是在 Portlet 專案的環境定義中進行的。 如果要建立 UserAdmin Portlet 的 Portlet 專案,請遵循下列步驟:

  1. 開啟 Rational Developer。
  2. 選取檔案 > 新建 > 專案
  3. 選取 Portlet 專案選項。這個選項會產生支援 IBM Portlet API 而不是 JSR 168 Portlet API 的專案資源。按下一步
  4. 確認啟用對話框中,按一下確定。這個對話框會確認您要啟用入口網站開發功能。 功能及一組適當的工具是開發環境的元素, 這些工具會自動操作許多在開發執行於 WebSphere Portal 的入口網站型 Web 應用程式時所需要的程式設計標準和程式碼產生功能。
  5. 將專案命名為 AuctionPortlet
    當您輸入專案名稱時,請注意,(如果您按一下顯示進階 >> 按鈕)這個專案的模組會自動加入類似名稱的 EAR 專案。
  6. 請注意:WebSphere Portal 版本的預設值是 5.1。按下一步
  7. 選取 Faces Portlet 圓鈕,因為這個指導教學所要建立的 Portlet 會利用 JavaServer Faces 所提供的速度和彈性及 Portlet 工具來建置 Web 應用程式的使用者介面。 按下一步
  8. 再按下一步
  9. 在「Portlet 設定」頁面的 Portlet 名稱欄位中,輸入 UserAdmin Portlet,在 Portlet 標題欄位中,輸入使用者管理
  10. 選取變更產生程式碼選項勾選框。在類別字首欄位中,輸入 UserAdminPortlet
  11. 下一步
  12. 在「雜項」頁面中,請注意檢視模式群組的起始頁面值是 /UserAdminView.jsp。 這個預設頁面會產生在專案中,用來作為 UserAdmin Portlet 的主要頁面。 在未來的練習中,我們將新增其他頁面。
  13. 按一下完成

    如果系統會提示您切換至「Web 視景」,請按一下

這時會將預設 Portlet 視圖頁面 UserAdminView.jsp 顯示在工作區的編輯區域中。

匯入這個範例所用的資源

如果要匯入包含建立指導教學所說明的介面和資料存取時所需要的所有預先建置的專案資源之 AuctionPortal.zip,請執行下列動作:

  1. 從功能表列中,選取檔案 > 匯入。這時會出現「匯入」對話框。
  2. 選取匯入程式碼之下,按一下專案交換
  3. 下一步。這時會出現匯入專案交換內容對話框。
  4. 由於不同的 Rational 產品會使用不同的安裝目標位置,因此,您必須離開產品的使用者介面來尋找包含資料庫內容的外掛程式。 請利用檔案搜尋工具,在本端檔案系統的產品安裝路徑之下,尋找 com.ibm.etools.portal.examples.application_6.0.0.1 外掛程式資料夾。
  5. 請按一下來源 zip 檔旁的瀏覽,導覽至在下列位置的 AuctionPortal.zip
    x:\com.ibm.etools.portal.examples.application_6.0.0.1/samples
    其中 x: 是電腦中包含 com.ibm.etools.portal.examples.application_6.0.0.1 外掛程式的絕對路徑。 按一下開啟
  6. 選取 AuctionEJB50AuctionEJB50Client 勾選框。
  7. 按一下完成

    這時精靈會將專案匯入工作區中。

  8. 您也必須將匯入的專案當作模組新增至 AuctionPortletEAR 專案中。在專案瀏覽器中,展開「企業應用程式 > AuctionPortletEAR」,按兩下部署描述子:AuctionPortletEAR
  9. 選取模組標籤。
  10. 在「模組」之下,按一下新增。選取 AuctionEJB50,按一下完成。 如果變更目標伺服器對話框要求您將模組目標伺服器改成 EAR 目標伺服器,請按一下
  11. 在「專案公用程式 JAR」之下,按一下新增。選取 AuctionEJB50Client,按一下完成。 如果變更目標伺服器對話框要求您將模組目標伺服器改成 EAR 目標伺服器,請按一下
  12. 儲存和關閉部署描述子。

安裝和配置 WebSphere Portal 5.1 版測試環境

雖然可以從產品啟動程式安裝 WebSphere Portal 5.0 版測試環境,這個指導教學的設計目的是要在 WebSphere Portal 5.1 上執行的。您必須按照產品安裝手冊中的說明來安裝 WebSphere Portal 5.1 測試環境。安裝時需要用到 Rational Developer 提供的 WebSphere Portal 媒體。

安裝這個版本的測試環境之後,還必須配置它,才能在工作區中執行。

  1. 從功能表列選取視窗 > 喜好設定
  2. 展開伺服器區,然後按一下已安裝的執行時期
  3. 按一下 WebSphere Portal 5.1 版 Stub,選取勾選框,然後按一下編輯
  4. 將名稱改為 WebSphere Portal 5.1 版,然後利用您在安裝測試環境時指定的 WebSphere Portal 5.1 測試環境安裝目錄,來改寫 WebSphere Portal 位置WebSphere Application Server 位置值。
  5. 按一下完成
  6. 在「喜好設定」對話框中按一下確定

完成這步驟之後,就可以利用 WebSphere Portal 5.1 版測試環境來測試、除錯或側寫。

之後,您必須配置含有這個指導教學中的應用程式所用之資料的資料庫伺服器。

建立和配置含有範例應用程式資料庫的伺服器

在這個練習中,您必須匯入和配置 Cloudscape 資料庫來提供 AuctionPortal 應用程式的資料。

  1. 顯示「伺服器」視圖。它在「內容」和「快速編輯」視圖附近。
  2. 從視圖的蹦現功能表中,選取新建 > 伺服器
  3. 從伺服器類型清單中,選取 WebSphere Portal 5.1 版測試環境
  4. 按一下完成
  5. 在「伺服器」視圖中,按兩下 WebSphere Portal 5.1 版測試環境
  6. 在伺服器編輯器中,選取資料來源標籤。
  7. 伺服器設定區段中,按一下新增,將一份清單新增至 JDBC 提供者清單中。
  8. 在「建立 JDBC 提供者」精靈的第一頁中,選取 Cloudscape 來作為資料庫類型,選取 Cloudscape JDBC Provider 來作為 JDBC 提供者類型
  9. 下一步
  10. 名稱欄位中,輸入 Cloudscape JDBC Provider
  11. 按一下完成
  12. 按一下上面選取的 JDBC 提供者所定義的資料來源清單旁的新增按鈕。
  13. 在「建立資料來源」精靈的第一頁中,選取 Cloudscape JDBC Provider,再按下一步
  14. 名稱欄位中,輸入拍賣
  15. JNDI 名稱欄位中,輸入 jdbc/auction
  16. 下一步
  17. 資源內容清單中,選取 databaseName
  18. 由於不同的 Rational 產品會使用不同的安裝目標位置,因此,您必須離開產品的使用者介面來尋找包含資料庫內容的外掛程式。 請利用檔案搜尋工具,在本端檔案系統的產品安裝路徑之下,尋找 com.ibm.etools.auction.sampledb_6.0.0 外掛程式資料夾。
  19. 回到「建立資料來源」精靈,在欄位中輸入下列路徑:
    x:\com.ibm.etools.auction.sampledb_6.0.0\db\AUCTION60
    其中 x: 是電腦中包含 com.ibm.etools.auction.sampledb_6.0.0 外掛程式的絕對路徑。
  20. 按一下完成
  21. 儲存和關閉伺服器配置檔。

現在,當您在測試模組 1 所開發的 AuctionPortlet 專案中的 Portlet 時,您將能夠存取 AUCTION60 資料庫中的資料。

關於這個指導教學所用的檔案

現在,您可以瀏覽 AuctionEJB50 和 AuctionEJB50Client 專案中的檔案,其中包括 Portlet 頁面的資料來源和邏輯。 在「專案瀏覽器」視圖中,當您展開資料夾時,內容應該看起來如下:
「導覽器」視圖中的 AuctionPortletEJB

這個專案中的資源將用來建立這個指導教學所將建立之 Portlet 的使用者介面,且可用來存取範例 Cloudscape 資料庫中的資料。 UserFacade 和 ListingFacade 都是 EJB Session Bean,將提供指導教學建立的 Portlet 所要呼叫的方法。RegistrationData 和 ItemData 是 Data Access Bean,將在 Portlet 和 Cloudscape 資料庫之間,利用 Entity Bean 來傳送資料。 EJB 專案會提供 Entity Bean 的資料庫對映。

現在您已準備好開始進行練習 1.2:準備開發 Portlet 和定義應用程式流程

使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.