Si vous avez créé du code dans un projet Web ciblé vers WebSphere Application
Server V5.1 qui utilisait des enregistrements relationnels ou des listes
d'enregistrements relationnels WDO (WebSphere Data Objects), lorsque vous ciblez ces applications
vers WebSphere Application
Server V6.0, vous utilisez des listes d'enregistrements relationnels et des enregistrements
relationnels SDO (Service Data Objects). La migration de WDO vers SDO se produit automatiquement
lorsque vous changez le serveur cible de l'application, WebSphere Application Server V5.1 en WebSphere Application
Server V6.0.
Il existe deux méthodes permettant de changer le serveur cible :
Des rubriques d'aide relatives à la modification du serveur cible et à l'utilisation
de l'assistant de migration J2EE sont disponibles dans l'aide en ligne de
Rational Web Developer.
Remarques relatives à la compatibilité
- Tout code écrit dans les API (Application Programming Interface) publiques pour les beans
d'accès WDO est pris en charge dans la version 6.0 (bien que les classes
d'implémentation ont été modifiées pour cibler l'environnement d'exécution SDO).
- Le nouveau code généré pour WebSphere Application Server V6.0 n'utilise pas les beans
d'accès WDO mais génère à la place du code pour les API SDO pures.
- Tout code généré sur un projet avec la version 6.0 ne s'exécute pas sur un serveur V5.1 même s'il a été migré en ciblant à nouveau le serveur.
- Le code rédigé pour la version 5.1 peut être migré en amont et en aval en ciblant un serveur V5.1.
Des erreurs liées à des conflits de type peuvent se produire suite
à la migration de WDO vers SDO
Une fois qu'un projet utilisant WDO est migré
vers un projet de type SDO, si vous ajoutez des données SDO à une page JSP existante qui comporte
des données WDO, des erreurs de collision de type peuvent se produire. Cette situation est due au fait
qu'il existe à la fois des beans d'accès WDO et des API SDO autonomes. Par exemple, vous pouvez voir
une erreur de compilation sur le fichier source Java du fichier JSP du type suivant :
The import com.ibm.websphere.sdo.mediator.exception.MediatorException collides with another imported type
Ces erreurs de collision de type peuvent être corrigées de la manière suivante :
- Supprimez l'instruction d'importation incompatible du fichier source Java. A l'aide de l'exemple
ci-dessus, vous devez supprimer l'instruction d'importation du fichier source :
import com.ibm.websphere.wdo.mediator.exception.MediatorException;
- Modifiez le fichier source Java qui fait référence à ce type pour utiliser le nom de classe complet. En fonction
de l'exemple ci-dessus, le type MediatorException doit être modifié en com.ibm.websphere.wdo.mediator.exception.MediatorException.
Par exemple, le code source écrit sous la forme
catch ( MediatorException e1 ) {
doit être
modifié en catch ( com.ibm.websphere.wdo.mediator.exception.MediatorException e1 ) {
Les modifications apportées à un projet Web après la modification du serveur cible de la version
V5.1 en V6.0 (WDO vers SDO)
Les modifications suivantes sont effectuées automatiquement lorsque le serveur
cible est changé, il passe du niveau de la version 5.1 à la version 6.0 :
- Les fichiers JAR (Java archive) wdo_web.jar et wdo_jdbc_access.jar sont supprimés du projet.
- Les fichiers JAR suivants sont supprimés du chemin d'accès aux classes du projet :
- emf-runtime.jar
- emf-event.jar
- wdo-interface.jar
- wdo.jar
- jdbcmediator.jar
- wdo.xmlmediator.jar
- Les fichiers sdo_web.jar et sdo_access_beans.jar sont ajoutés au projet
(les fichiers JAR de l'environnement d'exécution SDO sont automatiquement ajoutés à un chemin d'accès aux classes
d'un projet V6.0).
- Les fichiers JAR JSTL (JavaServer Pages Standard Tag Library) 1.0 sont supprimés du projet. Les fichiers JAR JSTL 1.1/JSP 2.0 sont automatiquement ajoutés au chemin d'accès aux classes du projet V6.0.
- Les instructions d'importation suivantes sont modifiées dans les fichiers source Java :
- com.ibm.websphere.wdo.access.connections.ConnectionManager est modifié en
com.ibm.websphere.sdo.access.connections.ConnectionManager.
- com.ibm.websphere.wdo.mediator.rdb.ConnectionWrapper est modifié en
com.ibm.websphere.sdo.mediator.jdbc.ConnectionWrapper.
Les modifications apportées à un projet Web après la modification du serveur cible
de la version 6.0 en V5.1 (SDO vers WDO)
Les modifications suivantes sont effectuées automatiquement
lorsque le serveur cible passe de V6.0 à V5.1 :
- Les fichiers JAR sdo_web.jar et sdo_access_beans.jar sont supprimés du projet.
- Les fichiers JAR wdo_web.jar et wdo_jdbc_access.jar sont ajoutés au projet.
- Les fichiers JAR suivants sont ajoutés au chemin d'accès aux classes du projet :
- emf-runtime.jar
- emf-event.jar
- wdo-interface.jar
- wdo.jar
- jdbcmediator.jar
- wdo.xmlmediator.jar
- Les fichiers JAR JSTL 1.0 sont ajoutés au projet. Les fichiers JAR JSTL 1.1/JSP 2.0
sont supprimés du chemin d'accès aux classes du projet.
- Les instructions d'importation suivantes sont modifiées dans les fichiers source Java :
- com.ibm.websphere.sdo.access.connections.ConnectionManager devient com.ibm.websphere.wdo.access.connections.ConnectionManager.
- com.ibm.websphere.sdo.mediator.jdbc.ConnectionWrapper devient com.ibm.websphere.wdo.mediator.rdb.ConnectionWrapper.
Modifications apportées à un projet Web après la modification du niveau J2EE de l'application de la version 1.3 à la version 1.4
Outre les modifications effectuées pour la migration de WDO vers SDO en modifiant la cible de serveur en WebSphere Application
Server V6.0, la modification du niveau de spécification J2EE de l'application de la version
1.3 vers 1.4 met à jour les références taglib (bibliothèque de balises) dans les pages JSP. Ainsi les bibliothèques
de balises JSTL 1.0 WDO sont modifiées en bibliothèques de balises JSTL 1.1/jsp 2.0 SDO. Le tableau suivant affiche les modifications
effectuées dans les références taglib JSP lorsque vous passez de J2EE 1.3 à J2EE 1.4.
Tableau 1. Références taglib JSP dans
J2EE 1.3 et J2EE 1.4.Elément J2EE 1.3 (WDO) |
Elément J2EE 1.4 (SDO) |
http://www.ibm.com/websphere/wdo/core |
http://www.ibm.com/websphere/sdo/core |
http://java.sun.com/jstl/core |
http://java.sun.com/jsp/jstl/core |
http://java.sun.com/jstl/fmt |
http://java.sun.com/jsp/jstl/fmt |
http://java.sun.com/jstl/xml |
http://java.sun.com/jsp/jstl/xml |
http://java.sun.com/jstl/sql |
http://java.sun.com/jsp/jstl/sql |