在安装期间,使用此页面来选择是否查看所有安装选项以及更改应用程序或模块的现有绑定。可以选择在安装期间为应用程序或模块中任何未完成的绑定生成缺省绑定或者指定特定绑定。
此页面是“准备安装应用程序”的第二个页面。
要查看此管理控制台页面,请单击应用程序 > 创建应用程序 > 新建企业应用程序,指定要安装的应用程序或模块的路径,然后单击下一步。
此控制台页面可能不会显示本主题中列示的所有绑定选项。您要安装的应用程序或模块的内容将确定此控制台页面上所显示的选项。此外,仅当更新已安装的应用程序时才会显示指定要使用的绑定选项。
指定是只显示要求您提供信息的安装选项还是显示所有安装选项。
选项 | 描述 |
---|---|
快速路径 - 仅当需要其他信息时才提示我 | 仅显示根据应用程序或模块的内容而需要您注意的那些选项。使用快速路径使您更容易安装应用程序,这是因为您不需要检查所有可用的安装选项。 |
详细 - 显示所有安装选项和参数 | 显示所有可用的安装选项。 |
指定是在更新应用程序时合并绑定还是使用新绑定或现有绑定。
仅当您更新已安装的应用程序时才会显示此设置,安装新的应用程序时不会显示此设置。
选项 | 描述 |
---|---|
合并新绑定和现有绑定 | 保留已安装的应用程序的现有绑定值,并在已更新的应用程序中为不完整的绑定添加新的绑定值。如果已更新的应用程序的绑定值与为已安装应用程序指定的值不相同,那么就使用合并。该产品按以下顺序指定绑定值:
|
使用新绑定 | 使用已更新的应用程序中的绑定值。不使用已安装的应用程序中的现有绑定值。 |
使用现有绑定 | 使用已安装的应用程序中的现有绑定值。不使用已更新的应用程序中的绑定值。 |
指定是否生成缺省绑定和映射。要查看此设置,请展开选择生成缺省绑定和映射。如果选择生成缺省绑定,那么该产品将使用缺省值来完成应用程序中的任何不完整的绑定。该产品不会更改现有绑定。
选择生成缺省绑定之后,如果任何步骤旁边都不带红色星号(*),那么您可以直接转到“摘要”步骤并安装应用程序。红色星号表示该步骤的数据不完整并且需要提供一个有效值。在“摘要”面板上,验证单元、节点和服务器上是否安装了应用程序。
如果选择生成缺省绑定,那么该产品将按如下所示生成绑定:
缺省策略满足大部分应用程序或者至少满足多数应用程序中的大部分绑定。但是,如果发生了错误,那么请完成下列操作:
在这些情况下,可以使用 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 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>
为特定的企业 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>
从 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>
覆盖被部署为与 JCA 1.5 兼容的资源的消息驱动 bean 的 JNDI 名称
以下示例说明了一个从定制策略文件中抽取的 XML,此文件用于覆盖部署为与 JCA 1.5 兼容的资源的 EJB 2.0 或更高版本的消息驱动 bean 的 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 JNDI 名称开头的字符串。此前缀在单元或节点中必须是唯一的。
缺省情况是不为 Bean 指定唯一前缀。
为 Bean 指定唯一前缀类似于脚本编制选项 -defaultbinding.ejbjndi.prefix。
为容器管理的持久性(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 模块(WAR 文件)或“会话启动协议”(SIP)模块(SAR 文件)的虚拟主机。
缺省情况是不使用 Web 模块或 SIP 模块的缺省虚拟主机名。如果选择了使用 Web 模块和 SIP 模块的缺省虚拟主机名,那么请指定缺省主机名。
使用 Web 模块和 SIP 模块的缺省虚拟主机名类似于脚本编制选项 -defaultbinding.virtual.host。