此規則會標示
Context <Environment>
在 META-INF/context.xml 檔中找到必須轉換成
<env-entry>
中的元素
WEB-INF/web.xml 檔。
Apache Tomcat 容許
Context <Environment>
要在下列位置中定義的元素:
- META-INF/context.xml 檔
- Tomcat conf 目錄中的應用程式 XML 配置檔
- 該
<Host>
conf/server.xml 中的元素
由於遷移工具可能無法存取 Tomcat 配置目錄、 它只會標記
Context <Environment>
在 META-INF/context.xml 檔案中。
Context <Environment>
在其他位置定義的資訊可以複製到 複製到 META-INF/context.xml 檔案，以便 以便工具處理。
如果 WEB-INF/web.xml 存在於 Web 專案中：
Context <Environment>
元素在下列任何一種情況下會被標記：
- 該項目在 web.xml 檔中沒有相符項。
- 該項目的類型與 web.xml 檔中的相符項不同。
- 該項目的值與 web.xml 檔中的相符項不同，且其置換旗標設為 false。
新增
<env-entry>
元素在 web.xml 檔案中的 代表
Context <Environment>
元素，如果它不存在於 web.xml 檔案中。
如果該項目存在，就會更新它。
如果 WEB-INF/web.xml 不存在：
全部
Context <Environment>
元素將被標記。
建立一個 WEB-INF/web.xml 檔案 包含適當的
<env-entry>
元素，如果 網頁專案為 Java EE 5 或更高版本。 自動修正程式會報錯，如果網頁專案 為 J2EE 1.4 或更低。
舉例來說，請考量具有下列內容的
META-INF/context.xml 檔：
<環境
description="Trigger because it does not exist"
name="newEntry"
override="false"
type=" java.lang.String " value=" abc123 "/>
<Environment
description="Trigger because of different value"
name="contextEnvString_1"
override="false"
type="java.lang.String"
value="new Value"/>
<Environment
description="Trigger because of different type"
name="contextEnvString_2"
override="false"
type="java.lang.Integer"
value="123"/>
<Environment
description="will not Trigger because of override set to true."
name="contextEnvString_3"
override="true"
type="java.lang.Integer"
value="123"/>
應用程式含有下列 web.xml 檔：
<env-entry
<description>因不同值而觸發</description>
<env-entry-name>contextEnvString_1</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>oldValue</env-entry-value>
</env-entry>
<env-entry>
<description>因類型不同而觸發</description>
<env-entry-name>contextEnvString_2</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>123</env-entry-value>
</env-entry>
<env-entry>
<description>將不會觸發，因為覆寫設定為 true。</description>
<env-entry-name>contextEnvString_3</env-entry-name>
<env-entry-type>java.lang.Integer</env-entry-type>
<env-entry-value>123456789</env-entry-value>
</env-entry>
自動修正套用後， web.xml 將更新為 包含：
<env-entry
<description>因不同值而觸發</description>
<env-entry-name>contextEnvString_1</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>新值</env-entry-value>
</env-entry>
<env-entry>
<description>因類型不同而觸發</description>
<env-entry-name>contextEnvString_2</env-entry-name>
<env-entry-type>java.lang.Integer</env-entry-type>
<env-entry-value>123</env-entry-value>
</env-entry>
<env-entry>
<description>將不會觸發，因為覆寫設定為 true。</description>
<env-entry-name>contextEnvString_3</env-entry-name>
<env-entry-type>java.lang.Integer</env-entry-type>
<env-entry-value>123456789</env-entry-value>
</env-entry>
<env-entry>
<description>觸發，因為它不存在</description>
<env-entry-name>newEntry</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>abc123</env-entry-value>
</env-entry>