Migration de programmes J2C avec une ligne de commande

Vous pouvez utiliser une ligne de commande pour migrer des programmes de WebSphere Studio Application Developer Integration Edition vers les outils applicatifsRational.

Procédure

  1. Placez-vous dans le répertoire comprenant les fichiers J2CMigration.bat et J2CMigration.sh :
    • icône Windows : le répertoire d'installation par défaut pour l'outil de migration J2C est lecteur_système: <rép_install>\plugins\com.ibm.j2c.migration.wsadie_7.2.0.vxxx.
    • icône Linux : le répertoire d'installation par défaut pour l'outil de migration J2C est : <rép_install>\plugins\com.ibm.j2c.migration.wsadie_7.2.0.vxxx.
  2. Vous devez modifier J2CMigration.bat ou J2CMigration.sh
    1. Localisez l'emplacement où vous avez défini les variables dans le fichier :
      ECLIPSE_ROOT : emplacement des fichiers eclipse.exe et eclipse.ini. La valeur par défaut sera <rép_install> pour les produits de développement d'applications Rational.
      • icône Windows ECLIPSE_ROOT= <rép_install> , où vous définissez l'emplacement du répertoire en fonction de votre environnement.
      • icône Linux SET ECLIPSE_ROOT=/opt/<rép_install>
      JDK_HOME : emplacement du fichier java.exe.
      • icône Windows Le chemin par défaut est %ECLIPSE_ROOT%\jdk\jre\bin
      • icône Linux SET JDK_HOME=%ECLIPSE_ROOT%/jdk/jre/bin
      .
       rarsPathVar : chemin du dossier des adaptateurs de ressources. Vous pouvez déterminer le chemin exact en ouvrant le fichier <chemin_install>configuration/config.ini et en y recherchant l'entrée rarsPathVar.
      • icône Windows SET RARVARPATH=%ECLIPSE_ROOT%/ResourceAdapters.
      • icône Linux SET RARVARPATH=%ECLIPSE_ROOT%/ResourceAdapters
      was.runtime : emplacement du dossier d'exécution WAS. Vous pouvez déterminer le chemin exact en ouvrant le fichier <chemin_install>configuration/config.ini et en y recherchant l'entrée rarsPathVar.
      • icône Windows SET WASRUNTIME=%ECLIPSE_ROOT%/runtimes
      • icône LinuxSET WASRUNTIME=%ECLIPSE_ROOT%/runtimes
      EQUINOXJAR : emplacement du fichier jar org.eclipse.core.Launcher.Main
      • Icône Windows SET EQUINOXJAR=%ECLIPSE_ROOT%\plugins\org.eclipse.equinox.launcher_1.0.101.R34x_v20081125.jar
      • Icône LinuxSET EQUINOXJAR=%ECLIPSE_ROOT%/plugins/org.eclipse.equinox.launcher_1.0.101.R34x_v20081125.jar
      • L'espace de travail par défaut %WORKSPACE% recevra pour valeur %WORKSPACE%%ECLIPSE_ROOT%\workspace\Migration1 ou %ECLIPSE_ROOT%\workspace\Migration1 dans le fichier batch de migration ou le script de shell.
  3. Sauvegardez puis fermez le fichier. Exécutez J2CMigration.bat ou J2CMigration.sh à partir du répertoire J2CMigration du dossier d'installation de votre produit.
  4. Entrez la commande et l'option appropriées comme décrit dans les tableaux ci-dessous :
    Tableau 1. Commandes d'exécution de l'outil J2C Migration
    Commande Windows Commande Linux Description
    J2CMigration.bat [options] ./J2CMigration.sh [options] Utilisez cette commande pour démarrer l'outil J2C Migration en suivant l'un des deux patterns :
    Syntaxe :
    • J2CMigration.bat -w wsdlsource -d workspace [-p project] [-t type] [-o option] [-s summary]
    • J2CMigration.bat -f migrationinputfile
    J2CMigration [options]   Options
    • -w wsdlsource : chemin complet du fichier WSDL du service ou chemin complet du dossier contenant un ou plusieurs fichiers WSDL du service.
    • -f migrationinputfile : fichier de migration contenant les options ci-dessus à intégrer dans l'outil de migration effectuée avec une ligne de commande. Utilisez cette méthode lorsque vos options de ligne de commande dépassent la longueur maximum autorisée. Voir SampleMigration.txt Fichier d'entrée de migration d'exemple pour référence.
    • -d workspace : espace de travail dans lequel la sortie est générée.
    • [-p project] : nom du projet dans lequel les artefacts migrés seront construits. Ne pas entrer de chemin mais simplement un nom. Vous pouvez définir un projet web, Java™ ou EJB à créer. Si aucun projet n'est défini, un projet Java sera créé par défaut. Si vous ne définissez pas cette option -p option, les artefacts migrés seront alors créés dans le projet défini dans le fichier WSDL.
    • [-t type] : type de projet du projet de sortie :
      • WEB
      • EJB
      • JAVA
    • [-o option]
      • databindingonly : cette option doit être définie si vous souhaitez uniquement créer des beans de liaison de données pendant la migration. Si vous définissez cette option, l'option commandbean sera ignorée.
      • commandbean : cette option doit être définie si vous souhaitez créer un bean de commande.
    • [-s summary] : nom du fichier du récapitulatif de la migration (sans .xml). Si aucun fichier n'est défini, le fichier par défaut du récapitulatif sera j2cmigration_timestamp.xml. Si le fichier du récapitulatif existe déjà, le récapitulatif sera écrit dans le fichier summary_timestamp.xml. Si vous définissez un emplacement comme par exemple d:\summaryFolder\summary, un dossier récapitulatif doit exister. Si vous ne définissez pas d'emplacement, le récapitulatif sera créé dans le répertoire existant.
    • [cicsver] : version de l'adaptateur de ressources CICs que vous utilisez dans votre projet migré. Par exemple, 6.1.0.2. Si aucune version d'adaptateur de ressources CICs n'est spécifiée, l'application en localise une dans le registre.
    • [imsver] : version de l'adaptateur de ressources IMS que vous utilisez dans votre projet migré. Par exemple, 9.1.0.2.5a. Si aucune version d'adaptateur de ressources IMS n'est spécifiée, l'application en localise une dans le registre.
    • [wasver] : version de WebSphere Application Server que vous utilisez dans votre projet migré. Si aucune n'est spécifiée, la version par défaut est la 7.0. Les valeurs admises sont les suivantes :
      • was.base.v61
      • was.base.v7
    • [cicsrar] : chemin complet du fichier archive contenant l'adaptateur de ressources CICs. Par exemple : d:\IBM\sdp75\ResourceAdapters\cicseci6102.rar.
    • [imsrar] : chemin complet du fichier archive contenant l'adaptateur de ressources IMS. Par exemple : d:\IBM\sdp75\ResourceAdapters\imsico91025.rar.
    • [suffix] : impl, proxy ou tout autre suffixe que vous souhaitez utiliser pour votre implémentation J2C. Si cette option n'est pas spécifiée, le suffixe de l'implémentation est proxy.

