Utilizar los descriptores de despliegue Java EE para definir referencias de entorno

Esta regla marca los elementosContext <Environment> encontrados en el archivo META-INF/context.xml que deben transformarse en elementos <env-entry> en el archivo WEB-INF/web.xml.

Apache Tomcat permite definir los elementos Context <Environment> en las siguientes ubicaciones:

El archivo META-INF/context.xml
El archivo de configuración XML de aplicación en el directorio conf de Tomcat
El elemento <Host> en conf/server.xml

Dado que puede que la herramienta de migración no tenga acceso al directorio de configuración de Tomcat, sólo marca Context <Environment> en el archivo META-INF/context.xml. La información de Context <Environment> definida en las otras ubicaciones puede copiarse en el archivo META-INF/context.xml para que se procese en la herramienta.

Si existe un archivo WEB-INF/web.xml en el proyecto web:

Los elementos Context <Environment> se marcarán en las siguientes condiciones:

La entrada no tiene una entrada coincidente en el archivo web.xml.
La entrada tiene un tipo diferente que la entrada coincidente en el archivo web.xml.
La entrada tiene un valor diferente que la entrada coincidente en el archivo web.xml y el distintivo de alteración temporal establecido en false.

Un arreglo rápido para esta regla está disponible en el explorador de orígenes. El arreglo rápido añadirá un nuevo elemento <env-entry> en el archivo web.xml que representa el elemento Context <Environment> si aún no existe en el archivo web.xml. Si la entrada existe, se actualizará.

Si el archivo WEB-INF/web.xml no existe:

Se marcarán todos los elementos Context <Environment>.

El arreglo rápido creará un archivo WEB-INF/web.xml que incluye los elementos <env-entry> correspondientes si el proyecto web tiene una versión Java EE 5 o superior. Si el proyecto web tiene la versión en J2EE 1.4 o inferior, el arreglo rápido informará de un error.

Por ejemplo, supongamos un archivo META-INF/context.xml con el siguiente contenido:

con el siguiente archivo web.xml en la aplicación:

<env-entry>
<description>Trigger because of different value</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>Trigger because of different type</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>will not Trigger because of override set to 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>

Cuando se aplica el arreglo rápido, el archivo web.xml se actualizará para contener:

<env-entry>
<description>Trigger because of different value</description>
<env-entry-name>contextEnvString_1</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>new Value</env-entry-value>
</env-entry>

<env-entry>
<description>Trigger because of different type</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>will not Trigger because of override set to 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>Trigger because it does not exist</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>