Użyj deskryptorów wdrażania Java EE do zdefiniowania parametrów kontekstu

Ta reguła powoduje oznaczenie flagą elementów Context <Parameter> w pliku META-INF/context.xml.

Produkt Apache Tomcat umożliwia definiowanie elementów Context <Parameter> w następujących miejscach:

• Plik META-INF/context.xml
• Plik konfiguracyjny XML aplikacji w katalogu conf produktu Tomcat
• Element <Host> w pliku conf/server.xml

Narzędzie migracji przeprowadza migracje tylko elementów parametru w pliku META-INF/context.xml. Informacje Parameter zdefiniowane w innych miejscach mogą zostać skopiowane do pliku META-INF/context.xml, aby zostały przetworzone.

Jeśli w projekcie WWW istnieje plik WEB-INF/web.xml:

Elementy Context <Parameter> zostaną oznaczone flagą w przypadku spełnienia dowolnego z następujących warunków:

• Dla tego wpisu nie ma zgodnego wpisu w pliku web.xml.
• Ten wpis ma inną wartość niż zgodny wpis w pliku web.xml i jego flaga override ma wartość false.

Szybka poprawka dla tej reguły jest dostępna w skanerze źródła. Szybka poprawka doda nowy element <context-param> w pliku web.xml, który reprezentuje element Context <Parameter>, jeśli on jeszcze nie istnieje w pliku web.xml. Jeśli wpis istnieje, zostanie zaktualizowany.

Jeśli plik WEB-INF/web.xml nie istnieje:

Wszystkie elementy Context <Parameter> zostaną oznaczone flagą.

Szybka poprawka utworzy plik WEB-INF/web.xml, który zawiera odpowiednie elementy <context-param>, jeśli projekt WWW jest w wersji Java EE 5 lub nowszej. Szybka poprawka zgłosi błąd, jeśli projekt WWW będzie w wersji J2EE 1.4 lub starszej.

Jako przykład można rozważyć plik META-INF/context.xml o następującej zawartości:

<Parameter description="Wyzwól, ponieważ nie istnieje" name="newEntry" override="false" value="abc123"/> <Parameter description="Wyzwól z powodu innej wartości" name="parameter_1" override="false" value="new Value"/> <Parameter description="Nie wyzwalaj, ponieważ wartość override jest ustawiona na true" name="parameter_2" override="true" value="123"/>

z następującym plikiem web.xml w aplikacji:

<context-param> <description>Wyzwól z powodu innej wartości</description> <param-name>parameter_1</param-name> <param-value>oldValue</param-value> </context-param> <context-param> <description>Nie wyzwalaj, ponieważ wartość override jest ustawiona na true</description> <param-name>parameter_2</param-name> <param-value>123456789</param-value> </context-param>

Po zastosowaniu szybkiej poprawki plik web.xml zostanie zaktualizowany tak, aby jego zawartość była następująca:

<context-param> <description>Wyzwól, ponieważ nie istnieje</description> <param-name>newEntry</param-name> <param-value>abc123</param-value> </context-param> <context-param> <description>Wyzwól z powodu innej wartości</description> <param-name>parameter_1</param-name> <param-value>new Value</param-value> </context-param> <context-param> <description>Nie wyzwalaj, ponieważ wartość override jest ustawiona na true</description> <param-name>parameter_2</param-name> <param-value>123456789</param-value> </context-param>

Dodatkowe informacje o parametrze kontekstu w produkcie Tomcat zawiera temat:

• Informacje dodatkowe o konfiguracji produktu Apache Tomcat – parametry kontekstu.