Cette règle marque
Context <Parameter>
dans le fichier META-INF/context.xml .
Apache Tomcat autorise
Context <Parameter>
éléments à définir dans ces emplacements:
- dans le fichier META-INF/context.xml,
- dans le fichier XML d'application dans le répertoire conf de Tomcat,
- :NONE.
<Host>
dans l'élément conf/server.xml
L'outil de migration ne migre les éléments de paramètre que vers le fichier META-INF/context.xml.
Vous pouvez copier les informations de paramètre définies à d'autres emplacements dans le fichier META-INF/context.xml en vue de leur traitement.
Si un fichier WEB-INF/web.xml existe dans le projet Web :
Context <Parameter>
seront signalés dans l'une ou l'autre des conditions suivantes :
- l'entrée ne correspond pas à une entrée dans le fichier web.xml,
- l'entrée possède une valeur différente de celle de l'entrée correspondant dans le fichier web.xml et son indicateur de remplacement a pour valeur false.
Un correctif automatisé ajoutera un nouveau
<context-param>
dans le fichier web.xml qui représente l'élément
Context <Parameter>
s'il n'existe pas déjà dans l'élément web.xml fichier.
Si l'entrée existe, elle est mise à jour.
Si le fichier WEB-INF/web.xml n'existe pas :
Tous
Context <Parameter>
seront signalés.
Un correctif automatisé créera un WEB-INF/web.xml fichier qui inclut le fichier
<context-param>
si le projet web si le projet web se trouve à l'adresse Java EE 5 ou plus. Le correctif automatique signalera une erreur si le projet web se trouve à l'adresse J2EE 1.4 ou à une adresse inférieure.
Par exemple, prenez un fichier META-INF/context.xml dont le contenu est le suivant :
<Paramètre
description="Déclenchement car il n'existe pas"
name="newEntry"
override="false"
value=" abc123 "/>
<Parameter
description="Déclenchement car la valeur est différente"
name="paramètre_1"
override="false"
value="new Value"/>
<Parameter
description="Pas de déclenchement car le remplacement a pour valeur true"
name="paramètre_2"
override="true"
value="123"/>
et le fichier web.xml suivant dans l'application :
<contexte-param>
<description>Déclenchement en raison d'une valeur différente</description>
<param-name>parameter_1</param-name>
<param-value>oldValue</param-value>
</context-param>
<context-param>
<description>Ne se déclenchera pas en raison de la valeur "true" de l'option "override"</description>
<param-name>parameter_2</param-name>
<param-value>123456789</param-value>
</context-param>
Après l'application du correctif automatisé, le web.xml sera mis à jour pour devenir contenir :
<contexte-param>
<description>Déclenchement parce qu'il n'existe pas</description>
<param-name>newEntry</param-name>
<param-value>abc123</param-value>
</context-param>
<context-param>
<description>Déclenchement en raison d'une valeur différente</description>
<param-name>parameter_1</param-name>
<param-value>nouvelle valeur</param-value>
</context-param>
<context-param>
<description>Ne se déclenchera pas en raison de la valeur "true" de l'option "override"</description>
<param-name>parameter_2</param-name>
<param-value>123456789</param-value>
</context-param>
Pour plus d'informations sur le paramètre de contexte dans Tomcat, voir :