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

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

Apache Tomcat 允许 Context <ResourceLink> 要在这些位置中定义的元素:

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

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

自动修复将从 ResourceLink 并创建资源引用和相应的 JNDI 名称，如下所示:

• 自动修复程序将搜索 resource-ref 列表，查看是否已存在与名称匹配的条目。 如果不存在，那么创建一个条目。
• 该 ResourceLink 名称属性用于 res-ref-name 在 web.xml 中
• 该 ResourceLink type 属性用于 res-type 在 web.xml 中
• 该 ResourceLink 全局属性用于 binding-name 在 IBM 绑定文件中
• 该 res-auth 设置为 Container
• 该 res-sharing-scope 设置为可共享

请注意，另一个 ResourceLink 属性 (工厂，用户名和密码) 不会自动迁移。 如果您的应用程序在 ResourceLink ，那么您将需要在服务器配置中创建唯一资源，为该资源提供唯一的 JNDI 名称，并更新 具有新 JNDI 名称的 IBM 绑定文件。

如果 Web 项目是 Java EE 5 或更高版本，但 WEB-INF/web.xml 不存在，那么会创建 WEB-INF/web.xml 并添加新的资源链接引用元素。 如果网络项目的 J2EE 1.4 或更低，自动修复程序就会报错。

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

自动修复将更新或创建一个新的 resource-ref 在类似于以下示例的 web.xml 文件中:

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

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

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

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