Exemple

Exemples de migration à l'aide d'une ligne de commande

J2CMigration.bat -d "d:\myworkspace" -w "d:\mywsdl.wsdl" -p "OutputProject"
./J2CMigration.sh -d /home/myworkspace -w /home/mywsdl.wsdl -p OutputProject
Cette ligne de commande va faire migrer un seul service comme défini dans d:\myservicewsd.wsdl. Les artefacts migrés sont générés dans un projet Java avec le nom de projet "Output Project" dans l'espace de travail d:\myworkspace. Les fichiers créés sont les suivants :
  • fichier d'interface Java
  • fichier proxy (implémentation) Java
  • fichier de liaison de données Java
  • fichier j2cmigration_timestamp.xml (le récapitulatif de la migration sera enregistré sous le répertoire existant).
J2CMigration.bat  -w "d:\mywsdlFolder" -p "OutputProject" -s "MigrationReport"
./J2CMigration.sh -w /home/mywsdlFolder -p OutputProject -s /home/myworkspce/MigrationReport

Cette ligne de commande va faire migrer tous les services du dossier d:\myservicewsdlfolder ou de tout autre sous-dossier de d:\myservicewsdlfolder. Les artefacts migrés (pour tous les services) sont générés dans un seul projet Java avec le nom de projet "OutputProject". Les fichiers créés sont les suivants :

J2CMigration.bat -w "d:\myfolder" -o databindingonly
./J2CMigration.sh -w /home/myfolder -o databindingonly

Cette ligne de commande va faire migrer tous les services du dossier d:\myfolder ou de tout autre sous-dossier de d:\myfolder. Les fichiers créés sont les suivants :

J2CMigration.bat -w "d:\myfolder" -o commandbean -t EJB
./J2CMigration.sh -w /home/myfolder -o commandbean -t EJB

Cette ligne de commande va faire migrer tous les services du dossier d:\myfolder ou de tout autre sous-dossier de d:\myfolder. Les artefacts migrés sont créés dans les projets EJB avec les noms de projet tirés des définitions WSDL . Les fichiers et artefacts créés sont les suivants :

J2CMigration.bat -f "d:\SampleMigration.txt"
./J2CMigration.sh  -f /home/SampleMigration.txt"

Effectuez la migration en fonction des options définies dans le fichier en entrée de la migration.


Commentaires