准备应用程序安装绑定设置

在安装期间,使用此页面来选择是否查看所有安装选项以及更改应用程序或模块的现有绑定。可以选择在安装期间为应用程序或模块中任何未完成的绑定生成缺省绑定或者指定特定绑定。

此页面是“准备安装应用程序”的第二个页面。

要查看此管理控制台页面,请单击应用程序 > 创建应用程序 > 新建企业应用程序,指定要安装的应用程序或模块的路径,然后单击下一步

此控制台页面可能不会显示本主题中列示的所有绑定选项。您要安装的应用程序或模块的内容将确定此控制台页面上所显示的选项。此外,仅当更新已安装的应用程序时才会显示指定要使用的绑定选项。

如何安装应用程序?

指定是只显示要求您提供信息的安装选项还是显示所有安装选项。

表 1. 安装选项描述. 可以选择“快速路径”或选择查看所有安装选项和参数。
选项 描述
快速路径 - 仅当需要其他信息时才提示我 仅显示根据应用程序或模块的内容而需要您注意的那些选项。使用快速路径使您更容易安装应用程序,这是因为您不需要检查所有可用的安装选项。
详细 - 显示所有安装选项和参数 显示所有可用的安装选项。
指定要使用的绑定

指定是在更新应用程序时合并绑定还是使用新绑定或现有绑定。

仅当您更新已安装的应用程序时才会显示此设置,安装新的应用程序时不会显示此设置。

表 2. 绑定选项描述. 可以使用合并的绑定、新的绑定或现有绑定。
选项 描述
合并新绑定和现有绑定 来自更新应用程序或模块的绑定信息优先于来自已安装版本的相应绑定信息。如果在更新版本中任何绑定元素丢失,则使用已安装版本的相应元素。如果已安装的应用程序和已更新的应用程序或模块都没有绑定值,那么请使用缺省值。仅当您选择了生成缺省绑定选项时,该产品才会指定缺省值。
使用新绑定 使用更新应用程序或模块中的绑定信息。来自应用程序或模块的更新版本的绑定信息优先于来自已安装版本的相应绑定信息。将忽略来自应用程序或模块的已安装版本的绑定信息。
使用现有绑定 来自应用程序或模块已安装版本的绑定信息优先于更新版本中的相应信息。如果已安装版本中的任何绑定元素丢失,则使用来自更新版本的相应元素。这就是说,如果已安装版本中存在绑定信息,那么将会忽略来自更新版本的绑定信息。否则,将不会忽略新绑定信息并将使用该绑定信息。
生成缺省绑定

指定是否生成缺省绑定和映射。要查看此设置,请展开选择生成缺省绑定和映射。如果选择生成缺省绑定,那么该产品将使用缺省值来完成应用程序中的任何不完整的绑定。该产品不会更改现有绑定。

选择生成缺省绑定之后,如果任何步骤旁边都不带红色星号 (*),那么您可以直接转到“摘要”步骤并安装应用程序。红色星号表示该步骤的数据不完整并且需要提供一个有效值。在“摘要”面板上,验证单元、节点和服务器上是否安装了应用程序。

转换: 您不需要为 EJB 3.0 模块的 EJB bean、本地 home 接口、远程 home 接口或业务接口指定 Java™ 命名和目录接口(JNDI)值。在运行时期间,该产品将为容器指定缺省值。同样,对于 EJB 3.0、Web 2.4 或 Web 2.5 模块中的任何 EJB 引用都不需要指定 JNDI 值,这是因为该产品在运行时期间将自动解析目标。即使当您选择生成缺省绑定时,该产品也不会为这些 JNDI 值生成缺省值,但是它会为其他绑定(例如,虚拟主机)生成缺省值。

如果选择生成缺省绑定,那么该产品将按如下所示生成绑定:

  • 按照 prefix/ejb-name 格式生成企业 bean (EJB) JNDI 名称。缺省前缀为 ejb,但这是可以重设的。ejb-name 是在部署描述符 <ejb-name> 标记或者在它的 EJB 3.0 模块的相应注释中指定名称。由于运行时会为容器提供缺省值,因此该产品不会为 EJB 3.0 模块中的企业 bean 生成缺省值。
  • 如果找到了 <ejb-link>,那么将绑定 EJB 引用。否则,如果找到唯一具有匹配的 HOME(或本地 HOME)接口的企业 bean 作为被引用的 Bean,就会自动解析该引用。由于运行时会为容器提供缺省值或者自动解析目标引用,因此该产品不会为 EJB 3.0、Web 2.4 或 Web 2.5 模块中的 EJB 引用生成缺省值。
  • 资源引用绑定是从 <res-ref-name> 标记或者它对 Java Platform, Enterprise Edition (Java EE) 5 模块的相应注释派生的。此操作假定 java:comp/env 名称与资源的全局 JNDI 名称相同。
  • EJB 2.0 和 EJB 2.1 JAR 文件的连接工厂绑定是根据所提供的 JNDI 名称和授权信息生成的。此操作将为正在安装的应用程序中的每个 EJB 2.0 和 EJB 2.1 JAR 文件生成缺省连接工厂设置。不生成 bean 级别的连接工厂绑定。
  • EJB 1.1 JAR 文件的数据源绑定是根据 JNDI 名称和数据源用户名密码选项生成的。此操作将为每个 EJB JAR 文件生成缺省数据源设置。没有生成 bean 级别的数据源绑定。
  • 对于作为符合 Java EE 连接器体系结构 (JCA) 1.5 的资源部署的 EJB 2.0 或更高版本消息驱动的 bean,与 activationSpec 实例相对应的 JNDI 名称是按 eis/MDB_ejb-name 格式生成的。如果找到了 <message-destination-link>,而 JNDI 名称设置为 ejs/message-destination-linkName,那么说明绑定了消息目标引用。否则,JNDI 名称将设置为 eis/message-destination-refName
  • 对于针对侦听器端口部署的 EJB 2.0 或更高版本的消息驱动的 bean,从追加字符串 Port 的消息驱动的 bean <ejb-name> 标记派生出这些侦听器端口。
  • 对于 .war 文件,虚拟主机设置为 default_host,除非另有指定。

