使用 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 清單，查看是否已有項目符合該名稱。 若無，則會建立一個。
• 在 web.xml 中將 ResourceLink 名稱屬性用於 res-ref-name
• 在 web.xml 中將 ResourceLink 類型屬性用於 res-type
• 在 IBM 連結檔中，將 ResourceLink 廣域屬性用於 binding-name
• 將 res-auth 設為 Container
• 將 res-sharing-scope 設為可共用

請注意，其他的 ResourceLink 屬性（factory、username 和 password）不會自動移轉。 如果您的應用程式會在 ResourceLink 中使用這些屬性，您需要在伺服器配置中建立唯一資源，為資源提供唯一的 JNDI 名稱，並以新的 JNDI 名稱更新 IBM 連結檔。

如果 Web 專案是 Java EE 5 或更新的版本，且 WEB-INF/web.xml 不存在，則會建立 WEB-INF/web.xml，並新增資源鏈結參照元素。 如果 Web 專案是 J2EE 1.4 或更舊的版本，快速修正程式將會報告錯誤。

舉例來說，假設 META-INF/Context.xml 含有下列 ResourceLink：

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

快速修正程式會在 web.xml 檔中更新或建立新的 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 配置參照 - 資源鏈結。