使用 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 name 屬性用於 res-ref-name 於 web.xml
該 ResourceLink type 屬性用於 res-type 於 web.xml
該 ResourceLink 全局屬性用於 binding-name IBM 綁定檔案中
該 res-auth 設定為 Container
該 res-sharing-scope 設定為可分享

請注意，其他 ResourceLink 屬性 (工廠、使用者名稱和密碼) 不會自動轉移。如果您的應用程式在 a 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 檔案中，類似於這個範例：

<resource-ref id="ResourceRef_1313785392722">
<res-ref-name>jdbc/SampleWeb</res-ref-name>
<res-type>javax.sql.DataSource</res-type>
<res-auth>貨櫃</res-auth>
<res-sharing-scope>可分享</res-sharing-scope>
</resource-ref>

會將 JNDI 名稱新增至 IBM 連結檔。它會參照定義於 web.xml 中的現有參照。如果連結檔尚未存在，則會建立它。

您也必須在 WebSphere Application Server 配置中配置資源。

如需 Tomcat 中之環境定義資源定義的相關資訊，請參閱：

Apache Tomcat 設定參考 - 資源連結。