此規則會標示
Context <Parameter>
在 META-INF/context.xml 檔中找到個元素。
Apache Tomcat 容許
Context <Parameter>
要在下列位置中定義的元素:
- META-INF/context.xml 檔
- Tomcat conf 目錄中的應用程式 XML 配置檔
- 該
<Host>
conf/server.xml 中的元素
這項移轉工具只會移轉 META-INF/context.xml 檔中的參數元素。
定義在其他位置中的 Parameter 資訊可以複製到
META-INF/context.xml 檔，以便處理它。
如果 WEB-INF/web.xml 存在於 Web 專案中：
Context <Parameter>
將在下列任一條件下標示元素:
- 該項目在 web.xml 檔中沒有相符項。
- 該項目的值與 web.xml 檔中的相符項不同，且其置換旗標設為 false。
在原始檔掃描器中提供了此規則的快速修正程式。 快速修正程式將新增
<context-param>
web.xml 檔中的元素，代表
Context <Parameter>
元素 (如果它尚未存在於
web.xml 檔。
如果該項目存在，就會更新它。
如果 WEB-INF/web.xml 不存在：
全部
Context <Parameter>
將會標示個元素。
快速修正程式會建立 WEB-INF/web.xml 檔，其中包含適當的
<context-param>
元素 (如果 Web 專案位於 Java EE 5 或更新版本)。 如果 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>觸發程式，因為不同的值</description>
<param-name>parameter_1</param-name>
<param-value>oldValue</param-value>
</context-param>
<context-param>
<description>將不會觸發，因為置換設為 true</description>
<param-name>parameter_2</param-name>
<param-value>123456789</param-value>
</context-param>
在套用快速修正程式之後，會更新 web.xml，使其包含：
<context-param>
<description>因為觸發程式不存在而觸發程式</description>
<param-name>newEntry</param-name>
<param-value>abc123</param-value>
</context-param>
<context-param>
<description>觸發程式，因為不同的值</description>
<param-name>parameter_1</param-name>
<param-value>新值</param-value>
</context-param>
<context-param>
<description>將不會觸發，因為置換設為 true</description>
<param-name>parameter_2</param-name>
<param-value>123456789</param-value>
</context-param>
如需 Tomcat 中之環境定義參數的相關資訊，請參閱：