使用 Java EE 部署描述子來定義環境定義參數

此規則會標示在 META-INF/context.xml 檔中找到的 Context <Parameter> 元素。

Apache Tomcat 容許將 Context <Parameter> 元素定義在下列位置中:

這項移轉工具只會移轉 META-INF/context.xml 檔中的參數元素。 定義在其他位置中的 Parameter 資訊可以複製到 META-INF/context.xml 檔,以便處理它。

如果 WEB-INF/web.xml 存在於 Web 專案中:

在下列任一情況下,將會標示 Context <Parameter> 元素:

在原始檔掃描器中提供了此規則的快速修正程式。 如果 <context-param> 元素不存在於 web.xml 檔中,快速修正程式會在 web.xml 檔中新增它,來代表 Context <Parameter> 元素。 如果該項目存在,就會更新它。

如果 WEB-INF/web.xml 不存在:

會標示所有的 Context <Parameter> 元素。

如果 Web 專案是 Java EE 5 或更新的版本,快速修正程式會建立一個包含適當 <context-param> 元素的 WEB-INF/web.xml 檔。 如果 Web 專案是 J2EE 1.4 或更舊的版本,快速修正程式會報告錯誤。

舉例來說,請考量具有下列內容的 META-INF/context.xml 檔:

<Parameter
description="Trigger because it does not exist"
name="newEntry"
override="false"
value="abc123"/>
<Parameter
description="Trigger because of different value"
name="parameter_1"
override="false"
value="new Value"/>
<Parameter
description="Will not trigger because of override set to true"
name="parameter_2"
override="true"
value="123"/>

應用程式含有下列 web.xml 檔:

<context-param>
<description>Trigger because of different value</description>
<param-name>parameter_1</param-name>
<param-value>oldValue</param-value>
</context-param>

<context-param>
<description>Will not trigger because of override set to true</description>
<param-name>parameter_2</param-name>
<param-value>123456789</param-value>
</context-param>

在套用快速修正程式之後,會更新 web.xml,使其包含:

<context-param>
<description>Trigger because it does not exist</description>
<param-name>newEntry</param-name>
<param-value>abc123</param-value>
</context-param>

<context-param>
<description>Trigger because of different value</description>
<param-name>parameter_1</param-name>
<param-value>new Value</param-value>
</context-param>

<context-param>
<description>Will not trigger because of override set to true</description>
<param-name>parameter_2</param-name>
<param-value>123456789</param-value>
</context-param>

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