藍圖資源參照 [設定]

藍圖元件可以存取 WebSphere® Application Server 資源參照。 每一個參照都宣告在 Blueprint XML 檔中，且可以使用 Java™ Platform, Enterprise Edition (Java EE) 連接器架構 (JCA) 鑑別別名來保護其安全。 OSGi 應用程式中的每一個軟體組都可以在其各種藍圖 XML 檔中包含任意數目的資源參照宣告。

如果要在管理主控台中檢視這個畫面，請按下列其中一個路徑：
  • 應用程式 > 應用程式類型 > 商業層次應用程式 > application_name > [已部署資產] 新增 > 新增資產 > asset_name > 精靈步驟: 連結藍圖資源參照
  • 應用程式 > 應用程式類型 > 商業層次應用程式 > application_name > composition_unit_name > [其他內容] 藍圖資源參照

「 連結藍圖資源參照 」精靈步驟及 藍圖資源參照 內容只有在軟體組包含藍圖資源參照宣告時才可見。

當您維護資源參照的安全時，那些資源參照只能連結至部署應用程式的每一部伺服器或叢集上所存在的 JCA 鑑別別名。 OSGi 應用程式可以部署至相同安全網域中的多個伺服器和叢集。 因此，每一個 JCA 鑑別別名都必須存在於目標伺服器和叢集的安全網域或廣域安全網域中。

您必須在 Blueprint XML 檔中宣告資源參照。 例如：
<blueprint xmlns="https://www.osgi.org/xmlns/blueprint/v1.0.0" 
  xmlns:rr="https://www.ibm.com/appserver/schemas/8.0/blueprint/resourcereference">
  <!-- Other Blueprint declarations ... -->
  
  <rr:resource-reference id="resourceRef" 
          interface="javax.sql.DataSource"
          filter="(osgi.jndi.service.name=jdbc/Account)">
    <rr:res-auth>Container</rr:res-auth>
    <rr:res-sharing-scope>Shareable</rr:res-sharing-scope>
  </rr:resource-reference>
</blueprint>
此宣告包括資源參照 ID (例如 resourceRef)、服務過濾器 (例如 jdbc/Account)、鑑別類型 (例如 Container) 及共用設定 (例如 Shareable)。
每一個軟體組的鑑別別名連結的藍圖資源參照會儲存在該軟體組的 META-INF 目錄中的 ibm-eba-bnd.xml 檔案。 當 OSGi 應用程式部署成資產時，如果它包含任何這些檔案，這些檔案會提供連結資源參照時所用的預設鑑別別名值。 例如：
<eba-bnd>
  <resource-ref>
    <jndi-name>jdbc/Acount</jndi-name>
    <authentication-alias>Alias1</authentication-alias>
    <interface>javax.sql.DataSource</interface>
    <authentication>Container</authentication>
    <sharing-scope>Shareable</sharing-scope>
    <id>resourceRef</id>
  </resource-ref>
</eba-bnd>

一般內容

複合軟體組 ID
只有在 EBA 資產使用複合軟體組時，才會顯示此 ID。 每一個複合軟體組都由下列格式的字串所識別: Composite bundle archive (CBA)'composite.bundle.symbolic.name_composite.bundle.version'。 複合軟體組 ID 下方會列出屬於複合軟體組的軟體組。
複合軟體組符號名稱
這個複合軟體組的非可本地化名稱。
複合軟體組版本
此複合軟體組的版本。

符號名稱與版本一起唯一識別複合軟體組。

軟體組 ID
每一個組合都由包含組合符號名稱及組合版本的字串所識別。 複合軟體組 ID 下方會列出屬於複合軟體組的軟體組。
組合符號名稱
此組合的不可本地化名稱。
軟體組版本
此組合的版本。

組合符號名稱與組合版本可唯一識別組合。

資源參照 ID
在藍圖中宣告的資源參照 ID。
資源參照介面
此資源參照的介面。
您的藍圖應用程式可以使用下列任何資源類型:
  • 預設傳訊 JMS 佇列目的地
  • 預設傳訊 JMS 主題目的地
  • 資料來源
  • 通用 JMS Connection Factory
  • 郵件階段作業
  • J2C Connection Factory
  • WebSphere MQ之 JMS 提供者的 JMS Queue Connection Factory
  • WebSphere MQ
  • WebSphere MQ
  • WebSphere MQ
  • WebSphere MQ
  • URL 配置
資源參照服務過濾器
作為資源參照對映目標的服務過濾器名稱。 例如， jdbc/AccountDS2。
資源參照鑑別
資源參照由應用程式或儲存器進行鑑別。
資源參照共用
資源參照是可共用或不可共用。
鑑別別名
用於保護資源參照安全的鑑別別名 (如果有的話)。

對於每一個參照，您可以選擇性地從清單中選取鑑別別名。 只有在每個目標伺服器或叢集上都存在預設鑑別別名時，才會提供預設鑑別別名 (來自 ibm-eba-bnd.xml 檔案)。