資源參照支援應用程式在執行時期環境中,使用邏輯名稱而非實際名稱來存取資源(例如資料來源、URL 或郵件提供者)。
此功能可讓您在變更資源執行時期配置時,不需要變更應用程式碼。
開始之前
本主題引導您更新先前已組合的企業應用程式的資源參照。「組合應用程式」主題詳細說明組合程序。
關於這項作業
資源參照由應用程式提供者在部署描述子中宣告。在應用程式部署程序中,您有時必須在執行時期環境中將資源參照連結到資源的實際名稱。
當您在應用程式伺服器中建立 Connection Factory 或資料來源時,應用程式伺服器會提供 JNDI 名稱,供元件用來存取該 Connection Factory 或資料來源。
應用程式伺服器使用字首為 java:comp/env 的間接名稱。例如:
- 建立資料來源時,預設 JNDI 名稱設為 jdbc/data_source_name。
- 建立 Connection Factory 時,預設名稱為 eis/j2c_connection_factory_name。
如果您指定自己的值來置換這些值,請保留 java:comp/env 字首。
間接 JNDI 名稱可讓連線管理基礎架構從應用程式相關聯的資源參照存取任何資料。
這可讓您根據鑑別、隔離層次、共用範圍及解析控制的設定,更妥善管理資源。
本主題說明如何使用組合工具來更新企業應用程式的資源參照。定義資源參照之後,您可以使用 java:comp/env 環境定義執行間接 JNDI 查閱。
程序
- 啟動組合工具。
- 配置組合工具來準備處理 Java Platform Enterprise Edition (Java EE) 模組(如果尚未這樣做)。
- 將您要變更的企業應用程式(EAR 檔)匯入到 EJB 專案。
- 顯示模組類型的資源參照:
- 如果 Enterprise Bean 使用資源參照:
- 展開 EAR 檔的名稱。
- 展開 EJB 模組。
- 展開需要的 EJB 模組。
- 展開適當的 Enterprise Bean 類型(Session Bean 或 Entity Bean)的區段。
- 展開 Enterprise Bean。
- 如果 Servlet 使用資源參照:
- 展開 EAR 檔的名稱。
- 展開 Web 模組。
- 展開需要的 Web 模組。
- 如果應用程式用戶端使用資源參照:
- 展開 EAR 檔的名稱。
- 展開應用程式用戶端。
- 展開需要的應用程式用戶端模組。
- 用滑鼠右鍵按一下您要變更資源參照的模組,然後按一下開啟工具 > 部署描述子編輯器。
- 若為 Servlet 和應用程式用戶端,請按一下新增。若為 EJB 模組,請選取特定 Bean,然後按一下新增。
- 選取資源參照選項,然後按下一步。
- 指定資源參照的設定,然後按一下完成。
- 選擇性的: 選取參照標籤,在 WebSphere 延伸下,選取隔離層次。 如果選擇略過此步驟,隔離層次會預設為 TRANSACTION_NONE。
- 選擇性的: 在 WebSphere 連結下,指定 JNDI 名稱。 如果選擇略過此步驟,您可以在部署應用程式時設定(或置換)連結。
- 關閉部署描述子編輯器並儲存變更。
結果
「專案瀏覽器」視圖中會顯示已更新的模組的檔案。
下一步
在「專案瀏覽器」視圖中驗證已更新的企業應用程式的內容。然後,部署企業應用程式。
只要一個步驟,就能產生 EJB 部署程式碼,同時又將 EJB 模組部署到目標伺服器。
在「專案瀏覽器」視圖中,用滑鼠右鍵按一下 EJB 專案,然後按一下部署。另請參閱「部署 EJB 模組」主題。