Ta reguła powoduje oznaczenie flagą elementów Context <Resource> w pliku META-INF/context.xml, które mogą wymagać migracji.
Produkt Apache Tomcat umożliwia definiowanie elementów Context <Resource> w następujących miejscach:
Ponieważ narzędzie migracji nie ma dostępu do katalogu konfiguracyjnego Tomcat, przeprowadza tylko migrację pliku META-INF/context.xml. Informacje Resource zdefiniowane w innych miejscach mogą zostać skopiowane do pliku META-INF/context.xml, aby zostały przetworzone.
Szybka poprawka jest dostępna w skanerze kodu źródłowego. Szybka poprawka pobiera informacje z elementów Resource i tworzy w razie potrzeby odwołanie do zasobu lub odwołanie do środowiska zasobów, a także odpowiednią nazwę JNDI. Dla produktu Tomcat jest zalecane (ale nie jest wymagane), aby odpowiednie odwołanie do zasobu dla elementu Resource było zdefiniowane w pliku WEB-INF/web.xml. Szybka poprawka przeszukuje listę elementów resource-ref i resource-env-ref w celu sprawdzenia, czy istnieje wpis zgodny z nazwą. Jeśli nie, zostanie on utworzony. Jeśli element Resource ma atrybut auth, tworzony jest wpis resource-ref. Jeśli element Resource nie ma atrybutu auth, tworzony jest wpis resource-env-ref. W obu przypadkach wartość name jest także używana jako nazwa JNDI i jest definiowana w powiązaniach.
Przykładem jest następujący element Resource z pliku META-INF/context.xml:|
<Resource name="jdbc/exampleDB" auth="Container" type="javax.sql.DataSource" description="Przykład bazy danych"/> |
|
<resource-ref> <description> Przykład bazy danych</description> <res-ref-name>jdbc/exampleDB</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> <res-sharing-scope>Shareable</res-sharing-scope> </resource-ref> |
Domyślnie w produkcie Tomcat zasoby są współużytkowalne. Jeśli w elemencie Resource nie jest ustawiony zasięg, w momencie tworzenia nowego odwołania do zasobu dla szybkiej poprawki zasięg zostaje ustawiony na wartość Shareable (współużytkowalne). Jeśli w pliku WEB-INF/web.xml istnieje już zgodne odwołanie do zasobu, nie są wprowadzane zmiany.
Jeśli projekt WWW jest w wersji Java EE 5 lub nowszej, a plik WEB-INF/web.xml nie istnieje, zostanie utworzony plik WEB-INF/web.xml i zostaną dodane nowe elementy odwołań do zasobów. Jeśli projekt WWW jest w wersji J2EE 1.4 lub starszej, szybka poprawka zgłosi błąd.
Konieczne będzie także skonfigurowanie zasobu w konfiguracji produktu WebSphere.
Dodatkowe informacje na temat definicji zasobu kontekstu na serwerze Tomcat można znaleźć w sekcji: