Blueprint 資源參照 [設定]

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

如果要在管理主控台中檢視這個畫面，請按下列其中一個路徑：

應用程式 > 應用程式類型 > 商業層次應用程式 > application_name > [已部署的資產] 新增 > 新增資產 > asset_name > 精靈步驟：連結 Blueprint 資源參照
應用程式 > 應用程式類型 > 商業層次應用程式 > application_name > composition_unit_name > [其他內容] Blueprint 資源參照

只有當軟體組包含 Blueprint 資源參照宣告時，才會顯示連結 Blueprint 資源參照精靈步驟和 Blueprint 資源參照內容。

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

您必須將資源參照宣告在 Blueprint XML 檔中。例如：

<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0"
  xmlns:rr="http://www.ibm.com/appserver/schemas/8.0/blueprint/resourcereference">
  <!-- 其他 Blueprint 宣告 ... -->
  
  <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）。

每個軟體組中對鑑別別名連結的 Blueprint 資源參照，都儲存在軟體組之 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

Blueprint 中宣告之資源參照的 ID。

資源參照介面

這個資源參照的介面。

Blueprint 應用程式可以使用下列任一種資源類型：

預設傳訊 JMS 佇列目的地
預設傳訊 JMS 主題目的地
資料來源
通用 JMS Connection Factory
郵件階段作業
J2C Connection Factory
WebSphere MQ JMS 提供者的 JMS 佇列 Connection Factory
WebSphere MQ 的 JMS 佇列目的地
WebSphere MQ 的 JMS 主題 Connection Factory
WebSphere MQ 的 JMS 主題目的地
WebSphere MQ 的統一 JMS Connection Factory
URL 配置

資源參照服務過濾器

作為資源參照之對映目標的服務過濾器名稱。例如：jdbc/AccountDS2。

資源參照鑑別

資源參照會由應用程式或是由儲存器鑑別。

資源參照共用

資源參照可為可共用或不可共用。

鑑別別名

用於保護資源參照的鑑別別名（如果有的話）。

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

標示（線上）的鏈結表示需要存取網際網路。每個鏈結會啟動線上資訊中心的主題搜尋。當列出搜尋結果時，請選取最適合您配置的相對應主題。

檢查這個主題是否有更新 (線上)

檔名： OSGi_BLA_BlueprintResourceRefs.html