缺省策略满足大部分应用程序或者至少满足多数应用程序中的大部分绑定。但是,如果发生了错误,那么请完成下列操作:

  • 控制一个或多个 EJB 文件的全局 JNDI 名称。
  • 控制容器管理的持久性 (CMP) bean 的数据源绑定。换句话说,您有多个数据源并且需要多个全局数据源。
  • 将资源引用映射至与 java:comp/env 名称不相同的全局资源 JNDI 名称。

在这些情况下,可以使用 XML 文档(它是一个定制策略)来更改行为。使用特定绑定文件设置来指定定制策略,并且查看此帮助文件中的设置描述以获取示例。

覆盖现有绑定

指定已生成的绑定是否要替换现有绑定。

缺省情况是不覆盖现有绑定。选择覆盖现有绑定以使用已生成的绑定来替换现有绑定。

覆盖现有绑定类似于 -defaultbinding.force 脚本编制选项。

特定绑定文件

指定覆盖缺省绑定的绑定文件。

特定绑定文件类似于 -defaultbinding.strategy.file 脚本编制选项。

使用 XML 文档(它是一个定制策略)来更改缺省绑定的行为。定制策略扩展缺省策略,所以您只需要定制使用缺省策略不够的那些区域。因此,只需要描述您要如何更改缺省策略生成的绑定;而不必定义整个应用程序的绑定。

使用下列示例来覆盖缺省绑定生成器的各个方面:

控制 EJB JNDI 名称

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>helloEjb.jar</jar-name>
      <ejb-bindings>
        <ejb-binding>
         <ejb-name>HelloEjb</ejb-name>
         <jndi-name>com/acme/ejb/HelloHome</jndi-name>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>
切记: 确保 <ejb-name> 的设置与 EJB JAR 部署描述符中的 ejb-name 条目匹配。这里的设置是 <ejb-name>HelloEjb</ejb-name>

设置 EJB JAR 文件的连接工厂绑定

<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>yourEjb20.jar</jar-name>
      <connection-factory>
        <jndi-name>eis/jdbc/YourData_CMP</jndi-name>
        <res-auth>Container</res-auth>          </connection-factory>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>

设置 EJB 文件的连接工厂绑定

<?xml version="1.0">
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>yourEjb20.jar</jar-name>
      <ejb-bindings>
        <ejb-binding>
          <ejb-name>YourCmp20</ejb-name>
          <connection-factory>
           <jndi-name>eis/jdbc/YourData_CMP</jndi-name>
           <res-auth>PerConnFact</res-auth>
          </connection-factory>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
 </module-bindings>
</dfltbndngs>
限制: 确保 <ejb-name> 的设置与部署描述符中的 ejb-name 标记匹配。这里的设置是 <ejb-name>YourCmp20</ejb-name>

为特定的企业 bean 设置消息目标引用 JNDI

此示例说明了一个从用于为特定企业 bean 设置 message-destination-refs 的定制策略文件中抽取的 XML。

<?xml version="1.0">
 <!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
 <dfltbndngs>
  <module-bindings>
   <ejb-jar-binding>
    <jar-name>yourEjb21.jar</jar-name>
    <ejb-bindings>
     <ejb-binding>
      <ejb-name>YourSession21</ejb-name> 
      <message-destination-ref-bindings>
       <message-destination-ref-binding>
        <message-destination-ref-name>jdbc/MyDataSrc</message-destination-ref-name>
        <jndi-name>eis/somAO</jndi-name>
       </message-destination-ref-binding>
      </message-destination-ref-bindings>
     </ejb-binding>
    </ejb-bindings>
   </ejb-jar-binding>
  </module-bindings>
 </dfltbndngs>
限制: 确保 <ejb-name> 的设置与部署描述符中的 ejb-name 标记匹配。这里的设置是 <ejb-name>YourSession21</ejb-name>。也确保 <message-destination-ref-name> 的设置与部署描述符中的 message-destination-ref-name 标记匹配。这里的设置是 <message-destination-ref-name>jdbc/MyDataSrc</message-destination-ref-name>

