Rational Developer for System z, version 7.6

Script de génération ANT J2EE

Le format du script de génération ANT J2EE a le type J2EEBLD et le langage J2EEANT. Il peut s'agir d'un nom comportant jusqu'à 8 caractères dont les variables sont définies dans un format de langage balisé. Les scripts de génération des fichiers JAR, WAR et EAR sont très similaires. Un exemple de syntaxe de script de génération WAR est indiqué ci-dessous. Pour les fichiers JAR et EAR, les variables des scripts de génération sont identiques, à l'exception de WAR_NAME que vous devez remplacer par EAR_NAME et JAR_NAME.

<ANTXML>                                                          

<project name="J2EE Project type" default="web-war" basedir=".">      
<property name="env" environment="env" value="env"/>              
<property name="SCLM_ARCHDEF" value="ARCHDEF name"/>                    
<property name="SCLM_ANTXML" value="ANTXML name"/>                    
<property name="SCLM_BLDMAP" value="Include Buildmap"/> 
<property name="JAVA_SOURCE" value="Include Java Source"/>                       
<property name="J2EE_HOME" value="${env.J2EE_HOME}"/>             
<property name="JAVA_HOME" value="${env.JAVA_HOME}"/>             
<property name="CLASSPATH_JARS" value="Classpath Directory location"/>
<property name="CLASSPATH_JARS_FILES" value="Jar/class filenames"/>   
<property name="ENCODING" value="Codepage"/>                                
                                                                  
<!-- WAR file name to be created by this build process -->        
<!-- include suffix of .war                            -->        
<property name="WAR_NAME" value="War name" />             
                                                                  
<path id="build.class.path">                                      
 <pathelement location="."/>                                      
 <pathelement location="${J2EE_HOME}/lib/j2ee.jar"/>              
 <pathelement location="${CLASSPATH_JARS}/jdom.jar"/>             
 <fileset dir="." includes="**/*.jar"/>                           
 <fileset dir="${CLASSPATH_JARS}" includes="**/*.jar, **/*.zip"/> 
</path>                                                           
                                                                 
</ANTXML>

Les scripts de génération SCLM remplaceront les variables définies par le client de manière dynamique lors de l'exécution du script de génération ANT. Ces variables prennent les valeurs suivantes :

Variable Valeur
J2EE Project name Type de projet Java/J2EE généré. Ce nom de projet temporaire est défini dans le script de génération pour que l'utilitaire ANT puisse l'utiliser pendant la génération. Les valeurs attribuées sont :
  • J2EE EAR Project
  • J2EE WAR Project
  • J2EE EJB Project
  • Projet JAVA
Cette variable ne doit pas être personnalisée
ARCHDEF name Nom de l'ARCHDEF ou de l'ARCHDEF générée
ANTXML name Nom du squelette XML Ant à utiliser pour la génération
Include Buildmap Valeur : Yes ou No. Si la valeur est Yes, incluez la mappe de génération SCLM dans le répertoire MANIFEST dans JAR, WAR ou EAR. Fournit l'audit et la mappe de génération des composants inclus.
Inclure la source Java™ Valeur : Yes ou No. Si la valeur est Yes, incluez le source Java dans JAR, WAR ou EAR.
Classpath Directory location Répertoire de chemin de classes z/OS UNIX® System Services utilisé pour résoudre les dépendances de chemin de classes lors de la génération. Tous les fichiers jar situés dans ce répertoire seront utilisés dans le chemin de classe.
Jar/class filenames Noms des fichiers classe et JAR à inclure individuellement dans la génération. Ils peuvent être présentés sous forme de liste :
<property name="CLASSPATH_JARS_FILES"
value="V2J4.jar,V2J3.jar" />
Codepage Page de codes ASCII ou EBCDIC pour JAVA. Il s'agit de la source JAVA de la page de codes enregistrée sur l'hôte z/OS. Par exemple :
  • Pour le format ASCII JAVA, la page de codes a la valeur ISO8859-1
  • Pour le format EBCDIC JAVA, la page de codes a la valeur IBM-1047
Nom_Ear/ Nom_War/ Nom_Jar Nom du fichier EAR, WAR ou JAR généré

Dépendances CLASSPATH

En règle générale, la source Java dans une ARCHDEF peut comporter des dépendances de chemin de classes sur d'autres bibliothèques ou fichiers classe Java. Si ces dépendances sont situées sur des composants Java contenus dans la même structure d'ARCHDEF, elles sont résolues lors de la génération d'ARCHDEF (en mode conditionnel ou forcé).

Toutefois, un composant d'ARCHDEF J2EE peut comporter des dépendances de chemin de classe sur des fichiers JAR externes ou des membres contenus dans d'autres ARCHDEF. Dans ce cas, le script de génération J2EE associé à l'ARCHDEF peut contrôler les dépendances de chemin de classes à l'aide des mots clés suivants :
CLASSPATH_JARS
Il s'agit du nom de répertoire dans le système de fichiers z/OS Unix System services susceptible de contenir tous les fichiers JAR dépendants externes et/ou les fichiers classe de cette génération d'ARCHDEF.
Ce répertoire peut être mis à jour avec les fichiers CLASSPATH via la fonction d'équipe client Charger les fichiers JAR qui permet de copier les fichiers JAR du client dans le répertoire classpath. La fonction Copier le fichier de SCLM vers le classpath qui permet de copier les fichiers JAR enregistrés dans SCLM dans le répertoire classpath est également disponible.
Remarque : Ce mot clé signale seulement un répertoire unique. Par conséquent, si vous devez placer différents fichiers ayant le même nom d'origine dans ce répertoire, vous devez renommer au moins l'un des fichiers avant ou après son placement dans le répertoire afin d'éviter d'écraser fichier du même nom.
CLASSPATH_JARS_FILES
Ce mot clé peut être utilisé pour sélectionner séparément des fichiers classe ou JAR à utiliser dans le classpath. Si ce mot clé est utilisé, les fichiers de classe/JAR répertoriés sont extraits de SCLM, du type J2EEJAR, ou s'ils ne sont pas dans SCLM, le répertoire référencé par la variable CLASSPATH_JARS est recherché pour être extrait. Si ce mot clé est utilisé, seuls ces fichiers répertoriés sont utilisés dans le classpath.

Exemples de scripts de génération J2EE

Les rubriques suivantes fournissent des exemples de scripts de génération. Ils ont été générés par SCLM Developer Toolkit au cours de l'ajout d'un projet à SCLM. Ils ne nécessitent pas de modifications, mais vous pouvez cependant le modifier si vous le souhaitez.

Conditions d'utilisation | Commentaires en retour

Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)