蓝图资源引用 [设置]

蓝图组件可以访问 WebSphere® Application Server 资源引用。每个引用都在蓝图 XML 文件中声明，并且可以使用 Java™ Platform, Enterprise Edition (Java EE) 连接器体系结构 (JCA) 认证别名进行保护。 OSGi 应用程序中的每个捆绑软件可以在其各个蓝图 XML 文件中包含任意数量的资源引用声明。

要在管理控制台中查看此面板，请单击以下某个路径：

应用程序 > 应用程序类型 > 业务级别应用程序 > application_name > [部署的资产] 添加 > 添加资产 > asset_name > 向导步骤：绑定蓝图资源引用
应用程序 > 应用程序类型 > 业务级别应用程序 > application_name > composition_unit_name > [其他属性] 蓝图资源引用

仅当捆绑软件包含蓝图资源引用声明时，才会显示绑定蓝图资源引用向导步骤和蓝图资源引用属性。

在保护资源引用时，只能将那些资源引用绑定到部署了应用程序的每个服务器或集群上存在的 JCA 认证别名。OSGi 应用程序可部署到位于同一安全域的多个服务器和集群。因此，每个 JCA 认证别名必须在目标服务器和集群的安全域或全局安全域中存在。

必须在蓝图 XML 文件中声明资源引用。例如：

<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0" 
  xmlns:rr="http://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>

此声明包括资源引用标识（例如，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>

常规属性

组合捆绑软件标识

仅当 EBA 资产使用组合捆绑软件时，才会显示该标识。每个组合捆绑软件由以下格式的字符串进行标识：Composite bundle archive (CBA)'composite.bundle.symbolic.name_composite.bundle.version'。作为组合捆绑软件一部分的捆绑软件列示在组合捆绑软件标识下。

组合捆绑软件符号名称: 此组合捆绑软件的非本地化名称。
组合捆绑软件版本: 此组合捆绑软件的版本。

符号名称和版本一起唯一地标识组合捆绑软件。

捆绑软件标识

每个捆绑软件由包含捆绑软件符号名称和捆绑软件版本的字符串进行标识。作为组合捆绑软件一部分的捆绑软件列示在组合捆绑软件标识下。

捆绑软件符号名称

此捆绑软件的非本地化名称。

捆绑软件版本

此捆绑软件的版本。

捆绑软件符号名称和捆绑软件版本一起唯一地标识捆绑软件。

资源引用标识

在蓝图中声明的资源引用的标识。

资源引用接口

此资源引用的接口。

您的蓝图应用程序可使用以下任何资源类型：

缺省消息传递 JMS 队列目标
缺省消息传递 JMS 主题目标
数据源
通用 JMS 连接工厂
邮件会话
J2C 连接工厂
WebSphere MQ 的 JMS 提供程序的 JMS 队列连接工厂
WebSphere MQ 的 JMS 队列目标
WebSphere MQ 的 JMS 主题连接工厂
WebSphere MQ 的 JMS 主题目标
WebSphere MQ 的统一 JMS 连接工厂
URL 配置

资源引用服务过滤器

作为资源引用的映射目标的服务过滤器的名称。例如，jdbc/AccountDS2。

资源引用认证

资源引用由应用程序或容器进行认证。

资源引用共享

资源引用是可共享或不可共享的。

认证别名

用于保护资源引用的认证别名（如果存在）。

对于每个引用，您可以从列表中选择认证别名。缺省认证别名（来自 ibm-eba-bnd.xml 文件）仅当在每个目标服务器或集群上存在时才会提供。

标有（在线）的链接需要访问因特网。每个链接都将在在线信息中心内搜索主题。列示搜索结果后，请选择最适合于您的配置的主题。

检查此主题的更新 (在线)

文件名： OSGi_BLA_BlueprintResourceRefs.html