从 WAR、EJB JAR 文件或 Java EE 客户机 JAR 文件中覆盖资源引用绑定

以下示例显示的是用于覆盖 WAR 文件中的资源引用绑定的代码。使用类似的代码来覆盖企业 bean (EJB) JAR 文件或 Java EE 客户机 JAR 文件中的资源引用绑定。

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <war-binding>
      <jar-name>hello.war</jar-name>
      <resource-ref-bindings>
        <resource-ref-binding>
          <resource-ref-name>jdbc/MyDataSrc</resource-ref-name>
          <jndi-name>war/override/dataSource</jndi-name>
        </resource-ref-binding>
      </resource-ref-bindings>
    </war-binding>
  </module-bindings>
</dfltbndngs>
限制: 确保 <resource-ref-name> 的设置与部署描述符中的 resource-ref 标记匹配。在前一个示例中,设置是 <resource-ref-name>jdbc/MyDataSrc</resource-ref-name>

覆盖被部署为与 JCA 1.5 兼容的资源的消息驱动 bean 的 JNDI 名称

以下示例说明了一个从定制策略文件中抽取的 XML,此文件用于覆盖部署为与 JCA 1.5 兼容的资源的 EJB 2.0 或更高版本的消息驱动 bean 的 Java 消息服务 (JMS) activationSpec JNDI 名称。

<?xml version="1.0"?>
 <!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
  <dfltbndngs>
  <module-bindings>
   <ejb-jar-binding>
     <jar-name>YourEjbJar.jar</jar-name>
     <ejb-bindings>
      <ejb-binding>
        <ejb-name>YourMDB</ejb-name>
        <activationspec-jndi-name>activationSpecJNDI</activationspec-jndi-name>
      </ejb-binding>
     </ejb-bindings>
   </ejb-jar-binding>
  </module-bindings>
 </dfltbndngs>

覆盖 EJB 2.0、2.1 或 3.0 消息驱动的 bean 的 JMS 侦听器端口名

以下示例说明了一个从定制策略文件中抽取的 XML,此文件用于覆盖根据侦听器端口部署的 EJB 2.0 或更高版本的消息驱动 bean 的 JMS 侦听器端口名。

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>YourEjbJar.jar</jar-name>
      <ejb-bindings>
        <ejb-binding>
          <ejb-name>YourMDB</ejb-name>
          <listener-port>yourMdbListPort</listener-port>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>

覆盖 EJB JAR、WAR 文件或 EJB 文件中的 EJB 引用绑定

以下示例说明用于覆盖 EJB JAR 文件中的 EJB 引用绑定的代码。使用类似的代码从 WAR 文件或 EJB 文件覆盖 EJB 引用绑定。

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>YourEjbJar.jar</jar-name>
      <ejb-ref-bindings>
        <ejb-ref-binding>
          <ejb-ref-name>YourEjb</ejb-ref-name>
          <jndi-name>YourEjb/JNDI</jndi-name>
        </ejb-ref-binding>
      </ejb-ref-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>
为 bean 指定唯一的前缀

指定该产品应用于已生成的企业 bean JNDI 名称开头的字符串。此前缀在单元或节点中必须是唯一的。

缺省情况是不为 Bean 指定唯一前缀。

为 Bean 指定唯一前缀类似于脚本编制选项 -defaultbinding.ejbjndi.prefix

EJB 1.1 CMP bean 的缺省绑定

为容器管理的持久性 (CMP) 1.1 Bean 指定缺省数据源 JNDI 名称和其他绑定。

缺省情况是不使用 EJB 1.1 CMP bean 的缺省绑定。

如果选中了 EJB 1.1 CMP bean 的缺省绑定,那么指定要与 CMP 1.1 Bean 配合使用的缺省数据源的 JNDI 名称。并且,还需要指定此缺省数据源的用户名和密码。

EJB 1.1 CMP bean 的缺省绑定类似于脚本编制选项 -defaultbinding.datasource.jndi

缺省连接工厂绑定

指定缺省连接工厂 JNDI 名称。

缺省情况是不使用缺省连接工厂绑定。选择缺省连接工厂绑定以对连接工厂指定绑定。

如果选择了缺省连接工厂绑定,那么指定要使用的缺省连接工厂的 JNDI 名称。还要指定是否将资源授权用于应用程序或者整个容器。

缺省连接工厂绑定类似于脚本编制选项 -defaultbinding.cf.jndi

使用 Web 模块和 SIP 模块的缺省虚拟主机名

指定 Web 模块(WAR 文件)或“会话启动协议”(SIP) 模块(SAR 文件)的虚拟主机。

缺省情况是不使用 Web 模块或 SIP 模块的缺省虚拟主机名。如果选择了使用 Web 模块和 SIP 模块的缺省虚拟主机名,那么请指定缺省主机名。

使用 Web 模块和 SIP 模块的缺省虚拟主机名类似于脚本编制选项 -defaultbinding.virtual.host




标有(在线)的链接要求访问因特网。

相关概念
相关任务
相关信息
准备应用程序安装设置


文件名: urun_rapp_instw_gendefbind.html