Utilizza i descrittori di distribuzione Java EE per definire i parametri di contesto

Questa regola contrassegna gli elementi Context <Parameter> trovati nel file META-INF/context.xml.

Apache Tomcat consente di definire gli elementi Context <Parameter> in questi percorsi:

• il file META-INF/context.xml
• Il file di configurazione XML dell'applicazione nella directory Tomcat conf
• L'elemento <Host> in conf/server.xml

Lo strumento di migrazione migra solo gli elementi parametro nel file META-INF/context.xml. Le informazioni sul parametro definite in altri percorsi possono essere copiate nel file META-INF/context.xml in modo che sia possibile elaborarle. for it to be processed.

Se esiste un file WEB-INF/web.xml nel progetto web:

Gli elementi Context <Parameter> verranno contrassegnati alle seguenti condizioni:

• la voce non dispone di una voce corrispondente nel file web.xml.
• La voce dispone si un valore differente rispetto alla corrispondente voce in web.xml ed il relativo flag di sovrascrittura viene impostato su false.

Nello scanner di origine è disponibile una correzione rapida per questa regola. La correzione rapida aggiungerà un nuovo elemento <context-param> nel file web.xml che rappresenta l'elemento Context <Parameter> se non esiste già nel file web.xml. Se la voce esiste, verrà aggiornata.

Se WEB-INF/web.xml non esiste:

verranno contrassegnati tutti gli elementi Context <Parameter>.

La correzione rapida creerà un file WEB-INF/web.xml che include gli elementi <context-param> appropriati se il progetto web è al livello Java EE 5 o successivo. La correzione rapida riporterà un errore se il progetto web è al livello J2EE 1.4 o o inferiore.

Ad esempio, considerare un file META-INF/context.xml con il seguente contenuto:

<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 il seguente file web.xml nell'applicazione:

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

Una volta che è stata applicata la correzione rapida, il file web.xml verrà aggiornato per contenere:

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

Per ulteriori informazioni sul parametro di contesto in Tomcat, consultare:

• Apache Tomcat Configuration Reference - Context Parameters.