Usar descritores de implementação Java EE para definir as referências de ambiente

Esta regra sinaliza Context <Environment> localizado no arquivo META-INF/context.xml que deve ser transformado em <env-entry> elementos no arquivoWEB-INF/web.xml

Apache Tomcat permite Context <Environment> elementos a serem definidos nestes locais:

Como a ferramenta de migração pode não ter acesso ao diretório de configuração Tomcat, ela sinaliza apenas o diretório Context <Environment> no META-INF/context.xml arquivo. Context <Environment> as informações definidas em outros locais podem ser copiadas para o arquivo META-INF/context.xml arquivo para para que ele seja processado pela ferramenta.

Se existir um WEB-INF/web.xml no projeto da web:

Context <Environment> serão sinalizados em qualquer uma das seguintes condições:

Adicionar um novo <env-entry> no arquivo web.xml arquivo que representa o Context <Environment> se ele ainda não existir no elemento web.xml arquivo. Se a entrada existir, ela será atualizada.

Se WEB-INF/web.xml não existir:

Todos Context <Environment> serão sinalizados.

Criar um WEB-INF/web.xml arquivo que inclua o arquivo <env-entry> se o projeto o projeto da Web estiver em Java EE 5 ou superior. A correção automática informará um erro se o projeto da Web estiver em J2EE 1.4 ou inferior.

Por exemplo, considere um arquivo META-INF/context.xml com o conteúdo a seguir:
<Ambiente
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"/>

Com o arquivo web.xml a seguir no aplicativo:

<env-entry>
<description>Acionador devido a um valor diferente</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>Acionador devido a um tipo diferente</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>não será acionado porque a substituição foi definida como verdadeira.</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>

Depois que a correção automatizada for aplicada, o web.xml será atualizado para conter:

<env-entry>
<description>Acionador devido a um valor diferente</description>
<env-entry-name>contextEnvString_1</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>novo Valor</env-entry-value>
</env-entry>

<env-entry>
<description>Acionador devido a um tipo diferente</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>não será acionado porque a substituição foi definida como verdadeira.</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>Trigger porque não existe</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>