Exécution de votre script Ant

Après avoir enregistré les paramètres de votre bean J2C et de vos classes de liaison de données dans un fichier Ant, vous pouvez exécuter ce script Ant séparément.

Avant de commencer

Vous devez sélectionner l'option de sauvegarde des paramètres dans un script Ant dans l'assistant de création de bean J2C.
Important : L'option Sauvegarder la session en tant que script Ant n'est pas utilisable pour les applications MFS.

Procédure

  1. Cliquez avec le bouton droit sur le script Ant à exécuter et sélectionnez Exécuter en tant que > Configurations d'outils externes... .
  2. Dans la fenêtre des attributs de lancement, ouvrez l'onglet JRE et sélectionnez Exécuter dans le même environnement JRE que l'espace de travail. Cliquez sur Appliquer, puis sur Exécuter.
    Remarque : Vous devez définir le JRE uniquement lors de la première exécution du script Ant. Pour les exécutions suivantes, vous n'aurez qu'à faire un clic droit sur le fichier Ant et à sélectionner Exécuter en tant que > Génération Ant.

Exemple

Exécution du script Ant à partir de la ligne de commande

Une fois générés ou modifiés, vos scripts Ant peuvent être exécutés sans lancer l'environnement IDE : il s'agit du mode Headless. Pour exécuter le script Ant, il suffit d'appeler l'application antRunner, en ajoutant le fichier Ant en tant qu'argument.

  1. Créez un fichier de traitement par lots simple, Test.bat, pour exécuter le script Ant généré en mode sans interface graphique (ou bien utilisez l'exemple qui se trouve dans ../IBM/IBMIMShared/plugins/com.ibm.j2c.cheatsheet.content) :
    echo off
    setlocal
    
    set ECLIPSE=d:\IBM\SDP75
    set WORKSPACE=d:\WorkspaceANT
    set BUILDFILE=d:\INPUTMSG.xml
    
    
    set JAVA_HOME=%ECLIPSE%\jdk\jre
    set PATH=%JAVA_HOME%\bin;%PATH%
    set CLASSPATH=%JAVA_HOME%\lib;%CLASSPATH%
    set EQUINOXJAR=%ECLIPSE%\plugins\org.eclipse.equinox.launcher_1.0.100.v20080509-1800.jar
    
    java  -showversion -Xms50M -Xmx350M -XX:MaxPermSize=128m -cp "%EQUINOXJAR%" 
    
    org.eclipse.core.launcher.Main  -data %WORKSPACE%  -application org.eclipse.ant.core.antRunner -
    
    buildfile %BUILDFILE%

    Linux: Créez un fichier antgenerate.sh (ou utilisez l'exemple qui se trouve dans ../IBM/IBMIMShared/plugins/com.ibm.j2c.cheatsheet.content) :

    #!/bin/bash
    ECLIPSE="/opt/IBM/SDP/"
    WORKSPACE="/home/temp/workspace/ant"
    BUILDFILE="/home/temp/antscript/Customer.xml"
    JAVA_HOME="$ECLIPSE/jdk"
    JAVA="$JAVA_HOME/jre/bin/java"
    EQUINOXJAR="$ECLIPSE/plugins/org.eclipse.equinox.launcher_1.1.0.v20100507.jar"
    
    PATH="$PATH:$JAVA_HOME/bin"
    export PATH
    CLASSPATH="$CLASSPATH:$JAVA_HOME/lib"
    export CLASSPATH
    "$JAVA" -cp "$EQUINOXJAR" org.eclipse.core.launcher.Main -os linux -ws gtk -data "$WORKSPACE" -application org.eclipse.ant.core.antRunner -buildfile "$BUILDFILE"
    où :
    • la variable d'environnement ECLIPSE définit le chemin vers le dossier eclipse au sein de RAD
    • WORKSPACE définit l'emplacement où l'espace de travail est créé
    • BUILDFILE définit l'emplacement du script Ant à exécuter.

    Assurez-vous de l'existence du fichier JAR contenant le package org.eclipse.equinox.launcher.

    Vous pouvez modifier les variables du fichier de traitement par lots en fonction de votre environnement :

    • Remplacez ECLIPSE par votre racine eclipse
    • Remplacez WORKSPACE par le nom et l'emplacement de votre espace de travail
    • Remplacez BUILDFILE par votre script Ant J2C
  2. Ouvrez une fenêtre de commande et appelez Test.bat à partir de la ligne de commande.
  3. Une fois que Test.bat a été exécuté correctement, vous pouvez ouvrir votre espace de travail. Vous constaterez que tous les fichiers de projet et de liaison de données ont été créés.

Que faire ensuite

Limitation connue du script Ant : Impossible de localiser RAR
Si le projet de connecteur est déjà créé dans votre espace de travail pour un adaptateur de ressources donné, lorsque vous utilisez l'assistant Bean Java™ J2C, l'adaptateur de ressources n'est pas réimporté. Lors de la génération du script Ant, celui-ci n'a aucun moyen de retrouver l'emplacement de l'adaptateur de ressources, puisque le projet de connecteur ne fournit pas cette information. Si la valeur ra.file est cannotlocaterar, vous devez ajouter manuellement l'emplacement de l'adaptateur de ressources au script Ant généré pour le bean Java J2C. Il s'agit d'une limitation connue. Votre fichier Ant contient la ligne : property name="ra.file" value="Cannot Locate RAR "
<target name="Init1">
        <property name="debug" value="true"/>
        <property name="project1" value="Test"/>
        <property name="j2c.runtime" value="WebSphere Application Server v7.0"/>
        <property name="ra.project" value="cicseci7102"/>
        <property name="ra.runtime" value="WebSphere Application Server v7.0"/>
        <property name="ra.file" value="Cannot Locate RAR "/>
    </target>
Limitation connue du script Ant : Impossible de localiser RAR
Si vous exécutez le script Ant depuis la ligne de commande et que vous devez importer l'adaptateur de ressources dans l'espace de travail, vous pouvez recevoir l'erreur suivante :
importResourceAdapter1: 
[j2c:importResourceAdapter] Création d'un projet de connecteur cicseci6022 ...terminée 

J2CBeanGeneration1: 
[j2c:generateService] Génération de service: 
[j2c:generateService] Le registre a renvoyé le descripteur d'adaptateur de ressources : null 
[j2c:generateService] Attendez le traitement du registre de l'adaptateur de ressources... 
[j2c:generateService] Terminé en 120 secondes. 
[j2c:generateService] Le registre a renvoyé le descripteur d'adaptateur de ressources : null 
[j2c:generateService] Impossible d'extraire un adaptateur de ressources pour le projet : cicseci 
6022 
[j2c:generateService] Génération de service... échec 
LA GENERATION A ABOUTI 
La raison en est que le système dépasse le délai d'attente lors de l'importation de l'adaptateur de ressources.

Solutions de contournement

Choisissez l'une de ces méthodes pour résoudre ce problème :
  • Réexécutez le script Ant sur la ligne de commande et le script s'exécute correctement.
  • Créez un espace de travail, créez un projet d'adaptateur de ressources et importez d'abord l'adaptateur de ressources, puis exécutez le script Ant.

Commentaires