J2C Connection Factory 設定

請利用這個頁面來指定 Connection Factory 的設定。

您可以利用兩種方式之一來存取這個管理主控台頁面:

範圍

指定利用這個 Connection Factory 將應用程式連接到企業資訊系統 (EIS) 之資源配接器的範圍。只有安裝在這個範圍內的應用程式能夠使用這個 Connection Factory。

提供者

指定 WebSphere® Application Server 用在這個 Connection Factory 的資源配接器。

只有在建立了新的 Connection Factory 時,才能設定提供者。 這份清單會顯示相關範圍所定義的所有現有資源配接器。如果您要利用現有的資源配接器作為提供者,請從清單中選取一個。

建立新的提供者

提供配置新資源配接器給新 Connection Factory 的選項。

只有在建立(而不是編輯)Connection Factory 時,才會顯示建立新的提供者。

按一下建立新的提供者會觸發主控台來顯示資源配接器配置頁面,供您建立新的配接器。按一下確定來儲存您的設定之後,您會見到 Connection Factory 集合頁面。按一下新建會定義用來搭配新資源配接器的新 Connection Factory;這時主控台會顯示一個配置頁面,將這個資源配接器列為新的 Connection Factory 提供者。

名稱

指定這個 Connection Factory 的名稱。

這是必要的內容。

參考資訊 值
資料類型 String

JNDI 名稱

請指定這個 Connection Factory 的 JNDI 名稱。

例如,名稱可能是 eis/myECIConnection。

設定這個值之後,請儲存它,再重新啟動伺服器。 當您執行 dumpNameSpace 工具時,您可以看到這個字串。 這是必要的內容。 如果您沒有指定 JNDI 名稱,依預設,會用「名稱」欄位來填入。

參考資訊 值
資料類型 String
預設值 eis/display name
重要: 遵循 JNDI 名稱的下列需求:
  • 不跨越不同的資源類型(如資料來源與 J2C Connection Factory 或 JMS Connection Factory)來指派重複的 JNDI 名稱。
  • 不在相同範圍中,指派重複的 JNDI 名稱給相同類型的多項資源。

說明

請指定這個 Connection Factory 的文字說明。

參考資訊 值
資料類型 String

Connection Factory 介面

請指定資源配接器所支援的 Connection Factory 介面的完整名稱。

這是必要的內容。 針對新的物件,資源配接器會在下拉清單提供可用類別清單。 建立好 Connection Factory 之後,欄位是個唯讀的文字欄位。

參考資訊 值
資料類型 下拉清單或文字

種類

請指定可用來將這個 Connection Factory 分類或分組的字串。

參考資訊 值
資料類型 String

XA 回復的鑑別別名

指定 XA 回復處理期間所用的鑑別別名。 如果在伺服器失敗之後,這個別名有所變更,後續的 XA 回復處理會使用失敗之前的有效原始設定。

從清單中選取一個別名。

如果要定義不在清單中的新別名,請執行下列動作:
  1. 按一下套用。這時在「相關項目」之下,會出現一份 Java Platform Enterprise Edition (Java EE) 連接器架構 (J2C) 鑑別資料項目清單。
  2. 按一下 JAAS - J2C 鑑別資料。
  3. 按一下新建。
  4. 定義別名。
  5. 按一下確定,再按一下儲存。 這時主控台會顯示一個別名集合頁面,列出所有已配置的別名。 在表格上方,這個頁面也會在瀏覽途徑中顯示您的 Connection Factory 名稱。
  6. 按一下您的 J2C Connection Factory 的名稱,回到正在建立的 Connection Factory 的配置頁面。
  7. 在儲存器管理鑑別別名清單中,選取一個新別名。
  8. 按一下套用。

如果資源配接器不支援 XA 交易,就不會顯示這個欄位。 預設值來自所選的應用程式鑑別別名(如果指定的話)。

如果您已在應用程式伺服器中定義多個安全網域及多個鑑別別名,您可以按一下瀏覽... 來選取正在配置之資源的鑑別別名。 安全網域可讓您將不同伺服器的鑑別別名隔開。 在判斷別名所屬的安全網域時,樹狀結構視圖很有用,可以協助您判斷能夠存取每一個鑑別別名的伺服器。 樹狀結構視圖會針對每項資源進行調整,因此,當無法使用時,網域和別名會隱藏起來。

只有在定義了至少一個安全網域,且指派了正在編輯的資源所適用的範圍給這個安全網域時,才能夠存取「瀏覽」按鈕。另外,這個安全網域必須包含至少一個 JAAS J2C 鑑別別名。

參考資訊 值
資料類型 下拉清單

元件管理的鑑別別名

請指定資源的元件管理登入之鑑別資料。

從清單中選取一個別名。

如果要定義不在清單中的新別名,請執行下列動作:
  1. 按一下套用。這時在「相關項目」之下,會出現一份 Java Platform Enterprise Edition (Java EE) 連接器架構 (J2C) 鑑別資料項目清單。
  2. 按一下 JAAS - J2C 鑑別資料。
  3. 按一下新建。
  4. 定義別名。
  5. 按一下確定,再按一下儲存。 這時主控台會顯示一個別名集合頁面,列出所有已配置的別名。 在表格上方,這個頁面也會在瀏覽途徑中顯示您的 Connection Factory 名稱。
  6. 按一下您的 J2C Connection Factory 的名稱,回到正在建立的 Connection Factory 的配置頁面。
  7. 在儲存器管理鑑別別名清單中,選取一個新別名。
  8. 按一下套用。

