Migration WDO vers SDO

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 :
  • Vous pouvez modifier le serveur cible à l'aide de la boîte de dialogue des propriétés du projet. Cliquez à l'aide du bouton droit dans la vue Explorateur de projets et sélectionnez Propriétés > Serveur > Environnement d'exécution cible.
  • Lors de la migration J2EE à l'aide de l'assistant de migration J2EE, vous pouvez cibler à nouveau l'application afin qu'elle utilise un autre serveur.
    Remarque : Vous pouvez effectuer la migration uniquement vers un niveau de spécification J2EE supérieur.
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 Application 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 :
  1. 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;
  2. 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 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 :

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

Sujet parent : Migration à partir de WebSphere Studio V5.1, 5.1.1 ou 5.1.2

Concepts associés
Compatibilité avec WebSphere Studio V5.1.x

Tâches associées
Migration à partir de WebSphere Studio V5.1, 5.1.1 ou 5.1.2

Conditions d'utilisation | Commentaires
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.