使用 Java EE 部署描述子和 WebSphere 連結來定義資源參照

此規則會標示 Context <Resource> META-INF/context.xml 檔中找到可能需要移轉的元素。

Apache Tomcat 容許 Context <Resource> 要在下列位置中定義的元素:

由於移轉工具可能沒有 Tomcat 配置目錄的存取權,移轉工具只會移轉 META-INF/context.xml 檔。 定義在其他位置中的 Resource 資訊可以複製到 META-INF/context.xml 檔,以便處理它。

自動修復會從 從 Resource 元素,並視需要建立資源參照或資源環境參照,以及對應的 JNDI 名稱。 Tomcat 建議 (但不需要) 下列項目的對應資源參照: Resource 元素定義在 WEB-INF/web.xml. 自動修復會搜尋 resource-ref resource-env-ref 元素,以查看符合名稱的項目是否已存在。 若無,則會建立一個。 如果 Resource 元素具有 auth 屬性, a resource-ref 已建立。 如果 Resource 元素沒有 auth 屬性, a resource-env-ref 已建立。 在這兩種情況下, name 值也會作為 JNDI 名稱,並定義在連結中。

例如,假設下列 Resource META-INF/context.xml 檔中的元素:
<Resource name="jdbc/exampleDB"
auth="Container"
type="javax.sql.DataSource"
description="Example Database " />


自動修正將建立此相對應的 <resource-ref> 元素:
<resource-ref>
<description>
資料庫範例</description>
<res-ref-name>jdbc/exampleDB</res-ref-name>
<res-type>javax.sql.DataSource</res-type>
<res-auth>儲存器</res-auth>
<res-sharing-scope>可共用</res-sharing-scope>
</resource-ref>

依預設,資源在 Tomcat 中可以共用。 如果未在上設定範圍, Resource 元素、 元素時,會將其設定為可共用。 自動修復時,它會被設定為可共享。 如果 WEB-INF/web.xml 已存在相符的資源參照,則不會進行任何變更。

如果 Web 專案是 Java EE 5 或更新的版本,且 WEB-INF/web.xml 不存在,則會建立 WEB-INF/web.xml,並新增資源參照元素。 如果網頁專案的網址是 J2EE 1.4 或更低,自動修正功能會報錯。

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

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