Această regulă semnalează elementele Context <Resource> găsite în fişierul META-INF/context.xml care pot necesita migrare.
Apache Tomcat permite elementelor Context <Resource> să fie definite în aceste locaţii:
De vreme ce este posibil ca unealta de migrare să nu aibă acces la directorul de configurare Tomcat, aceasta migrează numai fişierul META-INF/context.xml. Informaţiile de resurse definite în alte locaţii pot fi copiate în fişierul META-INF/context.xml pentru a fi procesate.
În scanerul de sursă este disponibilă o corecţie rapidă. Corecţia rapidă ia informaţiile din elementele Resource şi creează o referinţă de resursă sau o referinţă de mediu de resurse, după cum este necesar, şi un nume JNDI corespunzător. Tomcat recomandă, dar nu impune, ca referinţa de resursă corespunzătoare pentru elementul Resource să fie definită în WEB-INF/web.xml. Corecţia rapidă caută lista de elemente resource-ref şi resource-env-ref pentru a vedea dacă intrarea care se potriveşte cu numele există deja. Dacă nu există, este creată una. Dacă elementul Resource are un atribut auth, este creată o resource-ref. Dacă elementul Resource nu are un atribut auth, este creat un resource-env-ref. În ambele cazuri, valoarea name este de asemenea folosită ca nume JNDI şi este definită în legări.
De exemplu, dat fiind următorul element Resource din fişierul META-INF/context.xml:|
<Resource name="jdbc/exampleDB" auth="Container" type="javax.sql.DataSource" description="Example Database"/> |
|
<resource-ref> <description> Example Database</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> |
Implicit, resursele sunt partajabile în Tomcat. Dacă domeniul nu este setat pe elementul Resource, acesta este setat la partajabil când este creată o nouă referinţă de resurse pentru corecţia rapidă. Dacă există deja o potrivire de referinţă de resursă în WEB-INF/web.xml, nu sunt făcute modificări.
Dacă proiectul web este Java EE 5 sau o versiune ulterioară şi WEB-INF/web.xml nu există, este creat WEB-INF/web.xml şi sunt adăugate noile elemente de referinţe resurse. Dacă proiectul web este la versiunea J2EE 1.4 sau una anterioară, corecţia rapidă va raporta o eroare.
De asemenea, va trebui să configuraţi resursa în configuraţia WebSphere.
Pentru informaţii suplimentare privind definiţia resurselor de context în Tomcat, vedeţi: