Utilizar los descriptores de despliegue Java EE para definir parámetros de contexto

Esta regla marca los elementos Context <Parameter> encontrados del archivo META-INF/context.xml.

Apache Tomcat permite definir los elementos Context <Parameter> 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

La herramienta de migración sólo migra los elementos de parámetro del archivo META-INF/context.xml. La información de parámetros definida en las otras ubicaciones puede copiarse en el archivo META-INF/context.xml para su proceso.

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

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

• La entrada no tiene una 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 está 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 <context-param> en el archivo web.xml que representa el elemento Context <Parameter> si no existe previamente 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 <Parameter>.

El arreglo rápido creará un archivo WEB-INF/web.xml que incluye los elementos <context-param> 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:

<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"/>

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

<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>

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

<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>

Para obtener información adicional sobre el parámetro de contexto en Tomcat, consulte:

• Referencia de configuración de Apache Tomcat - Parámetros de contexto.