使用 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 屬性 (Factory、使用者名稱和密碼) 不會自動移轉。 如果您的應用程式在中使用這些屬性 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 配置參照 - 資源鏈結。