新增資源管理程式 Connection Factory 參照

J2EE 規格提供一種方法,供 J2EE 元件利用稱為資源管理程式 Connection Factory 參照的「邏輯」名稱來參照資源管理程式 Connection Factory。 您可以利用部署描述子編輯器來定義資源管理程式 Connection Factory 參照。

資源管理程式 Connection Factory 是用來建立資源管理程式之連線的物件。比方說,實作 javax.sql.DataSource 介面的物件便是實作資料庫管理系統連線之 java.sql.Connection 物件的資源管理程式 Connection Factory。

在部署時,資源管理程式 Connection Factory 參照會連結於目標作業環境中的實際資源管理程式 Connection Factory。

利用參照來存取的資源管理程式 Connection Factory 物件只在執行查閱的元件實例內有效。

您定義的每個資源管理程式 Connection Factory 參照,在這個應用程式元件的部署描述子中都會新增一個 resourece-ref 元素。這些參照以它們定義在其中的應用程式元件為範圍,因此,在執行時期,其他應用程式元件無法存取它們。 其他元件也可以定義同名的資源管理程式 Connection Factory 參照,不會發生名稱衝突。

如果要定義資源管理程式 Connection Factory 參照,請執行下列動作:

  1. 從 J2EE 模組的部署描述子編輯器中,開啟「新增參照」精靈
  2. 選取資源參照,按下一步
  3. 名稱欄位中,指定參照的名稱,或接受精靈所提供的預設名稱(建議接受)。 部署描述子中的 res-ref-name 項目會使用在名稱欄位中輸入的值。

    參照的名稱是相對於 java:comp/env 環境定義。比方說,名稱應該是 jms/StockHistoryDB,而不是 java:comp/env/jms/StockHistoryDB

  4. 類型欄位中,選取應用程式元件程式碼所預期之資源管理程式 Connection Factory 的 Java™ 程式設計語言類型。 部署描述子中的 res-type 項目會使用在這個欄位中輸入的值。
  5. 鑑別欄位中,指示您的應用程式(如果是 JSP 1.2 Web 專案,則是 Servlet)是否要執行程式化的資源登入,或儲存器是否要管理這項資源的所有鑑別。 部署描述子中的 res-auth 項目會使用這裡指定的值。
  6. 如果是 J2EE 1.3 或更新的專案,請在可共用欄位中,指示利用給定的資源管理程式 Connection Factory 參照來取得的資源管理程式之連線是否能共用。依預設,連線會假設為可共用。 部署描述子中的 res-sharing-scope 項目會使用這裡指定的值。
  7. 說明文字區中,輸入參照的說明。
  8. 按一下完成
相關概念
用戶端部署描述子編輯器
相關工作
定義 J2EE 模組中的參照
新增 EJB 參照
新增訊息目的地參照
新增資源環境參照
新增安全角色參照
新增 Web 服務參照
使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.