Utilizaţi module web versiunea 2.4 sau anterioare atunci când migraţi aplicaţii de la WebSphere V6.1 sau versiuni anterioare

Această regulă semnalează modulele web cu versiunea 2.5 sau versiuni ulterioare atunci când sunt migrate de la WebSphere Application Server Versiunea 6.1 sau ulterioară.

Suportul pentru module web versiunea 2.5 a fost introdus în WebSphere Application Server Versiunea 7. La acel moment, formatul pentru legări şi extensii a fost schimbat de la xmi la formatul xml. Începând cu Versiunea 7, legările formatate xmi nu mai sunt procesate corect într-un modul web cu versiunea 2.5 sau ulterioară.

WebSphere Application Server V6.1 şi versiunile anterioare permiteau să fie instalate module web care aveau un web.xml cu versiunea 2.5. Aplicaţia putea rula fără erori dacă nu va încerca să utilizeze funcţionalitatea suplimentară furnizată de nivelul de specificaţie mai mare. Aceasta are ca rezultat aplicaţii implementate ce nu pot rula corespunzător în versiunile WebSphere mai noi.

De exemplu, dacă aţi instalat un modul web cu versiunea 2.5 în WebSphere Application Server V6.1 şi aţi definit o gazdă virtuală la momentul implementării, aplicaţia va fi implementată cu succes. Definiţia de gazdă virtuală va fi salvată în fişierul xmi de legare al aplicaţiei, ibm-web-bnd.xmi. Dacă apoi migraţi modulul web respectiv la WebSphere Versiunea 7.0 sau ulterioară, serverul se aşteaptă ca informaţiile de legare să fie stocate într-un fişier ibm-web-bnd.xml, nu în formatul xmi. WebSphere Application Server rămâne compatibil înapoi, astfel că dacă modulul web are versiunea 2.4, ibm-web-bnd.xmi va fi interpretat corect de WebSphere Versiunea 7 sau ulterioară.

Această nepotrivire de versiune de modul web şi tipurile de fişier de legări sau extensii poate cauza probleme în serverul de bază şi mediile Network Deployment. Printre scenariile de eroare posibile se numără:

Erori de instalare a aplicaţiei de la taskul WASPostUpgrade în timpul migrării aplicaţiei, dacă aplicaţia conţine un modul web versiunea 2.5 şi un fişier ibm-web-bnd.xmi. Erorile care apar în acest moment sunt create de lipsa informaţiilor de legare, deoarece nu sunt citite legările xmi.
Erori la momentul implementării pentru un server de bază sau manager de implementare Versiunea 7 sau ulterioară, dacă aplicaţia dumneavoastră conţine un modul web versiunea 2.5 şi un fişier ibm-web-bnd.xmi.
Erori la momentul implementării într-un mediu cu celule mixte, dacă aplicaţia dumneavoastră nu conţine legări, dar acestea sunt realizate în momentul implementării într-un mediu Network Deployment. Această instalare produce o aplicaţie cu un modul web versiunea 2.5 şi legări xml. Însă artefactele aplicaţiei nu sunt înţelese de nodurile WebSphere V6.1. Pentru nodurile cu Web Services Feature Pack, aplicaţia ar putea fi sincronizată cu nodul V6.1, dar nu poate rula deoarece nodul V6.1 nu poate interpreta legările şi extensiile xml. Pentru nodurile fără Web Services Feature Pack, nu va reuşi stabilirea aplicaţiei ca ţintă.

Când se realizează migrarea de la Versiunea 6.1 şi cele anterioare, un web.xml cu următorul conţinut va fi semnalat:

<web-app id="WebApp_Id" version="2.5"
xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
...
</web-app>

Versiunea de aplicaţie web ar trebui să fie modificată la versiunea 2.4. Soluția automată va modifica versiunea și informațiile despre schemă, după cum se arată în exemplul următor:

< span class="Code"> < ?xml version= "1.0" encoding= "UTF-8"
< web-app id="WebApp_ID "< b> versiunea ="2.4" < /b>
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/http://java.sun.com/xml/ns/
...
</web-app>

Pentru informaţii suplimentare despre nivelurile specificaţiei Java EE suportate pentru diferite versiuni de WebSphere Application Server, vedeţi Programming model APIs and specifications.