Utilizzare i descrittori di distribuzione Java EE per definire i riferimenti ambiente

Questa regola contrassegna gli elementi Context <Environment> trovati nel file META-INF/context.xml che devono essere trasformati negli elementi <env-entry> nel file WEB-INF/web.xml.

Apache Tomcat consente di definire gli elementi Context <Environment> 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

Poiché lo strumento di migrazione potrebbe non avere accesso alla directory di configurazione Tomcat, contrassegna solo Context <Environment> nel file META-INF/context.xml. Le informazioni Context <Environment> definite in altri percorsi possono essere copiate nel file META-INF/context.xml in modo che lo strumento possa elaborarle.

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

gli elementi Context <Environment> verranno contrassegnati alle seguenti condizioni:

la voce non dispone di una voce corrispondente nel file web.xml.
La voce dispone di un differente tipo rispetto alla corrispondente voce nel file web.xml.
La voce dispone di un valore differente rispetto alla corrispondente voce in web.xml e il relativo flag di sovrascrittura è impostato su false.

Nello scanner di origine è disponibile una correzione rapida per questa regola. La correzione rapida aggiunge un nuovo elemento <env-entry> nel file web.xml che rappresenta l'elemento Context <Environment> 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 <Environment>.

La correzione rapida creerà un file WEB-INF/web.xml che include gli elementi <env-entry> appropriati se il progetto web p a livello Java EE 5 o successivo. La correzione rapida riporterà un errrore se il progetto web è a livello di J2EE 1.4 o inferiore.

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

con il seguente file web.xml nell'applicazione:

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

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

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