Utilizaţi descriptori de implementare Java EE şi legări WebSphere pentru a defini referinţe de legări de resurse

Această regulă semnalează elementele Context <ResourceLink> găsite în fişierul META-INF/context.xml care ar putea avea nevoie de migrare.

Apache Tomcat permite elementelor Context <ResourceLink> să fie definite în aceste locaţii:

• Fişierul META-INF/context.xml
• Fişierul de configuraţie XML al aplicaţiei din directorul Tomcat conf
• Elementul <Host> din conf/server.xml

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 ResourceLink 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 ResourceLink şi creează o referinţă de resursă şi un nume JNDI corespunzător, după cum urmează:

• Corecţia rapidă caută lista de elemente resource-ref pentru a vedea dacă intrarea care se potriveşte cu numele există deja. Dacă nu există, este creată una.
• Atributul de nume ResourceLink este utilizat pentru res-ref-name în web.xml
• Atributul de tip ResourceLink este utilizat pentru res-type în web.xml
• Atributul global ResourceLink este utilizat pentru binding-name în fişierul de legări IBM
• res-auth este setat la Container
• res-sharing-scope este setat la Shareable

Reţineţi că celelalte atribute ResourceLink (fabrică, nume de utilizator şi parolă) nu sunt migrate automat. Dacă aplicaţia dumneavoastră utilizează aceste atribute într-o ResourceLink, atunci va trebui să creaţi o resursă unică în configuraţia serverului, să furnizaţi resursa cu un nume JNDI unic şi să actualizaţi fişierul de legări IBM cu noul nume JNDI.

Dacă proiectul web este Java EE 5 sau o versiune ulterioară şi WEB-INF/web.xml nu există, este creat fişierul WEB-INF/web.xml şi sunt adăugate noile elemente de referinţe la legături de resurse. Dacă proiectul web este la versiunea J2EE 1.4 sau una anterioară, corecţia rapidă va raporta o eroare.

De exemplu, dat fiind un fişier META-INF/Context.xml care conţine ResourceLink următoare:

<ResourceLink global="jdbc/SampleWebGlobal" name="jdbc/SampleWeb" type="javax.sql.DataSource"/>

Corecţia rapidă va actualiza sau crea resource-ref nouă în fişierul web.xml similar cu acest exemplu:

<resource-ref id="ResourceRef_1313785392722"> <res-ref-name>jdbc/SampleWeb</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> <res-sharing-scope>Shareable</res-sharing-scope> </resource-ref>

Numele JNDI este adăugat la fişierul de legări IBM. Se face referire la referinţa existentă definită în fişierul web.xml. Dacă fişierul de legări nu există, este creat unul.

De asemenea, va trebui să configuraţi resursa în configuraţia WebSphere Application Server.

Pentru informaţii suplimentare privind definiţia resurselor de context în Tomcat, vedeţi:

• Apache Tomcat Configuration Reference - Resource Links.