如果您已在應用程式伺服器中定義多個安全網域及多個鑑別別名,您可以按一下瀏覽... 來選取正在配置之資源的鑑別別名。 安全網域可讓您將不同伺服器的鑑別別名隔開。 在判斷別名所屬的安全網域時,樹狀結構視圖很有用,可以協助您判斷能夠存取每一個鑑別別名的伺服器。 樹狀結構視圖會針對每項資源進行調整,因此,當無法使用時,網域和別名會隱藏起來。

只有在定義了至少一個安全網域,且指派了正在編輯的資源所適用的範圍給這個安全網域時,才能夠存取「瀏覽」按鈕。另外,這個安全網域必須包含至少一個 JAAS J2C 鑑別別名。

參考資訊 值
資料類型 清單

您配置給元件管理鑑別的別名,並不適用於必須存取安全資源的所有用戶端。 外部 Java 用戶端(具備 Java 命名和目錄介面 (JNDI) 存取權)可以查閱 Java 2 Connector (J2C) 資源,例如資料來源或 Java 訊息服務 (JMS) 佇列。 不過,它們不能使用資源上所定義的元件管理鑑別別名。 當 getConnection() 方法未指定任何鑑別資料時,例如使用者和密碼或 ConnectionSpec 值,所用的預設值便是這個別名。 如果外部用戶端需要連線,它必須透過 getConnection() 呼叫的引數來傳遞別名,來承擔鑑別責任。

不過,如果 Servlet 或 Enterprise Bean 之類的用戶端在應用程式伺服器之相同 Cell 內的程序中執行,且用戶端能夠查閱 JNDI 名稱空間中的資源,這些用戶端便能夠取得連線,且不需要在 getConnection() 呼叫上明確提供鑑別資料。 在這種情況下,如果元件的 res-auth 設定是應用程式,會從 Connection Factory 所定義的元件管理鑑別別名來進行鑑別。 當 res-auth 設為儲存器時,會從元件資源參照上所定義的登入配置來進行鑑別。 如果元件的資源參照並未定義登入配置,就會從 Connection Factory 所定義的儲存器管理鑑別別名來進行鑑別。
避免困難 避免困難: J2C 鑑別別名適用於個別 Cell。 一部應用程式伺服器中的 Enterprise Bean 或 Servlet 無法查閱在不同 Cell 的另一個伺服器程序中的資源,因為無法解析別名。gotcha

對映配置別名

指定這個 Connection Factory 所用之「Java 鑑別和授權服務 (JAAS)」對映配置的鑑別別名。

DefaultPrincipalMapping JAAS 配置會將鑑別別名對映至使用者 ID 和密碼。您可以定義和使用其他對映配置。
避免困難 避免困難: 部分對映配置別名不使用儲存器管理的鑑別別名,因此,如果選取了這些對映配置別名之一,您便無法選取儲存器管理的鑑別別名。gotcha
參考資訊 值
資料類型 挑選清單

儲存器管理鑑別別名

指定用於資源的儲存器管理登入的鑑別資料,也就是 JAAS - J2C 鑑別資料項目。這個設定可以停用,這會隨著所選的「對映配置別名」設定值而不同。

從清單中選取一個別名。

如果要定義不在清單中的新別名,請執行下列動作:
  1. 按一下套用。這時在「相關項目」之下,會出現一份 Java Platform Enterprise Edition (Java EE) 連接器架構 (J2C) 鑑別資料項目清單。
  2. 按一下 JAAS - J2C 鑑別資料。
  3. 按一下新建。
  4. 定義別名。
  5. 按一下確定,再按一下儲存。 這時主控台會顯示一個別名集合頁面,列出所有已配置的別名。 在表格上方,這個頁面也會在瀏覽途徑中顯示您的 Connection Factory 名稱。
  6. 按一下您的 J2C Connection Factory 的名稱,回到正在建立的 Connection Factory 的配置頁面。
  7. 在儲存器管理鑑別別名清單中,選取一個新別名。
  8. 按一下套用。

如果您已在應用程式伺服器中定義多個安全網域及多個鑑別別名,您可以按一下瀏覽... 來選取正在配置之資源的鑑別別名。 安全網域可讓您將不同伺服器的鑑別別名隔開。 在判斷別名所屬的安全網域時,樹狀結構視圖很有用,可以協助您判斷能夠存取每一個鑑別別名的伺服器。樹狀結構視圖會針對每項資源進行調整,因此,當無法使用時,網域和別名會隱藏起來。

只有在定義了至少一個安全網域,且指派了正在編輯的資源所適用的範圍給這個安全網域時,才能夠存取「瀏覽」按鈕。 另外,這個安全網域必須包含至少一個 JAAS J2C 鑑別別名。

參考資訊 值
資料類型 挑選清單

鑑別喜好設定

請指定定義給這個 Connection Factory 的鑑別機制。

這項設定指定在定義給對應資源配接器的鑑別機制中,哪一個適用於這個 Connection Factory。 根據資源配接器功能而定,共用的值有 KERBEROS、BASIC_PASSWORD 和 none。

如果選取 none,就應該由應用程式元件來管理鑑別 (<res-auth>Application</res-auth>)。 在這個情況下,使用者 ID 和密碼的來源如下:
  • 元件管理的鑑別別名
  • 使用者名稱、密碼自訂內容
  • getConnection 方法所傳遞的字串
比方說,如果在 ra.xml 文件中,已將兩個鑑別機制項目定義給資源配接器:
  • <authentication-mechanism-type>BasicPassword</authentication-mechanism-type>
  • <authentication-mechanism-type>Kerbv5</authentication-mechanism-type>
鑑別喜好設定指定儲存器管理鑑別所用的機制。 如果選取資源配接器所不支援的機制,在伺服器啟動期間,會發出異常狀況。
參考資訊 值
資料類型 挑選清單
預設值 BASIC_PASSWORD


檔名: udat_j2cconnfacdet.html