Migration de projets Web Struts

Pour les projets Web Struts crées dans WebSphere Studio version 5.1.x, vous devez apporter une modification mineure au descripteur de déploiement du projet Web pour exécuter le projet EAR dans WebSphere Application Server version 6.0. Vous pouvez également convertir manuellement des projets Struts 1.0.2 ou Struts 1.1 bêta (2 ou 3) en projets Web Struts 1.1.

Modification du descripteur de déploiement des projets Web Struts existants

Lorsqu'un projet Struts est créé dans WebSphere Studio version 5.x, le paramètre de configuration (<param-name>config</param-name>) défini dans le descripteur de déploiement du projet Web correspond à WEB-INF/struts-config.xml. WebSphere Application Server version 6.0 requiert que le caractère "/" soit placé devant ce paramètre. Si vous exécutez un projet Web Struts créé dans WebSphere Studio version 5.1.x sur un système WebSphere Application Server version 6.0, une exception java.net.MalformedURLException peut se produire lors du lancement du projet EAR.

Remarque : Rational Application Developer version 6.0 ajoute le caractère "/" lorsque vous créez un projet Struts. Toutefois, vous devez l'ajouter manuellement lorsque vous effectuez une migration à partir de WebSphere Studio version 5.1x.
Pour corriger dans la version 6.0 le descripteur de déploiement d'un projet Web Struts Web créé dans WebSphere Studio v5.1.x, procédez comme suit :
  1. Ouvrez le projet Web Struts dans l'explorateur de projets.
  2. Cliquez deux fois sur le fichier Descripteur de déploiement dans l'explorateur de projets. L'éditeur de descripteur de déploiement Web s'affiche.
  3. Cliquez sur l'onglet Source pour ouvrir la page Source.
  4. Remplacez la ligne

    <param-value>WEB-INF/struts-config.xml</param-value> (située dans les balises <servlet></servlet>)

    par

    <param-value>/WEB-INF/struts-config.xml</param-value>.

  5. Sauvegardez le descripteur de déploiement Web.
L'exception java.net.MalformedURLException ne doit pas se produire lorsque vous relancez le projet EAR.

Conversion des projets Web Struts 1.1 bêta en projets Web Struts 1.1

Dans WebSphere Studio 5.1.x, la bibliothèque d'exécution Struts passe de Struts 1.1 bêta (2 ou 3) dans 5.0.x à Struts 1.1 (final). Si vous possédez des projets Web Struts 1.1 bêta (2 ou 3) et que vous souhaitez les convertir pour Struts 1.1 (final), vous pouvez les convertir manuellement. (Remarque : Il est pas obligatoire de convertir les projets Struts 1.1 bêta (2 ou 3) en projets Struts 1.1.)

Pour convertir des projets Struts 1.1 bêta (2 ou 3) en projets Struts 1.1, procédez comme suit :
  1. Chargez les projets Struts 1.1 bêta dans l'espace de travail Rational Application Developer version 6.0.
  2. Créez un projet Web Struts 1.1 appelé Struts11, par exemple. Vous créez ce projet temporaire pour accéder facilement aux fichiers d'exécution Struts 1.1 dont vous avez besoin pour convertir les projets réels. Vous pourrez supprimer ce projet lorsque vous aurez terminé.
  3. Effectuez les opérations ci-dessous pour chaque projet Struts 1.1 bêta que vous souhaitez convertir pour Struts 1.1 :
    1. Supprimez les fichiers .JAR suivants du répertoire Web Content/WEB-INF/lib du projet :
      • commons-*.jar.
      • struts.jar.
    2. Copiez les fichiers JAR suivants du répertoire Struts11/WebContent/WEB-INF/lib dans le répertoire Web Content/WEB-INF/lib du projet :
      • commons-*.jar.
      • struts.jar.
    3. Supprimez les fichiers TLD (Tag Library Descriptor) suivants stockés dans le répertoire Web Content/WEB-INF du projet : struts-*.tld.
    4. Copiez les fichiers suivants du répertoire Struts11/WebContent/WEB-INF dans le répertoire du projet Web Content/WEB-INF : struts-*.tld.

Conversion des projets Web Struts 1.0.2 vers des projets Struts 1.1

Lorsque vous ajoutez le support Struts à un projet Web dans WebSphere Studio 5.1.x (et 5.0.x), vous avez la possibilité de sélectionner Struts 1.0.2. Si vous possédez des projets Web Struts 1.0.2 existants et que vous souhaitez les convertir pour Struts 1.1, vous pouvez les convertir manuellement. (Remarque : Il est pas obligatoire de convertir les projets Struts 1.1 bêta (2 ou 3) en Struts 1.1.)

Pour convertir des projets Struts 1.0.2 en projets Struts 1.1, procédez comme suit :
  1. Chargez les projets Struts 1.0.2 dans un environnement Rational Application Developer version 6.0.
  2. Créez un projet Web Struts 1.1 appelé Struts11, par exemple. Vous créez ce projet temporaire pour accéder facilement aux fichiers d'exécution Struts 1.1 dont vous avez besoin pour convertir les projets réels. Vous pourrez supprimer ce projet lorsque vous aurez terminé.
  3. Effectuez les opérations ci-dessous pour chaque projet Struts 1.0.2 à convertir vers Struts 1.1
    1. Supprimez les fichiers .JAR struts stockés dans le répertoire Web Content/WEB-INF/lib du projet.
    2. Copiez les fichiers JAR suivants du répertoire Struts11/WebContent/WEB-INF/lib dans le répertoire Web Content/WEB-INF/lib :
      • commons-*.jar.
      • struts.jar.
      • jarkarta-oro.jar.
    3. Supprimez les fichiers TLD (Tag Library Descriptor) suivants du répertoire Web Content/WEB-INF du projet : struts-*.tld.
    4. Copiez les fichiers suivants du répertoire Struts11/WebContent/WEB-INF dans le répertoire du projet Web Content/WEB-INF : struts-*.tld.
Concepts associés
Compatibilité avec WebSphere Studio V5.1.x
Référence associée
Modifications apportés au débogueur dans la version 6.0
Migration WDO vers SDO
Mots réservés dans V6.0
Commentaires
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.