Rational Developer for System z, Version 7.6

J2EE-ANT-Build-Script

Das J2EE-ANT-Build-Script ist vom Typ J2EEBLD und ist der Sprache J2EEANT zugeordnet. Der Name kann ein beliebiger Name mit bis zu acht Zeichen sein. Die Variablen werden im Sprachformat mit Tags definiert. Die Build-Scripts für JAR, WAR und EAR ähneln sich sehr stark. Die nachfolgend dargestellte Syntax ist die eines WAR-Build-Scripts. Die Variablen für JAR- und EAR-Build-Scripts sind gleich, nur dass EAR_NAME und JAR_NAME an Stelle von WAR_NAME verwendet wird.

<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"/>                                
                                                                  
<!-- Name der von diesem Prozess zu erstellenden WAR-Datei -->        
<!-- Suffix .war einschließen                              -->        
<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>

Die SCLM-Build-Scripts setzen benutzerdefinierte Variablen bei der Buildanforderung automatisch außer Kraft, wenn das ANT-Build-Script ausgeführt wird. Diese Variablen sind auf folgende Werte gesetzt:

Variable Wert
J2EE Project type Typ des zu erstellenden Java/J2EE-Projekts. Dies ist ein temporärer Projektname, der im Build-Script festgelegt und von ANT während des Build verwendet wird. Der Typ kann mit folgenden Werten angegeben werden:
  • J2EE EAR Project
  • J2EE WAR Project
  • J2EE EJB Project
  • JAVA Project
Diese Variable muss nicht angepasst werden.
ARCHDEF name Name der ARCHDEF für den ARCHDEF-Build
ANTXML name Name der für den Build zu verwendenden Skeleton-Ant-XML
Include Buildmap Mögliche Werte sind 'Yes' und 'No'. Ist die Eigenschaft auf 'Yes' gesetzt, wird die SCLM-Buildzuordnung in das Verzeichnis MANIFEST der JAR, WAR oder EAR aufgenommen. Stellt das Prüfprotokoll und die Buildzuordnung für die einbezogenen Abschnitte bereit
Include Java™ Source Mögliche Werte sind 'Yes' und 'No'. Ist die Eigenschaft auf 'Yes' gesetzt, wird der Java-Quellcode in die JAR, WAR oder EAR aufgenommen.
Classpath Directory location Das für die Auflösung der Klassenpfadabhängigkeiten während des Builds verwendete z/OS UNIX® System Services-Klassenpfadverzeichnis. Alle in diesem Verzeichnis enthaltenen JARs werden im Klassenpfad verwendet.
Jar/class filenames Namen der einzelnen JAR-Dateien und Klassendateien für den Build. Diese Eigenschaft kann die Form einer Liste haben:
<property name="CLASSPATH_JARS_FILES" value="V2J4.jar,V2J3.jar" />
Codepage ASCII- oder EBCDIC-Codepage für JAVA. In dieser Codepage wird die JAVA-Quelle auf dem z/OS-Host gespeichert. Beispiel:
  • Für ASCII wird die JAVA-Codepage auf ISO8859-1 gesetzt.
  • Für EBCDIC wird die JAVA-Codepage auf IBM-1047 gesetzt.
EAR_NAME/WAR_NAME/JAR_NAME Name der erstellten EAR, WAR oder JAR

CLASSPATH-Abhängigkeiten

Im Normalfall können Klassenpfadabhängigkeiten des Java-Quellcodes in einer ARCHDEF von anderen Java-Bibliotheken oder -Klassen bestehen. Falls es sich um Abhängigkeiten von Java-Komponenten handelt, die in derselben ARCHDEF-Struktur enthalten sind, werden die Klassenpfadabhängigkeiten im Rahmen des ARCHDEF-Builds (sowohl beim bedingten als auch beim erzwungenen Build) aufgelöst.

Eine J2EE-ARCHDEF-Komponente kann jedoch von externen JARs oder Membern in anderen ARCHDEFs abhängen. In diesem Fall kann das der ARCHDEF zugeordnete J2EE-Build-Script die Klassenpfadabhängigkeiten mit den folgenden Schlüsselwörtern steuern:
CLASSPATH_JARS
Dies ist der Name eines Verzeichnisses im z/OS UNIX System Services-Dateisystem, das alle externen abhängigen JAR-Dateien und/oder Klassen für diesen speziellen ARCHDEF-Build enthalten kann.
Sie können die Team-Funktion JAR-Dateien hochladen ausführen, um JAR-Dateien vom Client in das Klassenpfadverzeichnis zu kopieren und das Verzeichnis so zu aktualisieren. Außerdem steht die Funktion Datei von SCLM in den Klassenpfad kopieren zur Verfügung, mit der Sie in SCLM gespeicherte JAR-Dateien in das Klassenpfadverzeichnis kopieren können.
Anmerkung: Dieses Schlüsselwort gibt nur ein einzelnes Verzeichnis an. Falls Sie in dieses Verzeichnis verschiedene Dateien stellen müssen, die ursprünglich denselben Dateinamen haben, müssen Sie mindestens eine dieser Dateien umbenennen, bevor oder nachdem Sie sie in das Verzeichnis gestellt haben, um zu verhindern, dass Dateien mit demselben Namen überschrieben werden.
CLASSPATH_JARS_FILES
Mit diesem Schlüsselwort können gezielt einzelne JAR-Dateien oder Klassendateien für den Klassenpfad ausgewählt werden. Wenn dieses Schlüsselwort verwendet wird, werden die aufgelisteten JAR-Dateien/Klassendateien vom SCLM-Typ J2EEJAR abgerufen. Befinden sich die Dateien nicht in SCLM, wird das von CLASSPATH_JARS referenzierte Verzeichnis durchsucht, um die Dateien abzurufen. Bei Verwendung dieses Schlüsselworts werden nur die hier aufgelisteten Dateien im Klassenpfad verwendet.

J2EE-Beispiel-Build-Scripts

Die nachfolgend aufgeführten Abschnitte enthalten Beispiele für Build-Scripts, die mit dem SCLM Developer Toolkit beim Hinzufügen eines Projekts zu SCLM generiert wurden. Sie müssen diese Scripts nicht ändern, können Sie jedoch bei Bedarf modifizieren.

Nutzungsbedingungen | Feedback

Dieses Information Center basiert auf Eclipse-Technologie. (http://www.eclipse.org)