Vous pouvez utiliser une ligne de commande pour migrer des programmes de WebSphere Studio
Application Developer Integration Edition vers les outils applicatifsRational.
Procédure
- Placez-vous dans le répertoire comprenant les fichiers J2CMigration.bat et J2CMigration.sh :
: 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.
: 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.
- Vous devez modifier J2CMigration.bat ou J2CMigration.sh
- 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.
ECLIPSE_ROOT= <rép_install> , où vous définissez l'emplacement du répertoire en fonction de votre
environnement.
SET ECLIPSE_ROOT=/opt/<rép_install>
JDK_HOME : emplacement du fichier java.exe.
Le chemin par défaut est %ECLIPSE_ROOT%\jdk\jre\bin
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.
SET RARVARPATH=%ECLIPSE_ROOT%/ResourceAdapters.
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.
SET WASRUNTIME=%ECLIPSE_ROOT%/runtimes
SET WASRUNTIME=%ECLIPSE_ROOT%/runtimes
EQUINOXJAR : emplacement du fichier jar org.eclipse.core.Launcher.Main
SET EQUINOXJAR=%ECLIPSE_ROOT%\plugins\org.eclipse.equinox.launcher_1.0.101.R34x_v20081125.jar
SET 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.
- Sauvegardez puis fermez le fichier. Exécutez J2CMigration.bat ou J2CMigration.sh à partir du
répertoire J2CMigration du dossier d'installation de votre produit.
- 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 :
- [-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 :
- [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 :
- fichier d'interface Java
- fichier proxy (implémentation) Java
- fichier de liaison de données Java
- fichier MigrationReport.xml (le récapitulatif de la migration sera enregistré sous
le répertoire existant).

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 :
- 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:\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 :
- fichier d'interface Java
- fichier proxy (implémentation) Java
- fichiers de liaison de données Java
- bean de commande
- fichier j2cmigration_timestamp.xml (le récapitulatif de la migration sera enregistré sous
le répertoire existant).

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.