使用 Java EE 部署描述符和 WebSphere 绑定来定义资源链接引用

此规则会标记 META-INF/context.xml 文件中找到的可能需要迁移的 Context <ResourceLink> 元素。

Apache Tomcat 允许在下列位置中定义 Context <ResourceLink> 元素：

• META-INF/context.xml 文件
• Tomcat conf 目录中的应用程序 XML 配置文件
• conf/server.xml 中的 <Host> 元素

因为迁移工具可能无法访问 Tomcat 配置目录，所以迁移工具仅迁移 META-INF/context.xml 文件。 其他位置中定义的 ResourceLink 信息必须复制到 META-INF/context.xml 文件，才能进行处理。

源扫描程序中提供了快速修订。 该快速修订会从 ResourceLink 元素获取信息，并创建资源引用和相应的 JNDI 名称，如下所示：

• 该快速修订会搜索 resource-ref 的列表，以查看与该名称匹配的条目是否已存在。 如果不存在，那么创建一个条目。
• ResourceLink 名称属性用于 web.xml 中的 res-ref-name
• ResourceLink 类型属性用于 web.xml 中的 res-type
• ResourceLink 全局属性用于 IBM 绑定文件中的 binding-name
• res-auth 设为 Container
• res-sharing-scope 设为 Shareable

请注意，不会自动迁移其他 ResourceLink 属性（工厂、用户名和密码）。 如果应用程序在 ResourceLink 中使用这些属性，那么您将需要在服务器配置中创建唯一资源，向资源提供唯一 JNDI 名称，然后使用新的 JNDI 名称来更新 IBM 绑定文件。

如果 Web 项目是 Java EE 5 或更高版本，但 WEB-INF/web.xml 不存在，那么会创建 WEB-INF/web.xml 并添加新的资源链接引用元素。 如果 Web 项目是 J2EE 1.4 或更低版本，那么该快速修订将报告错误。

例如，给定包含以下 ResourceLink 的 META-INF/Context.xml：

<ResourceLink global="jdbc/SampleWebGlobal" name="jdbc/SampleWeb" type="javax.sql.DataSource"/>

该快速修订将更新 web.xml 文件中的 resource-ref 或者创建新的 resource-ref，类似于以下示例：

<resource-ref id="ResourceRef_1313785392722"> <res-ref-name>jdbc/SampleWeb</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> <res-sharing-scope>Shareable</res-sharing-scope> </resource-ref>

会将 JNDI 名称添加至 IBM 绑定文件。 它引用在 web.xml 中定义的现有引用。 如果该绑定文件尚不存在，那么会创建该绑定文件。

您也将需要在 WebSphere Application Server 配置中配置该资源。

有关 Tomcat 中上下文资源定义的更多信息，请参阅：

• Apache Tomcat 配置参考 - 资源链接。