Schulung

„Ant im Detail“
© 2008 - 2009 Jörn Dinkla

    joern@dinkla.com

 http://www.dinkla.com

     © 2008 - 2009 Jörn...
Vorstellung
•   Dipl.-Inform. Jörn Dinkla
•   Schwerpunkte
     • Java Entwicklung (J2SE, JEE)
     • Moderne Programmiers...
Überblick



© 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
Überblick
•   Einführung und Kennenlernen
•   Überblick über Build-Prozesse
•   Ant-Grundkurs
     • Java-Projekt zum Kenn...
Build-Prozesse und -Tools



        © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
Was ist ein Build-Prozess ?
•   Von den Artifakten zum installierten Produkt
•   Graph mit Abhängigkeiten (DAG)
•   Workfl...
Automatisierung von Build-Prozessen
•   Warum ?
     • Zeitersparnis
     • Es gibt bessere Dinge zu tun
     • Sicherheit...
Automatisierung von Build-Prozessen
•   Wann ?
     • hängt vom Prozess und der Situation ab
           • Zeitdauer
      ...
Das Ideal: CRISP
•   CRISP-Builds
     • vollständig („complete“)
           • von Grund auf neu erstellt
           • kei...
Build-Tools
•   Sind „Programmiersprachen“ für
     • die Erstellung
     • und die Ausführung von Build-Prozessen

•   Di...
Make
•   Tool aus der Unix-Welt
•   Ursprünglich für die Entwicklung in C
•   Transformationen von Dateien mit externen Pr...
Maven
•   Ist wie Ant ein Apache-Projekt
•   „Project management and comprehension tool“
      • „comprehension“ = Begreif...
Ant
•   Apache Ant (http://ant.apache.org/)
•   Quasi-Standard in der Java-Welt
•   Basiert auf abstrakter Sicht
     • Ta...
Möglichkeiten mit Ant
•   Grundsatz: „Alles, was auf der JVM läuft, läuft mit Ant.“
•   Vielzahl an Möglichkeiten mit Ant
...
Möglichkeiten: Archive
•   Ant kann folgende Formate erstellen und lesen
     • Zip
     • Tar
     • Jar, War, Ear
     •...
Möglichkeiten: Dateien
•   Operationen für Dateien und Verzeichnisse
     • Anlegen, Löschen, Kopieren, Bewegen, Umbenenne...
Möglichkeiten: Java
•   Kompilieren
     • Sun, Jikes, MS, Kopi, GCJ, Symantec
•   Jar, War und Ear-Archive erstellen
    ...
Möglichkeiten: Netzwerk
•   Ant kann die meisten Netzwerkprotokolle.
     • Zugriff auf Sockets
     • FTP
     • HTML Get...
Möglichkeiten: Softwareentwicklung
•   Support für „Skriptsprachen“
     • JavaScript, AWK, Groovy, Haskell, Python, Ruby,...
Möglichkeiten: Testing
•   Allgemein
     • JUnit („ist integriert“), 3.8 vs. 4.0
     • Cobertura (Testabdeckung)
     • ...
Möglichkeiten: Prozesse
•   Prozesskontrolle
     • Externe Prozesse
           • Aufruf von Shell-Kommandos
           • ...
Möglichkeiten: Verschiedenes
•   Datenbanken
     • Die Anbindung erfolgt über JDBC
     • SQL Statements absetzen

•   Ma...
Möglichkeiten: Versionsverwaltung
•   Versionsverwaltungen
     • CVS
     • Subversion (SVN)
     • ClearCase™
     • Con...
Möglichkeiten: XML
•   XML
     • XML Dateien erstellen
     • XML-Dateien transformieren
           • XSLT
     •   Valid...
Ant-Grundlagen



   © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
Apache Ant

 •   Ant-Dateien sind in XML geschrieben.
 •   Default: build.xml.

 
 <?xml version="1.0"?>
 
 <project name=...
Erinnerung: XML

 •   XML
      • Elemente („tags“) und Attribute
      • Starttags und Endtags, verkürzter Endtag ‚/>‘
  ...
Erinnerung: XML-Baumstruktur
•   <project name="Tutorial" default="build">

    <target name="build">

      <echo message...
Ausführen des Beispiels
• Ausführen des Skripts.
• -f gibt den Dateinamen an, Default ist: build.xml




•   Informationen...
Aufbau
•   In einem Build-File befindet sich ein Projekt
      • Projekte können andere Projekte importieren
•   Ein Proje...
Beispiel für Aufbau

 <?xml version="1.0"?>

 <project name="Tutorial" default="all">                                    P...
Abhängigkeiten
•   Targets können als Argument übergeben werden




                     © 2008 - 2009 Jörn Dinkla, http:/...
Abhängigkeiten und Ausführung
•   Abhängigkeiten sind transitiv
     • Wenn a von b abhängt und b von c,
           • dann...
Abhängigkeiten visualisieren
•   Abhängigkeiten können komplex werden
•   Tools, um Ant-Projektdateien zu visualisieren
  ...
Komplexe Abhängigkeiten
•   Abhängigkeiten können komplex werden.
•   Siehe die Build-Datei von Hibernate 3.0




        ...
Beispiel für Abhängigkeiten
    <target name="a">
        <echo>a</echo></target>
    <target name="b" depends="a">
      ...
Beispiel für Abhängigkeiten
•   $ ant c1
•   ➙ a, b, c1
•   $ ant c2
•   ➙ a, b, c2
•   $ ant c3
•   ➙ a, b, c3
•   $ ant ...
Mehr als ein Target als Argument
•   Bei mehreren Targets auf der
    Kommandozeile aufpassen !




                      ...
Abhängigkeiten und Ausführung
•   Aus historischen Gründen (Kompatibilität)
     • Mehrere Targets auf der Kommandozeile w...
Ant Grundkurs - Beispiel



       © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
Eine Beispielanwendung
•   Sehr, sehr einfache Version des „Doktors“ des Emacs-
    Editors
•   Gibt nur einen zufälligen ...
Verzeichnisstruktur
•   Die Projektstruktur
     • build.xml in der Wurzel
     • Sourcen in src
     • Tests in test
    ...
Der Build-Prozess
•   Build-Prozess für einfaches Java-Projekt.
•   Targets
     • Clean zum Saubermachen
     • Init
    ...
Verzeichnisse anlegen und löschen
•   Verzeichnisse können mit mkdir angelegt werden.
<project name="project" default="com...
Java kompilieren
•   Mit javac können Java-Dateien kompiliert werden.

    <target name="compile" depends="init">
       <...
Java ausführen
•   Zum Testen einfacher Anwendungen nützlich

•   <target name="execute" depends="compile">
      <java cl...
Im Überblick
<project name="project" default="compile">
  <target name="clean">
    <delete dir="build"/>                 ...
Redundanzen und DRY
<project name="project" default="compile">
  <target name="clean">
    <delete dir="build"/>
  </targe...
Lösung: Properties
<property name="build.dir" location="build"/>
<property name="classes.dir" value="build/classes"/>
  <t...
Properties
<property name="build.dir" location="build"/>
<property name="classes.dir" value="build/classes"/>
•   location...
JUnit-Tests
•   Wir müssen jetzt die Dateien
     in src und test kompilieren.
•   Wir benötigen die
    JUnit-Jar-Datei.
...
JUnit-Tests
•   Wir führen einen Pfad path ein.

    <property name="test.dir" value="test" />
    <path id="path.compile"...
JUnit-Tests
•   Diesen definierten Pfad benutzen wir im javac-Task mit
    refid.
    <target name="compile" depends="init...
Kompilieren in src und test
•   Wir überprüfen die Änderungen




•   Es werden drei Dateien kompiliert, richtig.

       ...
JUnit-Test-Task im Überblick
•   Den Pfad benutzen wir wieder.
    <target name="junit" depends="compile">
     <junit>
  ...
JUnit-Tests
•   Für den formatter gibt es: brief und xml.
        <formatter type="brief" usefile="false"/>
•   Batchtest ...
JUnit-Tests
•   JUnit meldet einen Fehler, Ant meldet SUCCESSFUL




•   Aber: Bugs sollen nicht ausgeliefert werden!

   ...
JUnit-Tests
•   Wir müssen dem JUnit-Task mitteilen, welches Property
    er bei einem Error oder bei einer Failure setzen...
Versagen erwünscht
•   Das ist das gewünschte Ergebnis.




                      © 2008 - 2009 Jörn Dinkla, http://www.di...
JUnit-Tests
•   Wir möchten auch einen HTML-Report des JUnit-Tests.
•   Wir benötigen ein Verzeichnis für die Dateien.
   ...
JUnit-Tests
•   Der JUnit-Prozess schreibt für jede Testklasse eine XML-
    Datei TEST-Klassenname.xml.

•   Hieraus erze...
JUnit-Tests
•   Das Testergebnis.




                        © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com   62
Dateien ignorieren
•   Wir können den BrokenDoctorTest vom JUnit-Test
    ausschließen.
•   Hierzu wird im Fileset exclude...
Der JUnit-Test ist ok
•   Es ist jetzt alles wieder ok.




                         © 2008 - 2009 Jörn Dinkla, http://www...
Erstellen einer Jar-Datei
•   Eine Jar-Datei kann mit dem Task <jar> erstellt werden
    <property name="dest.name" value=...
Dokumentation
•   Wir benötigen Dokumentation.
    <property name="doc.dir" value="doc" />
•   Wir müssen das Quellverzeic...
Dokumentation
•   Die Javadoc.




                   © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com   67
Erstellen der Distribution
•   Wir erstellen eine Zip-Datei mit Jar und Dokumentation
    <property name="dest.name" value...
Erstellen der Distribution
•   Wir machen den Task abhängig von doc und jar
    <target name="zip" depends="doc, jar">



...
Upload der Distribution
•   Mit FTP stellen wir die neueste Version zur Verfügung.

    <target name="deploy" depends="zip...
Upload der Distribution
•   Ausführen ergibt allerdings einen Fehler.




•   FTP ist ein„optionaler Task“, wir benötigen ...
Der gesamte Prozess




            © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com   72
Ant-Skripte dokumentieren
•   Ein Projekt wird im Element description erläutert.
    <project name="beispiel">
     <descr...
Ant auf der Kommandozeile



        © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
Ant auf der Kommandozeile
•   Viele IDEs unterstützen Ant
•   Aber:
     • Auch hier müssen Argumente angeben werden.
•   ...
Optionen: Informationen
•   Die folgenden Optionen sind beim Debuggen hilfreich.

      -help                -h       Hilf...
Optionen: Anpassungen
•   Die folgenden Optionen sind Anpassungen.

      -buildfile FILE        -f       Benutzt eine and...
Optionen: Anpassungen
•   Die folgenden Optionen sind weitere Anpassungen.

      -nouserlib                Ignoriert $HOM...
Installation von Ant
•   Java Software Development Kit (SDK) wird benötigt
     • Umgebungsvariable JAVA_HOME muss gesetzt...
Die Datentypen von Ant



       © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
Motivierendes Beispiel
•   Ein Blick in die Dokumentation ...




                        © 2008 - 2009 Jörn Dinkla, http:...
Unbekannte Fachbegriffe
•   Was bedeuten diese Begriffe ?
     • „patterns“
     • „directory based tasks“
     • „fileset...
Datentypen
 •   Projekt
 •   Targets
 •   Tasks
      • Parameter von Tasks
 •   Diese Parameter haben einen Datentyp.

 •...
Datatypes / Datentypen
•   Datentypen
     • Properties und PropertySets
     • Resources und Resource Collections
       ...
Properties
•   Kennen wir aus dem „Grundkurs“
•   Properties haben einen Namen und enthalten Strings.
•   Derefenzierung m...
Definieren von Properties

• Properties können gesetzt werden. Der Wert ist nicht
  änderbar.
  <property name="sprachen" v...
Definieren von Properties
•   Auch in den Properties-Dateien, können Properties in
    Definitionen verwendet werden.
    b...
Steuerung mit Properties: <available>
•   Der <available> Task setzt eine Property, wenn eine
    spezifizierte Ressource ...
Steuerung mit Properties:
•   Der <condition> Task setzt eine Property, wenn die
    angegebene Bedingung zutrifft.
•   De...
Steuerung mit Properties:
•   Bedingungen können geschachtelt werden.
•   <condition property="c2" value="Y">
     <or>
  ...
Steuerung mit Properties:
•   Ein Auswahl von „core conditions“

      <and>, <or>, <not>, <xor>                   Logisch...
PropertySet
•   Properties können zu einem PropertySet
    zusammengefasst werden
•   Seit Ant Version 1.6
•   Eher Ant-In...
Properties und Boolesche Werte
•   Ein Property kann einen Booleschen Wert darstellen.

•   Wahr sind
     •   true
     •...
Resource und Resource Collections
•   Resourcen sind „Datei-ähnliche“ Dinge
     • resource, file, javaresource, zipentry,...
Path / Pfad
•   Auch „path-like-structure“ genannt
•   Benutzt für CLASSPATH und PATH Umgebungsvariablen
•   Geordnete Lis...
Path / Pfad
•   Beispiel für einen Pfad mit einer Datei und einem
    Verzeichnis.
    <path>

     <pathelement location=...
Path / Pfad
•   Abkürzung: Wenn Pfad nur aus einer Location oder einem
    Pfad besteht.
    <path location="lib/abc.jar"/...
Path / Pfad
•   Pfade können mit Filesets definiert werden.
    <path>

     <pathelement path="lib/abc.jar:build/classes"...
Fileset
•   Ungeordnete Liste
     • wie die mathematische Menge („set“)
     • Hat ein Verzeichnis als Wurzel
           ...
Fileset - Defaultexcludes
•   Es gibt Dateien, die nicht berücksichtigt werden sollen.
     • Backup-Kopien, die Editoren ...
Fileset
•   Ein Fileset benötigt immer das Attribut dir.
    <fileset dir="web"/>
•   Alle Dateien und Unterverzeichnisse ...
TarFileSet und ZipFileSet
•   Erweiterung von Fileset für Archive.
     • Dateien in Archiven haben besondere Eigenschafte...
Filelist und Dirset
•   Werden nicht so häufig verwendet.
•   Filelist
     • Wie Fileset, aber geordnet
     • Die Elemen...
Resource Collections
•   Resource Collections
     • enthalten 0..* Ressourcen
•   Es gibt Mengentheoretische Operationen ...
Patternset
•   Ein Patternset ist ein Menge von Mustern (Strings)
     • Einschränkung eines Filesets nach dem Namen
     ...
Patternset
•   Explizite Verwendung mit patternset.
    <patternset>
     <include name="**/*.jsp"/>
     <exclude name="*...
Patternset
•   Übergabe als Attribute
     • includes, excludes, includesfile, excludesfile
•   Übergabe als Element
     ...
Selectors / Selektoren
•   Einschränkung eines Filesets nach Eigenschaften
•   Der Selektor wird auf jede Datei angewendet...
Selectors / Selektoren

  <contains>              Enthält die Datei einen best. Text
  <containsregexp>        Enthält die...
Selectors / Selektoren
•   Das folgende Beispiel enthält nur die Dateien, die
     • Mit .xml enden
     • Den Text „proje...
FileMapper
•   Abbildung
     • Von bestehenden Dateien
     • Auf neue Dateinamen
•   Benutzt z. B. in
     •   <apply>, ...
Mapper

  <chained>        Sequentielle Ausführung
  <composite>      Parallele Ausführung

  <filter>         FilterChain...
FilterSet
•   Ein FilterSet ist eine Menge von Filtern
•   Ein Filter kann Text in Dateien manipulieren
     • Suchen & Er...
Filterset
•   Folgendes Beispiel setzt die Werte ein
    <copy file="Template.txt" tofile="README.txt">
      <filterset>
...
FilterChain und FilterReader
•   In Unix und Windows gibt es die „Pipes“
      • Die Ausgabe des ersten
      • ist die Ei...
FilterChain und FilterReader
•   FilterReader werden verwendet in
     •   <concat>, <copy>, <move>, <exec>, <java>,      ...
FilterChain und FilterReader
•   Das folgende Beispiel
     • Entfernt die Kommentare,
     • Ersetzt die Tabs
     • Und ...
Argumente als Attribut und Element
•   Es gibt oft zwei Möglichkeiten Parameter anzugeben
     • Als Attribut
     • Als E...
Implizite Elemente
•   Ant beruht auf Java
     • Java ist Objekt-orientiert
     • Daher gibt es in Ant auch eine Art Ver...
Nicht mehr unbekannte Fachbegriffe
•   Was bedeuten diese Begriffe ?
     • „patterns“                                Patt...
Die Tasks von Ant



    © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
Typen von Tasks
•   Ant unterscheidet
     • Core Tasks
           • werden mitgeliefert in ant.jar
     •   Optionale Tas...
Core Tasks

 Ant-Basis            ... viele ...

 Archive              <ear>, <jar>, <signjar>, <tar>, <war>, <zip>

 Date...
Optionale Tasks

 Archive              <cab>, <ejbjar>, <rpm>

 Netzwerk             <ftp>, <rexec>, <scp>, <setproxy>, <s...
Ant-Contrib Tasks
 Ant             <antcallback>, <antfetch>, <runtarget>,
                 <relentless>

 Kontrollfluß   ...
3rd Party Tasks

 Code-Qualität        PMD, Checkstyle, Findbugs, JavaNCSS

 J(2)EE               XDoclet, versch. Applika...
Bedingte Ausführung von Tasks
•   Tasks lassen sich bedingt ausführen.


 <target name="hello" if="isHello">

     <echo m...
Tasks einbinden
•   Tasks
     • Sind Java-Klassen
     • Erben von org.apache.tools.ant.Task
     • Überschreiben der exe...
Tasks einbinden: Suche nach Jars
•   Hierzu muss die Klasse in einer Jar-Datei im CLASSPATH
    sein.
•   Ant sucht an den...
Tasks einbinden: Troubleshooting
•   Bei optionalen oder 3rd party Tasks gibt es oftmals
    mehrere notwendige Jars
     ...
Tasks einbinden: Troubleshooting
•   Beispiel der Fehlermeldung, wenn eine Jar-Datei für
    einen optionalen Task nicht i...
Tasks einbinden: Troubleshooting
•   Bei der folgenden Meldung wird JRuby vermisst.




•   Erkennbar an der ClassNotFound...
Core Tasks



 © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
Core Tasks

 Ant-Basis          ... viele ...

 Archive            <ear>, <jar>, <signjar>, <tar>, <war>, <zip>

 Dateien ...
Sequentiell und Parellel
•   Innerhalb eines Targets können Tasks sequentiell und
    parallel ausgeführt werden.
•   Dies...
Sequentiell und Parellel
•   Hier das Ergebnis. Die Prozesse 1 und 2 laufen mit
    unterschiedlicher „Geschwindigkeit“.

...
Default-Werte: <presetdef>
•   <presetdef> kann Attribute und Elemente vordefinieren.
•   Nützlich bei „parameter-intensiv...
Neue Tasks: <macrodef>
•   Mit <macrodef> können neue Tasks definiert werden.
•   <macrodef name="meins">
     <attribute ...
Neue Tasks: <macrodef>
•   Es gibt drei Argumenttypen
     • Attribute
      <attribute name="arg2" default="default" />
 ...
Neue Tasks und Datentypen
•   Mit <taskdef> können neue Tasks definiert werden.
    <taskdef name="ejbdoclet"
     classna...
Große Projeke: <antcall> und <ant>
•   Mit <antcall> können Targets aufgerufen werden.
•   Das folgende Target soll aufger...
Große Projeke: <antcall> und <ant>
•   Dieses führt zu dem abgebildeten
    Ergebnis.




•   Mit <ant> können auch Target...
Große Projeke: <import>
•   Build-Dateien können andere mit <import> importieren.
•   Dieses Statement kann überall im Dok...
Große Projeke: <import>
•   Die Datei importer.xml importiert X.
    <import file="imported.xml" />
•   Und überschreibt d...
Core Tasks: Archive
•   <tar>  und <zip> schreiben die Dateien aus einem FileSet
    in eine Tar bzw. Zip-Datei.

    <tar...
Core Tasks: Archive - Jar
•   <jar> hat ein implizites FileSet, d.h. ein
  Wurzelverzeichnis.
• Dieses wird mit dem Attrib...
Core Tasks: Archive - War
•   Eine War-Datei enthält Klassen, Webseiten, Jars, etc.
•   Diese können als FileSets spezifie...
Core Tasks: Archive - War
•   Bei Servern, die „Hot-Deployment“ unterstützen, muss die
    Datei nur in das richtige Verze...
Core Tasks: Externe Prozesse
• Mit Ant lassen sich externe Prozesse aufrufen und
  kontrollieren.
• <apply> ruft ein exter...
Core Tasks: Externe Prozesse
•   Beide können mit dem Attribute spawn vom Ant-Prozess
    losgelöst werden (ähnlich nohup ...
Core Tasks: Externe Prozesse
•   Java-Klassen und Jar-Dateien lassen <java> sich mit
    aufrufen.
•   Mit dem Attribut fo...
Optionale Tasks



   © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
Optionale Tasks

 Archive            <cab>, <ejbjar>, <rpm>

 Netzwerk           <ftp>, <rexec>, <scp>, <setproxy>, <sshex...
Optionale Tasks: SCP
•   SCP benötigt das jsch-Jar.

•   Das folgende Statement übertragt ein FileSet.

    <scp todir="${...
Optionale Tasks: XML
•   Für XML gibt es zwei Validierungsschemata:
     • DTD
     • XML-Schema

•   Für DTD gibt es den ...
Optionale Tasks: JDepend
•   JDepend erstellt Metriken der Design-Qualität
     • siehe http://clarkware.com/software/JDep...
Optionale Tasks: JDepend
•   Im zweiten Schritt wird die XML-Datei mit <xslt> in eine
    HTML-Datei umgeformt.

•   <xslt...
Optionale Tasks: JDepend
•   Hier das Ergebnis von JDepend.




                      © 2008 - 2009 Jörn Dinkla, http://ww...
Ant-Contrib Tasks



    © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
Ant-Contrib Tasks
 Ant             <antcallback>, <antfetch>, <runtarget>,
                 <relentless>

 Kontrollfluß   ...
Ant-Contrib Tasks
•   Ant-Contrib bietet eine Menge Erweiterung
     • Manche sehen diese Erweiterungen als zu „prozedural...
Ant-Contrib Tasks: <if>
•   Wir testen die Erreichbarkeit eines Servers mit <if>.
    <c:if>
      <http url="${url}"/>   ...
Ant-Contrib Tasks: <switch>
•   Mit <switch> kann man z. B. eine Mehrfachabfrage
    machen. Wir testen, welche Shell der ...
Ant-Contrib Tasks: <foreach>
•   Mit <foreach> wird ein Target für jedes Element
    aufgerufen.
    <target name="kopf">
...
Ant-Contrib Tasks: <foreach>
•   Iterieren über die Elemente eines FileSets.
    <c:foreach target="koerper" param="i">
  ...
Ant-Contrib Tasks: <for>
•   Mit <for> ist das separate Target nicht notwendig.
    <c:for list="1,2,3,4,5" param="i">
   ...
Ant-Contrib Tasks: <for>
•   Wir können auch ein FileSet benutzen.
    <c:for param="i">
      <fileset dir="." />
      <...
3rd Party Tasks



   © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
3rd Party Tasks

 Code-Qualität        PMD, Checkstyle, Findbugs, JavaNCSS

 J(2)EE               XDoclet, versch. Applika...
DbUnit
•   DbUnit ist ein Testwerkzeug für die Datenbank.
     • Testdaten werden in XML-Dateien definiert.
•   Wir benöti...
DbUnit
•   Export der DTD des Schemas.
    <dbunit driver="${driver}" url="${url}"
           userid="${user}" password="$...
DbUnit und <presetdef>
•   Lösung: Mit <presetdef> können Default-Parameter an
    einen Wrapper-Task gebunden werden.
•  ...
DbUnit und <presetdef>
•   Export der Tabelle „farbe“ mit SELECT-Statement und der
    Tabelle „osterei“.
•   <mydbunit>
 ...
XDoclet
•   XDoclet
     • Attribute-Oriented-Programming
     • wird bei der EJB 2-Entwicklung angewendet
•   XDoclet bie...
XDoclet: <ejbdoclet>
•   EJB 2-Anwendungen haben eine gewisse Redundanz an
    Interfacen. Diese sind jeweils für den Serv...
XDoclet: <ejbdoclet>
•   Der Task.
    <taskdef name="ejbdoclet"
      classname="xdoclet.modules.ejb.EjbDocletTask"
     ...
XDoclet: <ejbdoclet>
•   Wir generieren Remote-, Local- und Home-Interfaces.
•   <remoteinterface pattern="{0}"/>
     <lo...
JUnitEE
•   JUnitEE ermöglicht Unit-Tests auf dem Applikationsserver.
•   Mit <juniteewar> wird eine War-Datei erstellt, d...
JUnitEE
•   Die Tests können automatisch mit Ant ausgeführt werden.
    <junitee url="${url}" printsummary="true">
     <t...
Groovy
•   Groovy ist eine dynamische Programmiersprache.
•   Es gibt zwei Tasks für Groovy.
•   Einen zum Ausführen von G...
Groovy
•   Groovy-Programme können direkt in Ant verfasst werden.
•   <groovy>
      println "Hallo Groovy"
      int n = ...
Groovy
•   Groovy ist vollständig in
    Java integriert.
•   Groovy kann Java-Klassen
    benutzen und umgekehrt.
    <gr...
PMD
•   PMD ist ein Werkzeug zur Quellcodeanalyse.
     • Es kann mögliche Fehler, suboptimalen Code, etc. finden
     • I...
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Ant im Detail
Upcoming SlideShare
Loading in...5
×

Ant im Detail

5,364

Published on

Unterlagen für eine Schulung über das Werkzeug Ant

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
5,364
On Slideshare
0
From Embeds
0
Number of Embeds
5
Actions
Shares
0
Downloads
3
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide
  • Properties: die Konstanten, nicht Variablen, Resourcen: Ant braucht Dateien und Verzeichnisse
    PatternSet: Auswahl von Dateinamen, Selektoren: Auswahl anhand Eigenschaften
    FileMapper: Umbennen, FilterSet: SCHLECHTER NAME, Dateitransformation, FilterChain, FilterReader: SCHLECHTER NAME, Unix pipes
  • Transcript of "Ant im Detail"

    1. 1. Schulung „Ant im Detail“ © 2008 - 2009 Jörn Dinkla joern@dinkla.com http://www.dinkla.com © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
    2. 2. Vorstellung • Dipl.-Inform. Jörn Dinkla • Schwerpunkte • Java Entwicklung (J2SE, JEE) • Moderne Programmiersprachen • Groovy, Ruby, Haskell, Scala • Modellgetriebene Entwicklung • Automatisierung • Eclipse-Plugin-Entwicklung • CUDA, OpenCL • Business-Intelligence • Hobbies • Musik, Literatur © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 2
    3. 3. Überblick © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
    4. 4. Überblick • Einführung und Kennenlernen • Überblick über Build-Prozesse • Ant-Grundkurs • Java-Projekt zum Kennenlernen • Ant auf der Kommandozeile • Die Datentypen von Ant • Die Tasks von Ant • Ant und IDEs • Ant erweitern • Zwischendurch • Hands-on • Gemeinsam mit Ant entwickeln © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 4
    5. 5. Build-Prozesse und -Tools © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
    6. 6. Was ist ein Build-Prozess ? • Von den Artifakten zum installierten Produkt • Graph mit Abhängigkeiten (DAG) • Workflow UML Java XML Generieren JSP Kompilieren ... ... Fehler- Testen Reports Ausführen Installieren Packen © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 6
    7. 7. Automatisierung von Build-Prozessen • Warum ? • Zeitersparnis • Es gibt bessere Dinge zu tun • Sicherheit, da manuelle Ausführung fehleranfällig ist • „Durch Langeweile entstehen Fehler“ • Welche Prozesse ? • Daumenregel: Wenn mehr als zweimal durchgeführt • Und man diese genau genug kennt • Welche Arten ? • befehlsgesteuert • zeitgesteuert • ereignisgesteuert © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 7
    8. 8. Automatisierung von Build-Prozessen • Wann ? • hängt vom Prozess und der Situation ab • Zeitdauer • die benötigten Ressourcen • Sollten so oft wie möglich laufen • Was wird benötigt ? • Versionsverwaltung • Automatisierte Tests • Skripte (Installation, etc.) • Rückmeldung • Email, Web-Seiten, Lavalampen © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 8
    9. 9. Das Ideal: CRISP • CRISP-Builds • vollständig („complete“) • von Grund auf neu erstellt • keine manuell hinzugefügten Dateien • wiederholbar („repeatable“) • durch Versionskontrolle jederzeit konsistent • informativ („informative“) • Gesundheitszustand der Software, Tests • planbar („schedulable“) • Rund um die Uhr lauffähig -> frühe Fehlerentdeckung • portable („portable“) • Keine Abhängigkeiten an speziellen Rechner © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 9
    10. 10. Build-Tools • Sind „Programmiersprachen“ für • die Erstellung • und die Ausführung von Build-Prozessen • Die bekanntesten sind • Make • sehr alt (1977, Bell Labs) • sehr viele Varianten • Ant • Maven • MSBuild (VisualStudio) • nur Windows © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 10
    11. 11. Make • Tool aus der Unix-Welt • Ursprünglich für die Entwicklung in C • Transformationen von Dateien mit externen Programmen • Daher plattformabhängig • Tab‘s an bestimmten Stellen notwendig • Hier ein Ausschnitt aus dem Manual von GNUmake • „generiert aus *.c Datei ein Makefile *.d“ %.d: %.c @set -e; rm -f $@; $(CC) -M $(CPPFLAGS) $< > $@.$$$$; sed 's,($*).o[ :]*,1.o $@ : ,g' < $@.$$$$ > $@; rm -f $@.$$$$ • siehe http://www.gnu.org/software/make/manual/ make.html © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 11
    12. 12. Maven • Ist wie Ant ein Apache-Projekt • „Project management and comprehension tool“ • „comprehension“ = Begreifen, Erfassen, Verstehen • Maven bietet • Einheitliches Build-System • Informations-Infrastruktur • Bibliotheken, Test-Reports, Abhängigkeiten • Richtlinien für „Best Practices“ • Maven erfordert • Einhaltung der „Best practices“ und Projektstruktur • Bei Abweichungen ist viel Arbeit notwendig • Übergang von „Benutzer von Maven“ zu „Plugin- Maintainer“ kann hart und zeitintensiv sein © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 12
    13. 13. Ant • Apache Ant (http://ant.apache.org/) • Quasi-Standard in der Java-Welt • Basiert auf abstrakter Sicht • Targets, deren Abhängigkeiten • und Tasks • Pluspunkte • Einfach erweiterbar • Performant • Lebendige Community, Open Source • viele Erweiterungen • Testing integriert • in viele Entwicklungsumgebungen integriert © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 13
    14. 14. Möglichkeiten mit Ant • Grundsatz: „Alles, was auf der JVM läuft, läuft mit Ant.“ • Vielzahl an Möglichkeiten mit Ant • Archive • Datenbanken • Dateien • Java • Netzwerk • Prozesse • Softwareentwicklung • Testing • Versionsverwaltung • XML © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 14
    15. 15. Möglichkeiten: Archive • Ant kann folgende Formate erstellen und lesen • Zip • Tar • Jar, War, Ear • Rpm • Cab (Microsoft) • Komprimierungsverfahren • Gzip • Bzip2 • Jars können signiert werden © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 15
    16. 16. Möglichkeiten: Dateien • Operationen für Dateien und Verzeichnisse • Anlegen, Löschen, Kopieren, Bewegen, Umbenennen, Konkatenieren • Transformieren • String-Ersetzungen • Ersetzung mit regulären Ausdrücken • Komprimieren • Checksummen, z. B. MD5 • Zugriffsrechte, Benutzer und Gruppen • Patch © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 16
    17. 17. Möglichkeiten: Java • Kompilieren • Sun, Jikes, MS, Kopi, GCJ, Symantec • Jar, War und Ear-Archive erstellen • inkl. Erstellung von MANIFEST.MF • Java-Klassen ausführen • JUnit-Tests durchführen • HTML-Reports erstellen • Javadoc erzeugen • Verschiedenes • Dependencies (JDepend) • Apt (Annotation Processor Tool) • Rmic (Java RMI stub compiler) © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 17
    18. 18. Möglichkeiten: Netzwerk • Ant kann die meisten Netzwerkprotokolle. • Zugriff auf Sockets • FTP • HTML Get, Post • Testen: HTML-Clients für JUnit • Email • scp • Prozesse mit ssh ausführen • Rexec (remote execution) • Telnet • WebDAV © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 18
    19. 19. Möglichkeiten: Softwareentwicklung • Support für „Skriptsprachen“ • JavaScript, AWK, Groovy, Haskell, Python, Ruby, Scheme, Tcl, BeanShell, JLog, NetRexx, Scala, XSLT und viele mehr • Parsergeneratoren • ANTLR, JavaCC • Code-Qualität • Checkstyle, PMD, Findbugs, JavaNCSS • Generierung • XDoclet • J(2)EE • verschiedene Applikationsserver, Apache Tomcat • EJB2 © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 19
    20. 20. Möglichkeiten: Testing • Allgemein • JUnit („ist integriert“), 3.8 vs. 4.0 • Cobertura (Testabdeckung) • JMeter (Performance und Lasttest) • TestNG, Fitnesse • Datenbank • DbUnit (Datenbank) • Applikation Server • JUnitEE • Apache Cactus • Web • HtmlUnit, HttpUnit, Canoo Web Test • XMLUnit © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 20
    21. 21. Möglichkeiten: Prozesse • Prozesskontrolle • Externe Prozesse • Aufruf von Shell-Kommandos • Mächtig, aber nicht platformunabhängig • Java-Klassen ausführen • können Ant-Prozess überdauern • Ant-Build-Prozesse • Aufruf von anderen Ant-Build-Skripts • Import von Definitionen © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 21
    22. 22. Möglichkeiten: Verschiedenes • Datenbanken • Die Anbindung erfolgt über JDBC • SQL Statements absetzen • Management von Java-Bibliotheken • Ivy • Funktionalität ähnlich Maven © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 22
    23. 23. Möglichkeiten: Versionsverwaltung • Versionsverwaltungen • CVS • Subversion (SVN) • ClearCase™ • Continuus™ • Perforce™ • PVCS™ • StarTeam™ • VisualSourceSafe™ • CVS und Subversion sind Open Source. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 23
    24. 24. Möglichkeiten: XML • XML • XML Dateien erstellen • XML-Dateien transformieren • XSLT • Validierung • Nach DTD • Nach XML-Schema © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 24
    25. 25. Ant-Grundlagen © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
    26. 26. Apache Ant • Ant-Dateien sind in XML geschrieben. • Default: build.xml. <?xml version="1.0"?> <project name="Tutorial" Projekt default="build"> Target <target name="build"> <echo message="Hallo Welt!" /> Task <echo message="Hallo, nochmal" /> </target> Task </project> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 26
    27. 27. Erinnerung: XML • XML • Elemente („tags“) und Attribute • Starttags und Endtags, verkürzter Endtag ‚/>‘ • Hierarchie mit Baumstruktur • DOM „document object model“ • <project name="Tutorial" default="build"> <target name="build"> <echo message="Hallo Welt!" /> <echo message="Hallo, nochmal" /> </target> </project> Elemente Attribute © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 27
    28. 28. Erinnerung: XML-Baumstruktur • <project name="Tutorial" default="build"> <target name="build"> <echo message="Hallo Welt!" /> <echo message="Hallo, nochmal" /> </target> </project> project name=“Tutorial “ target name=“build echo echo message=“Hallo, Welt“ message=“Hallo, © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 28
    29. 29. Ausführen des Beispiels • Ausführen des Skripts. • -f gibt den Dateinamen an, Default ist: build.xml • Informationen: • Build-Datei, Targets, Tasks („[echo]“), Status, Dauer © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 29
    30. 30. Aufbau • In einem Build-File befindet sich ein Projekt • Projekte können andere Projekte importieren • Ein Projekt besteht aus Targets • Targets können voneinander abhängig sein • Ein Target besteht aus Tasks • Sequentielle oder parallele Abarbeitung • Ein Task wird in einer Java-Klasse implementiert. • deshalb ist Ant erweiterbar • „dynamic XML binding“ © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 30
    31. 31. Beispiel für Aufbau <?xml version="1.0"?> <project name="Tutorial" default="all"> Projekt <target name="hallo"> Target <echo message="Hallo Welt!" /> </target> Task <target name="ende"> Target <echo message="Ende Welt!" /> </target> Task <target name="all" depends="hallo, ende" /> Target </project> • Attribut default definiert Default-Target • Attribut depends definiert Abhängigkeiten © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 31
    32. 32. Abhängigkeiten • Targets können als Argument übergeben werden © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 32
    33. 33. Abhängigkeiten und Ausführung • Abhängigkeiten sind transitiv • Wenn a von b abhängt und b von c, • dann hängt a auch von c ab. • a ← b und b ← c, dann a ← c • Die Bestimmung der Reihenfolge • geschieht einmalig am Anfang • topologische Sortierung eines DAGs © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 33
    34. 34. Abhängigkeiten visualisieren • Abhängigkeiten können komplex werden • Tools, um Ant-Projektdateien zu visualisieren • Nicht editieren! • Linguine Maps • yEd © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 34
    35. 35. Komplexe Abhängigkeiten • Abhängigkeiten können komplex werden. • Siehe die Build-Datei von Hibernate 3.0 © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 35
    36. 36. Beispiel für Abhängigkeiten <target name="a"> <echo>a</echo></target> <target name="b" depends="a"> <echo>b</echo></target> <target name="c1" depends="b"> <echo>c1</echo></target> <target name="c2" depends="a,b"> <echo>c2</echo></target> <target name="c3" depends="b,a"> <echo>c3</echo></target> <target name="d" depends="c2,c1,c3"> <echo>d</echo></target> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 36
    37. 37. Beispiel für Abhängigkeiten • $ ant c1 • ➙ a, b, c1 • $ ant c2 • ➙ a, b, c2 • $ ant c3 • ➙ a, b, c3 • $ ant d • ➙ a, b, c2, c1, c3, d • Aber bei mehreren Targets: • $ ant b a • ➙ a, b, a © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 37
    38. 38. Mehr als ein Target als Argument • Bei mehreren Targets auf der Kommandozeile aufpassen ! © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 38
    39. 39. Abhängigkeiten und Ausführung • Aus historischen Gründen (Kompatibilität) • Mehrere Targets auf der Kommandozeile werden einzeln ausgeführt • Deshalb ruft •$ ant b a • zuerst b auf (erstes Argument) • Dieses hängt von a ab. • Daher wird a aufgerufen. • Dann wird b ausgeführt. • Dann kommt das zweite Argument a. • Daher wird a noch einmal aufgerufen. • Sequenz: a, b, a © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 39
    40. 40. Ant Grundkurs - Beispiel © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
    41. 41. Eine Beispielanwendung • Sehr, sehr einfache Version des „Doktors“ des Emacs- Editors • Gibt nur einen zufälligen String zurück © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 41
    42. 42. Verzeichnisstruktur • Die Projektstruktur • build.xml in der Wurzel • Sourcen in src • Tests in test • Bibliotheken in lib • Klassen in build/classes • Jar in build • Distribution in dist © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 42
    43. 43. Der Build-Prozess • Build-Prozess für einfaches Java-Projekt. • Targets • Clean zum Saubermachen • Init • Compile • Execute • JUnit • Jar • Dokumentation mit Javadoc • Packeterstellung mit zip • Deployment mit Ftp © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 43
    44. 44. Verzeichnisse anlegen und löschen • Verzeichnisse können mit mkdir angelegt werden. <project name="project" default="compile"> <target name="init"> <mkdir dir="build"/> <mkdir dir="build/classes"/> </target> • Mit delete können sie wieder entfernt werden. <target name="clean"> <delete dir="build"/> </target> </project> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 44
    45. 45. Java kompilieren • Mit javac können Java-Dateien kompiliert werden. <target name="compile" depends="init"> <javac srcdir="src" destdir="build/classes"/> </target> • Das Attribut srcdir gibt das Quellverzeichnis an. • Alle *.java Dateien werden kompiliert • Auch in Unterverzeichnissen • Das Attribut destdir gibt das Ziel für die *.class Dateien an. • Das build-Verzeichnis wird benötigt. • Deshalb abhängig von init. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 45
    46. 46. Java ausführen • Zum Testen einfacher Anwendungen nützlich • <target name="execute" depends="compile"> <java classname="beispiel.Doctor" classpath="build/classes"/> </target> • Target ist abhängig von der Kompilierung • Das Attribut classname bestimmt die Klasse, deren main()- Methode aufgerufen wird. • Das Klassenpfad wird mit classpath bestimmt. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 46
    47. 47. Im Überblick <project name="project" default="compile"> <target name="clean"> <delete dir="build"/> Säubern </target> <target name="init" depends="clean" > <mkdir dir="build"/> Verzeichnisse <mkdir dir="build/classes"/> </target> <target name="compile" depends="init"> Kompilieren <javac srcdir="src" destdir="build/classes"/> </target> <target name="execute" depends="compile"> <java classname="beispiel.Doctor" classpath="build/classes"/> Ausführen </target> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 47
    48. 48. Redundanzen und DRY <project name="project" default="compile"> <target name="clean"> <delete dir="build"/> </target> <target name="init" depends="clean" > <mkdir dir="build"/> <mkdir dir="build/classes"/> </target> <target name="compile" depends="init"> <javac srcdir="src" destdir="build/classes"/> </target> <target name="execute" depends="compile"> <java classname="beispiel.Doctor" classpath="build/classes"/> </target> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 48
    49. 49. Lösung: Properties <property name="build.dir" location="build"/> <property name="classes.dir" value="build/classes"/> <target name="clean"> <delete dir="${build.dir}"/> </target> <target name="init"> <mkdir dir="${build.dir}"/> <mkdir dir="${classes.dir}"/> </target> <target name="compile" depends="init"> <javac srcdir="src" destdir="${classes.dir}"/> </target> <target name="execute" depends="compile"> <java classname="beispiel.Doctor" classpath="${classes.dir}"/> </target> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 49
    50. 50. Properties <property name="build.dir" location="build"/> <property name="classes.dir" value="build/classes"/> • location ermittelt die vollen Pfadnamen • Bei value wird der Wert selbst genommen • Properties sind Konstanten • Einmal gesetzt, ändern sie sich nicht mehr • Ermöglich Steuerung des Skripts von außen •$ ant -f build1.xml -Dbuild.dir=bauverzeichnis • Erstellt die Dateien im Verzeichnis bauverzeichnis • Properties können auch aus Property-Dateien gelesen werden • ... später mehr dazu ... © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 50
    51. 51. JUnit-Tests • Wir müssen jetzt die Dateien in src und test kompilieren. • Wir benötigen die JUnit-Jar-Datei. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 51
    52. 52. JUnit-Tests • Wir führen einen Pfad path ein. <property name="test.dir" value="test" /> <path id="path.compile"> <path location="${classes.dir}"/> <path location="lib/junit-3.8.1.jar"/> </path> • Ein Pfad ist ein Datentyp von Ant (später mehr). • Der Pfad besteht aus dem Verzeichnis für die Klassen und der JUnit-Jar-Datei. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 52
    53. 53. JUnit-Tests • Diesen definierten Pfad benutzen wir im javac-Task mit refid. <target name="compile" depends="init"> <javac srcdir="${src.dir}:${test.dir}" destdir="${classes.dir}"> <classpath refid="path.compile"/> </javac> </target> • In srcdir werden die Properties mit einem Doppelpunkt getrennt. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 53
    54. 54. Kompilieren in src und test • Wir überprüfen die Änderungen • Es werden drei Dateien kompiliert, richtig. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 54
    55. 55. JUnit-Test-Task im Überblick • Den Pfad benutzen wir wieder. <target name="junit" depends="compile"> <junit> <classpath refid="path.compile" /> <formatter type="brief" usefile="false"/> <batchtest todir="."> <fileset dir="${classes.dir}"> <include name="**/*Test.class" /> <exclude name="**/Abstract*Test.class" /> </fileset> </batchtest> </junit> </target> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 55
    56. 56. JUnit-Tests • Für den formatter gibt es: brief und xml. <formatter type="brief" usefile="false"/> • Batchtest führt mehrere Tests aus. <batchtest todir="."> <fileset dir="${classes.dir}"> <include name="**/*Test.class" /> </fileset> </batchtest> • Ein Fileset ist eine ungeordnete Menge von Dateien. • Muster mit include und exclude • ... später dazu mehr ... © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 56
    57. 57. JUnit-Tests • JUnit meldet einen Fehler, Ant meldet SUCCESSFUL • Aber: Bugs sollen nicht ausgeliefert werden! © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 57
    58. 58. JUnit-Tests • Wir müssen dem JUnit-Task mitteilen, welches Property er bei einem Error oder bei einer Failure setzen soll. <target name="junit" depends="compile"> <junit errorproperty="test.failed" failureproperty="test.failed"> ... </junit> <fail message="JUnit tests failed!" if="test.failed" /> </target> • Anschliessend wird der Task fail benutzt, falls das Property gesetzt ist. • Bedingte Ausführung von Tasks mit if und unless. • Damit ist der Build gescheitert. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 58
    59. 59. Versagen erwünscht • Das ist das gewünschte Ergebnis. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 59
    60. 60. JUnit-Tests • Wir möchten auch einen HTML-Report des JUnit-Tests. • Wir benötigen ein Verzeichnis für die Dateien. <property name="junit.dir" value="junit" /> • Wir benutzen den XML-Formatter und schreiben in dieses Verzeichnis. ... <formatter type="xml"/> <batchtest todir="${junit.dir}"> ... © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 60
    61. 61. JUnit-Tests • Der JUnit-Prozess schreibt für jede Testklasse eine XML- Datei TEST-Klassenname.xml. • Hieraus erzeugen wir einen HTML-Report. <junitreport todir="${junit.dir}"> <fileset dir="${junit.dir}"> <include name="TEST-*.xml" /> </fileset> <report format="frames" todir="${junit.dir}" /> </junitreport> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 61
    62. 62. JUnit-Tests • Das Testergebnis. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 62
    63. 63. Dateien ignorieren • Wir können den BrokenDoctorTest vom JUnit-Test ausschließen. • Hierzu wird im Fileset exclude verwendet. <batchtest todir="."> <fileset dir="${classes.dir}"> <include name="**/*Test.class" /> <exclude name="**/Broken*Test.class" /> </fileset> </batchtest> • Nur zur Demonstration. In der Realität sollte man keine Testfälle einfach ausschließen. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 63
    64. 64. Der JUnit-Test ist ok • Es ist jetzt alles wieder ok. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 64
    65. 65. Erstellen einer Jar-Datei • Eine Jar-Datei kann mit dem Task <jar> erstellt werden <property name="dest.name" value="doctor-0.1" /> ... <target name="jar" depends="junit"> <jar destfile="${build.dir}/${dest.name}.jar" basedir="${classes.dir}"> <manifest> <attribute name="Main-Class" value="beispiel.Doctor" /> </manifest> </target> • Die Main-Klasse wird extra angegeben. • Bevor dieser Task läuft, muss der JUnit-Test gefixt werden. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 65
    66. 66. Dokumentation • Wir benötigen Dokumentation. <property name="doc.dir" value="doc" /> • Wir müssen das Quellverzeichnis, das Zielverzeichnis und den Klassenpfad angeben. <target name="doc" depends="compile"> <javadoc destdir="${doc.dir}" sourcepath="${src.dir}" charset="UTF-8" docencoding="UTF-8"> <classpath refid="path.compile" /> </javadoc> </target> • Umlaute in UTF-8 © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 66
    67. 67. Dokumentation • Die Javadoc. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 67
    68. 68. Erstellen der Distribution • Wir erstellen eine Zip-Datei mit Jar und Dokumentation <property name="dest.name" value="doctor-0.1" /> <zip destfile="${dest.name}.zip"> <zipfileset file="${build.dir}/${dest.jar}" prefix="${dest.name}" /> Jar <zipfileset dir="${doc.dir}" prefix="${dest.name}/doc"> <include name="**/*.*"/> </zipfileset> Doc </zip> • Zipfileset ist eine Erweiterung von Fileset. • Hier kann mit prefix das Verzeichnis bestimmt werden. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 68
    69. 69. Erstellen der Distribution • Wir machen den Task abhängig von doc und jar <target name="zip" depends="doc, jar"> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 69
    70. 70. Upload der Distribution • Mit FTP stellen wir die neueste Version zur Verfügung. <target name="deploy" depends="zip"> <ftp server="${server}" userid="${user}" password="${password}" action="put" remotedir="."> <fileset file="${dist.dir}/${dest.name}.zip" /> </ftp> </target> • Die Aktionen werden in action definiert: put, get, del, ... • Hier wird ein Fileset verwendet, dass nur aus einer Datei besteht. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 70
    71. 71. Upload der Distribution • Ausführen ergibt allerdings einen Fehler. • FTP ist ein„optionaler Task“, wir benötigen eine zusätzliche Jar-Datei. • $ ant deploy -lib lib/commons-net-1.4.0.jar © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 71
    72. 72. Der gesamte Prozess © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 72
    73. 73. Ant-Skripte dokumentieren • Ein Projekt wird im Element description erläutert. <project name="beispiel"> <description> Beschreibung des Projekts. </description> • Targets und Tasks lassen sich mit dem description- Attribut dokumentieren. <target name="test" description="Führe den Test durch"...> • Die Informationen für das Projekt und die Targets werden mit projecthelp angezeigt. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 73
    74. 74. Ant auf der Kommandozeile © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
    75. 75. Ant auf der Kommandozeile • Viele IDEs unterstützen Ant • Aber: • Auch hier müssen Argumente angeben werden. • Darum: • Die wichtigsten sollte man kennen. • Der Aufruf von Ant hat die folgende Syntax. $ ant [options] [target [target2 [target3] ...]] • Beispiel $ ant -f b.xml -emacs -Dsrc.dir=src2 compile zip © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 75
    76. 76. Optionen: Informationen • Die folgenden Optionen sind beim Debuggen hilfreich. -help -h Hilfe zu den Optionen -version Versionsinformationen -verbose -v Ausführlichere Informationen -diagnostics Listet Properties, Jar-Dateien, etc. -projecthelp -p Kurzinformationen -emacs Unterdrückt „[Taskname]“ -debug -d Ausführliche Informationen -logfile FILE Ausgabe in Datei -logger CLASS Ein anderer Logger © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 76
    77. 77. Optionen: Anpassungen • Die folgenden Optionen sind Anpassungen. -buildfile FILE -f Benutzt eine andere Build-Datei -Dproperty=value Setzt das Property auf den Wert -propertyfile FL Benutzt Properties aus Datei -lib FILE Fügt Datei dem Klassenpfad hinzu -noinput Keine Eingabe -quiet Nur Fehler werden berichtet -keep-going -k Macht weiter nach Fehlern © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 77
    78. 78. Optionen: Anpassungen • Die folgenden Optionen sind weitere Anpassungen. -nouserlib Ignoriert $HOME/.ant/lib -noclasspath Ignoriert CLASSPATH Umgeb.var. -autoproxy Benutzt die Netzwerkeinstellung für Proxies des Betriebssystems(Java 1.5) -inputhandler CL Die Klasse, die auf <input>-Events reagieren soll -listener CL Ein Listener, z. B. für Continous- Integration-Tools -main CL Alternative Klasse für Ant © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 78
    79. 79. Installation von Ant • Java Software Development Kit (SDK) wird benötigt • Umgebungsvariable JAVA_HOME muss gesetzt sein • PATH um $JAVA_HOME/bin erweitern • Download von http://ant.apache.org • Die aktuelle Version ist 1.7.1. • Entpacken in Verzeichnis ohne Leerzeichen • Umgebungsvariable ANT_HOME muss gesetzt sein • PATH um $ANT_HOME/bin erweitern • Sicherstellen, dass CLASSPATH nicht gesetzt ist • Das kann später Fehler verursachen • Optional: • Anpassung mit ANT_OPTS und ANT_ARGS © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 79
    80. 80. Die Datentypen von Ant © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
    81. 81. Motivierendes Beispiel • Ein Blick in die Dokumentation ... © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 81
    82. 82. Unbekannte Fachbegriffe • Was bedeuten diese Begriffe ? • „patterns“ • „directory based tasks“ • „fileset“ • „implicit fileset“ • „nested include/exclude elements“ • „nested patternset elements“ • „nested filesets“ • „extended fileset elements“ • „extended groupfileset elements“ • Fazit: Wir benötigen mehr Grundwissen über Ant ! © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 82
    83. 83. Datentypen • Projekt • Targets • Tasks • Parameter von Tasks • Diese Parameter haben einen Datentyp. • Datatypes / Datentypen • Das Datenmodell ist gewachsen • Abwärtskompatibilität • Nicht immer einheitlich • Sind in Java-Klassen implementiert. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 83
    84. 84. Datatypes / Datentypen • Datentypen • Properties und PropertySets • Resources und Resource Collections • Path, FileSet, FileList, DirSet, TarFileSet, ZipFileSet • Auswahl von Dateien • Dateinamen: PatternSet • Eigenschaften: Selektoren • Transformationen • Dateinamen: FileMapper • Inhalt: FilterSet, FilterChains und FilterReader • Weitere: • Permissions, Directory-Based Tasks • I/O-Redirectors, Regexp, XMLCatalog © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 84
    85. 85. Properties • Kennen wir aus dem „Grundkurs“ • Properties haben einen Namen und enthalten Strings. • Derefenzierung mit ${propertyName} • Properties sind Konstanten • Einmal gesetzt, ändern sie sich nicht mehr • Werden zur Ablaufsteuerung benutzt. • Falls eine Property keinen Wert besitzt, wird sie als $ {propertyName} ausgegeben. <echo>${nochNichtDefiniert}</echo> • ergibt ${nochNichtDefiniert}. • Es gibt viele vordefinierte Properties. • <echoproperties/> gibt diese aus. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 85
    86. 86. Definieren von Properties • Properties können gesetzt werden. Der Wert ist nicht änderbar. <property name="sprachen" value="Ant und Java"/> • Mit werden Dateien und Pfade zu absoluten Pfaden umgewandelt (wenn sie nicht im basedir liegen). <property name="build.dir" location="build"/> • Properties können bei der Definition von Properties verwendet werden. <property name="classes.dir" location="${build.dir}/classes"/> • Properties können aus Properties-Dateien geladen werden. <property file="build.properties"/> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 86
    87. 87. Definieren von Properties • Auch in den Properties-Dateien, können Properties in Definitionen verwendet werden. build.dir=build classes.dir=${build.dir}/classes dist.name=doctor-0.1 dist.jar=${dist.name}.jar • Diese werden wie die mit value definierten behandelt. • Umgebungsvariablen können als Properties geladen werden. <property environment="env"/> • Zugriff mit env.VARIABLE, zum Beispiel. <echo>env.LANG=${env.LANG}</echo> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 87
    88. 88. Steuerung mit Properties: <available> • Der <available> Task setzt eine Property, wenn eine spezifizierte Ressource vorhanden ist. • Klassen, Dateien, Verzeichnisse, JVM-Ressourcen • <available property="istDa1" classname="java.lang.String"/> <available property="istDa2" classname="java.lang.Xtring"/> <echo>${istDa1}, ${istDa2}</echo> • Ergibt true, ${istDa2} • <available property="istDa" file="a.txt" type="file"/> • <available property="istDa" file="/usr/local/lib" type="dir"/> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 88
    89. 89. Steuerung mit Properties: • Der <condition> Task setzt eine Property, wenn die angegebene Bedingung zutrifft. • Der Task hat die folgenden Attribute • Das zu setzende property • Den Wert value • Den Wert else, der ansonsten zugewiesen wird • Beispiel • <condition property="c1" else="X" > <equals arg1="1" arg2="0"/> </condition> • ergibt X © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 89
    90. 90. Steuerung mit Properties: • Bedingungen können geschachtelt werden. • <condition property="c2" value="Y"> <or> <equals arg1="1" arg2="0"/> <not> <equals arg1="1" arg2="0"/> </not> </or> </condition> • Ergibt Y © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 90
    91. 91. Steuerung mit Properties: • Ein Auswahl von „core conditions“ <and>, <or>, <not>, <xor> Logische Verknüpfungen <isset>, <isreference> Ist gesetzt? <istrue>, <isfalse> Ist wahr, Ist falsch ? <equals> Sind zwei Strings gleich ? <contains> Ist String enthalten <matches> Reguläre Ausdruck <available> Wie der Task <filesmatch> Dateivergleich <isfileselected> Wurde Datei selektiert ? <socket>, <http> Ist erreichbar ? © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 91
    92. 92. PropertySet • Properties können zu einem PropertySet zusammengefasst werden • Seit Ant Version 1.6 • Eher Ant-Intern • Eventuell für einen eigenen Tasks verwendbar • Im allgemeinen nicht für Build-Prozesse © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 92
    93. 93. Properties und Boolesche Werte • Ein Property kann einen Booleschen Wert darstellen. • Wahr sind • true • yes • on • Falsch sind • false • no • off © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 93
    94. 94. Resource und Resource Collections • Resourcen sind „Datei-ähnliche“ Dinge • resource, file, javaresource, zipentry, tarentry • gzipresource, bzip2resource, url, string, propertyresource • Eine Resource Collection ist eine Menge von Resourcen • File resources • Fileset, Dirset, Filelist • Path • Tarfileset, Zipfileset • PropertySet • Properties © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 94
    95. 95. Path / Pfad • Auch „path-like-structure“ genannt • Benutzt für CLASSPATH und PATH Umgebungsvariablen • Geordnete Liste • Elemente sind Dateien und Verzeichnisse • Rekursiv, d.h. ein Pfad kann Unterpfade enthalten • Beispiel für einen Pfad mit einer Datei. <path> <pathelement location="lib/abc.jar"/> </path> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 95
    96. 96. Path / Pfad • Beispiel für einen Pfad mit einer Datei und einem Verzeichnis. <path> <pathelement location="lib/abc.jar"/> <pathelement location="build/classes"/> </path> • Kann auch als Unterpfad angegeben werden. <path> <pathelement path="lib/abc.jar:build/classes"/> </path> • Trennung mit Semikolon oder Doppelpunkt • Windows „C:“ wird berücksichtigt • Separatoren: Slash oder Backslash, „/“ oder „“ © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 96
    97. 97. Path / Pfad • Abkürzung: Wenn Pfad nur aus einer Location oder einem Pfad besteht. <path location="lib/abc.jar"/> <path path="lib/abc.jar:build/classes"/> • Die bisherigen Beispiele waren „standalone“. • Können nicht wiederverwendet werden. • Mit dem Attribut id kann ein Name zugewiesen werden. <path id="meinpfad"> <pathelement path="lib/abc.jar:build/classes"/> </path> • Mit dem Attribut refid kann er verwendet werden. <path refid="meinpfad"/> • Ist der Pfad unbekannt, bricht Ant mit einem Fehler ab. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 97
    98. 98. Path / Pfad • Pfade können mit Filesets definiert werden. <path> <pathelement path="lib/abc.jar:build/classes"/> <fileset dir="test"> <include name="**/*.txt" </fileset> </path> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 98
    99. 99. Fileset • Ungeordnete Liste • wie die mathematische Menge („set“) • Hat ein Verzeichnis als Wurzel • das ist der Hauptunterschied zum Pfad • Per Default enthält es alle Dateien und Unterordner • Inhalt wird bei der ersten Benutzung definiert, nicht bei der Deklaration! • Statisch, werden nicht aktualisiert ! • Umfasst nur bereits existierende Elemente • Ausnahme: die sog. „Defaultexcludes“ © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 99
    100. 100. Fileset - Defaultexcludes • Es gibt Dateien, die nicht berücksichtigt werden sollen. • Backup-Kopien, die Editoren automatisch anlegen, *~ • Dateien der Versionskontrolle CVS, .svn • Lösung: defaultexcludes • Folgender Task zeigt die defaultexcludes an. <defaultexcludes echo="true"/> • Die Liste ist änderbar. Sehr umsichtig damit umgehen. Ansonsten „verschwinden“ Dateien. <defaultexcludes add="**/*.bck"/> <defaultexcludes remove="**/*~"/> • Man kann die Voreinstellung wiederherstellen. <defaultexcludes default="true"/> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 100
    101. 101. Fileset • Ein Fileset benötigt immer das Attribut dir. <fileset dir="web"/> • Alle Dateien und Unterverzeichnisse von web. • Filesets können auch benannt und wiederverwendet werden. <fileset id="auftritt" dir="web"/> • Filesets können mit Patternsets und mit Selektoren eingeschränkt werden. <fileset dir="web"> <include name=es= "**/*.jsp" /> <contains text="WICHTIG"/> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 101
    102. 102. TarFileSet und ZipFileSet • Erweiterung von Fileset für Archive. • Dateien in Archiven haben besondere Eigenschaften. • Entweder das Attribut dir oder src ist notwendig • Bei dir wird wie vorher ein Verzeichnis benutzt • Bei src wird aus einem Archiv benutzt • Attribute • ZipFileSet • prefix, filemode, dirmode, encoding • TarFileSet • prefix, filemode, dirmode, username, group, uid, gid © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 102
    103. 103. Filelist und Dirset • Werden nicht so häufig verwendet. • Filelist • Wie Fileset, aber geordnet • Die Elemente müssen nicht existieren • Verwendet in <concat>, <dependset> und <pathconvert> • Als nested element in <path> • Dirset • Wie Fileset, enthält nur Verzeichnisse • Verwendet in <javadoc> und <pathconvert> • Als nested element in <path> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 103
    104. 104. Resource Collections • Resource Collections • enthalten 0..* Ressourcen • Es gibt Mengentheoretische Operationen für diese • <intersect> ist die Schnittmenge • <sort> sortiert die Elemente • <union> ist die Vereinigung • <restrict> ist ein Filter • Resource Collections sind noch relativ neu • ab Ant 1.7 • nicht viele Tasks benutzen diese • eher selten in „normalen“ Build-Dateien © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 104
    105. 105. Patternset • Ein Patternset ist ein Menge von Mustern (Strings) • Einschränkung eines Filesets nach dem Namen • Stichwort: „file-matching“ • Kann rekursiv weitere Patternsets enthalten • Mögliche Einschränkungen • Include und Exclude • Exklusion vor Inklusion ! • Unterstütze Muster * beliebig viele Zeichen (auch keines) ? Ein einzelnes Zeichen ** beliebig viele Verzeichnisse endet mit / Das gesamte Verzeichnisses mit Inhalt © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 105
    106. 106. Patternset • Explizite Verwendung mit patternset. <patternset> <include name="**/*.jsp"/> <exclude name="*Test.jsp"/> </patternset> • Implizite Verwendung im Fileset-Attribut. <fileset dir="lib" includes="*.jsp" /> • Implizite Verwendung als Fileset-Element. <fileset> <include name="*.jsp"/> </fileset> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 106
    107. 107. Patternset • Übergabe als Attribute • includes, excludes, includesfile, excludesfile • Übergabe als Element • include, exclude, includesfile, excludesfile • Elemente können Konditional mit if/unless sein • Mit den *file-Versionen wird eine Datei angegeben, die die Muster enthält. <patternset> <include name="**/*.jsp"/> <exclude name="*Test.jsp" if="prod"/> </patternset> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 107
    108. 108. Selectors / Selektoren • Einschränkung eines Filesets nach Eigenschaften • Der Selektor wird auf jede Datei angewendet • Können in „selector containers“ angewendet werden. • Es gibt die folgenden Container. <and> Alle Selektoren müssen matchen. <or> Mind. ein Selektor muss matchen. <not> Logisches Nicht für and und or. <none> Kein Selektor matched. <selector> Für Definition mit id. <majority> Mehrheit • Container können verschachtelt werden. • Es können eigene definiert werden („custom selectors“) © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 108
    109. 109. Selectors / Selektoren <contains> Enthält die Datei einen best. Text <containsregexp> Enthält die Datei einen reg. Ausdruck <date> Änderungsdatum <depend> Neuer als in 2. Verzeichnis <depth> Verzeichnistiefe <different> Falls unterschiedlich in 2. Verzeichnis <filename> Wie <patternset> <modified> Geänderte Dateien bez. Cache <present> Falls in 2. Verzeichnis existiert <size> Größe <type> dir oder file <scriptselector> Selektor in Skriptsprache © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 109
    110. 110. Selectors / Selektoren • Das folgende Beispiel enthält nur die Dateien, die • Mit .xml enden • Den Text „project“ enthalten • Und deren Dateiname kein „a“ enthält <fileset dir="."> <and> <filename name="**/*.xml"/> <contains text="project" /> <none> <filename name="**/*a*.xml"/> </none> </and> </fileset> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 110
    111. 111. FileMapper • Abbildung • Von bestehenden Dateien • Auf neue Dateinamen • Benutzt z. B. in • <apply>, <copy>, <move> • Das folgende Beispiel benutzt den <globmapper> und kopiert alle *.xml Dateien und hängt ein *.bak an den Dateinamen. <copy todir="backup" > <fileset dir="." includes="**/*.xml"/> <globmapper from="*.xml" to="*.xml.bak"/> </copy> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 111
    112. 112. Mapper <chained> Sequentielle Ausführung <composite> Parallele Ausführung <filter> FilterChain und FilterReader, später ... <flatten> Entfernt Verzeichnisse <glob> Einfaches Ersetzen, nur ein * <identity> Identität, tut nichts <merge> Alle Dateien kommen in eine Datei <package> a/b/C.java zu a.b.C.java <regexp> Wie <glob>, aber reguläre Ausdrücke <unpackage> a.b.C.java zu a/b/C.java <scriptmapper> Erweiterung durch Skriptsprache © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 112
    113. 113. FilterSet • Ein FilterSet ist eine Menge von Filtern • Ein Filter kann Text in Dateien manipulieren • Suchen & Ersetzen in <copy> • Sehr schlechte Namensgebung! • Nicht bei binären Dateien verwenden ! • Texte zwischen Anfangs- und Endtag werden ersetzt • Anfangs- und Endtags sind frei definierbar • Default ist „@“ • Zum Beispiel: Zu ersetzen sind Datum: @DATUM@ Datum: #@$DATUM#+! © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 113
    114. 114. Filterset • Folgendes Beispiel setzt die Werte ein <copy file="Template.txt" tofile="README.txt"> <filterset> <filter token="DATUM" value="2999-12-24"/> </filterset> <filterset begintoken="#@$" endtoken="#+!"> <filter token="DATUM" value="3999-12-24"/> </filterset> </copy> • Es ergibt sich Datum: 2999-12-24 Datum: 3999-12-24 © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 114
    115. 115. FilterChain und FilterReader • In Unix und Windows gibt es die „Pipes“ • Die Ausgabe des ersten • ist die Eingabe des zweiten usw. • Zum Beispiel • $ ps -ef | grep root | sort -n | lpr • „Drucke die Liste der Prozesse von Root sortiert nach Prozess-ID aus“ • Dieses gibt es auch in Ant (allerdings limitiert) • Eine FilterChain ist eine „Anreihung“ („Kette“) von FilterReadern. • Ein FilterReader • Liest die Eingabe • Manipuliert diese und gibt sie an die Ausgabe © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 115
    116. 116. FilterChain und FilterReader • FilterReader werden verwendet in • <concat>, <copy>, <move>, <exec>, <java>, etc. <fixcrlf> Für das CR/LF-Problem <headfilter> Wie Unix head, die ersten n Zeilen <tailfilter> Wie Unix tail, die letzten n Zeilen <tabstospaces> Ersetzt Tab mit Leerzeichen <prefixlines> Setzt ein Präfix vor jede Zeile <linecontains> Filter <stripjavacomments> Entfernt Kommentare <striplinecomments> Entfernt Kommentare, z. B. #, //, -- <striplinecomments> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 116
    117. 117. FilterChain und FilterReader • Das folgende Beispiel • Entfernt die Kommentare, • Ersetzt die Tabs • Und ersetzt die Zeilenbegrenzer auf „n“. <copy file="${src.dir}/beispiel/Doctor.java" tofile="Doctor2.java"> <filterchain> <stripjavacomments/> <tabstospaces tablength="2"/> <fixcrlf eol="unix"/> </filterchain> </copy> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 117
    118. 118. Argumente als Attribut und Element • Es gibt oft zwei Möglichkeiten Parameter anzugeben • Als Attribut • Als Element • Zum Beispiel FileSet. • Die folgenden beiden Statements beschreiben das gleiche FileSet. <fileset dir="." includes="**/*.xml"/> • und <fileset> <include name="**/*.xml"/> </fileset> • Das Element ist flexibler, es erlaubt „nested elements“. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 118
    119. 119. Implizite Elemente • Ant beruht auf Java • Java ist Objekt-orientiert • Daher gibt es in Ant auch eine Art Vererbung • Der <javac> Task ist implizit auch ein FileSet. <javac srcdir="src" destdir="dest"> <include name="**/*.java"/> <exclude name= "**/Broken*.java" > </javac> • Ein FileSet hat ein Wurzelverzeichnis. • Bei <javac> wird dieses mit dem Attribut srcdir angegeben. • <javac> ist ein „directory-based task“ © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 119
    120. 120. Nicht mehr unbekannte Fachbegriffe • Was bedeuten diese Begriffe ? • „patterns“ PatternSet • „directory based tasks“ • „fileset“ z. B. <javac> • „implicit fileset“ • „nested include/exclude elements“ • „nested patternset elements“ FileSet, PatternSet • „nested filesets“ • „extended fileset elements“ • „extended groupfileset elements“ ZipFileSet, • Fazit: Wir haben Grundwissen über Ant ! © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 120
    121. 121. Die Tasks von Ant © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
    122. 122. Typen von Tasks • Ant unterscheidet • Core Tasks • werden mitgeliefert in ant.jar • Optionale Tasks • Tasks werden mitgeliefert, z. B. ant-junit.jar • zusätzliche Jar-Datei muss hinzugefügt werden • 3rd party • Werden von anderen entwickelt • Custom • Eigenentwicklungen © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 122
    123. 123. Core Tasks Ant-Basis ... viele ... Archive <ear>, <jar>, <signjar>, <tar>, <war>, <zip> Dateien <basename>, <bzip2>, <dirname>, <chmod>, <checksum>, <concat>, <copy>, <delete>, <fixcrlf>, <genkey>, <gzip>, <mkdir>, <move>, <patch>, <touch> Java <apt>, <javac>, <javadoc>, <manifest>, <rmic>, Netzwerk / DB <get>, <mail>, <sql> Prozesse <apply>, <exec>, <java>, <nice>, <sleep>, <waitfor> Versionsverwaltung <cvs>, <cvschangelog>, <cvsversion>, ... XML <xslt> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 123
    124. 124. Optionale Tasks Archive <cab>, <ejbjar>, <rpm> Netzwerk <ftp>, <rexec>, <scp>, <setproxy>, <sshexe>, <telnet> Sprachen <antlr>, <depend>, <icontract>, <javacc>, <javah>, <jdepend>, <jspc>, <netrexxc>, <script>, <scriptdef>, verschiedene EJB 2 Test <junit>, <junitreport> Text <native2ascii>, <replaceregexp>, <translate> Utilities <image>, <propertyfile>, <sound>, <splash> Versionsverwaltung ClearCase, Continuus, Perforce, PVCS, StarTeam, Visual SourceSafe XML <schemavalidate>, <xmlvalidate> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 124
    125. 125. Ant-Contrib Tasks Ant <antcallback>, <antfetch>, <runtarget>, <relentless> Kontrollfluß <assert>, <for>, <if>, <switch>, <throw>, <trycatch> Plattform, OS <osfamily>, <shellscript> Properties <math>, <propertycopy>, <var>, <urlencode>, <sortlist>, <propertyselector>, <pathtofileset>, <propertyregexp> Conditions <isgreaterthan>, <islessthan>, <ispropertyfalse>, <ispropertytrue> Selektoren <timestampselector> Netzwerk <post>, <httpClient>, <httpState> Sonstiges <outofdate> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 125
    126. 126. 3rd Party Tasks Code-Qualität PMD, Checkstyle, Findbugs, JavaNCSS J(2)EE XDoclet, versch. Applikationsserver, Hibernate Netzwerk WebDAV Sprachen AspectJ, Groovy, Scala Test Cobertura, DbUnit, HtmlUnit, Jakarta Cactus, JMeter, JUnitEE, TestNG, XMLUnit Texte Apache FOP Versionsverwaltung SvnAnt XML Apache XML Beans, Xjc (JAXB) © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 126
    127. 127. Bedingte Ausführung von Tasks • Tasks lassen sich bedingt ausführen. <target name="hello" if="isHello"> <echo message="Hallo Welt"/> </target> <target name="goodbye" unless="isHello"> <echo message="Tschüss Welt"/> </target> • Bei if muss das Property gesetzt sein. • Bei unless darf es nicht gesetzt sein. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 127
    128. 128. Tasks einbinden • Tasks • Sind Java-Klassen • Erben von org.apache.tools.ant.Task • Überschreiben der execute() Methode • Mit <taskdef> wird ein Task definiert • Der Name wird einer Klasse zugewiesen <taskdef name="dbunit" classname="org.dbunit.ant.DbUnitTask" classpathref="dbunit.path" /> • Oder über Properties <taskdef resource="checkstyletask.properties" classpath="${cs.jar}"/> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 128
    129. 129. Tasks einbinden: Suche nach Jars • Hierzu muss die Klasse in einer Jar-Datei im CLASSPATH sein. • Ant sucht an den folgenden Orten nach Jars • Jedes Jar aus dem $CLASSPATH. • Wenn nicht -noclasspath angegeben wurde. • Jedes Jar aus $ANT_HOME/lib • Jedes Jar aus $HOME/.ant/lib • Wenn nicht -nouserlib angegeben wurde. • Jedes Jar, das als Argument von -lib angegeben wurde. • Tip: Mit dem folgenden Kommando werden alle Jars für die optionalen Tasks zu $HOME/.ant/lib heruntergeladen. • $ cd $ANT_HOME • $ ant -f fetch.xml all -Ddest=USERNAME © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 129
    130. 130. Tasks einbinden: Troubleshooting • Bei optionalen oder 3rd party Tasks gibt es oftmals mehrere notwendige Jars • Eine Jar-Datei für den Task selber • Also die Erweiterung von Ant • Eine Jar-Datei für das, was über Ant aufgerufen werden soll • Also das, um was Ant erweitert werden soll • Desweiteren werden noch weitere Jars benötigt • Wie z. B. Logging Ant Ant Task Erweiterung Hilfs-Jars © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 130
    131. 131. Tasks einbinden: Troubleshooting • Beispiel der Fehlermeldung, wenn eine Jar-Datei für einen optionalen Task nicht im CLASSPATH ist. • Für <scp> löst -lib lib/jsch-0.1.29.jar das Problem. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 131
    132. 132. Tasks einbinden: Troubleshooting • Bei der folgenden Meldung wird JRuby vermisst. • Erkennbar an der ClassNotFoundException © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 132
    133. 133. Core Tasks © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
    134. 134. Core Tasks Ant-Basis ... viele ... Archive <ear>, <jar>, <signjar>, <tar>, <war>, <zip> Dateien <basename>, <bzip2>, <dirname>, <chmod>, <checksum>, <concat>, <copy>, <delete>, <fixcrlf>, <genkey>, <gzip>, <mkdir>, <move>, <patch>, <touch> Java <apt>, <javac>, <javadoc>, <manifest>, <rmic>, Netzwerk / DB <get>, <mail>, <sql> Prozesse <apply>, <exec>, <java>, <nice>, <sleep>, <waitfor> Versionsverwaltu <cvs>, <cvschangelog>, <cvsversion>, ... ng XML <xslt> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 134
    135. 135. Sequentiell und Parellel • Innerhalb eines Targets können Tasks sequentiell und parallel ausgeführt werden. • Dieses wird mit <sequential> und <parallel> erreicht. <parallel> <sequential> <echo>1-A</echo> <echo>1-B</echo> </sequential> <sequential> <echo>2-A</echo> <echo>2-B</echo> </sequential> </parallel> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 135
    136. 136. Sequentiell und Parellel • Hier das Ergebnis. Die Prozesse 1 und 2 laufen mit unterschiedlicher „Geschwindigkeit“. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 136
    137. 137. Default-Werte: <presetdef> • <presetdef> kann Attribute und Elemente vordefinieren. • Nützlich bei „parameter-intensiven“ Tasks. • Z. B. <sql> oder <javac>. • <presetdef name="meinEcho"> <echo message="Halli-Hallo"/> </presetdef> • Aufruf mit: • <meinEcho/> • Achtung: Die Werte können wieder überschrieben werden. <meinEcho message="Guten Tag"/> • Daher nicht zum „Erzwingen“ von Konventionen geeignet. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 137
    138. 138. Neue Tasks: <macrodef> • Mit <macrodef> können neue Tasks definiert werden. • <macrodef name="meins"> <attribute name="arg1" /> <attribute name="arg2" default="default" /> <attribute name="arg3" default="**/*.xml" /> <text name="text" trim="false" optional="true" /> <element name="files" optional="true"/> <sequential> <echo>@{arg1}, @{arg2}, @{arg3}</echo> <echo>Text: @{text}</echo> <echoxml><z><files/></z></echoxml> </sequential> </macrodef> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 138
    139. 139. Neue Tasks: <macrodef> • Es gibt drei Argumenttypen • Attribute <attribute name="arg2" default="default" /> • Textinhalte <text name="text" trim="false" optional="true" /> • Elemente <element name="files" optional="true"/> • Der Aufruf erfolgt z. B. folgendermaßen. <meins arg1="V" arg2="V2" arg3="**/*.xml:**/*.jsp"> Hier ist ein Text <files><fileset include="**/*.txt"/></files> </meins> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 139
    140. 140. Neue Tasks und Datentypen • Mit <taskdef> können neue Tasks definiert werden. <taskdef name="ejbdoclet" classname="xdoclet.modules.ejb.EjbDocletTask" classpathref="xdoclet.class.path"/> • Hierfür gibt es bei mehreren optionalen Tasks Beispiele. • Mit <typedef> können neue Datentypen definiert werden. <typedef name="datetime" classname="org.xyz.DateTime" classpathref="somepathref"/> • Wird in der Praxis eher selten benutzt. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 140
    141. 141. Große Projeke: <antcall> und <ant> • Mit <antcall> können Targets aufgerufen werden. • Das folgende Target soll aufgerufen werden. <target name="a"> <property name="p1" value="p1"/> <echo>A ${p1}</echo> </target> • Dieses führen wir mit folgenden Statements durch. <property name="p1" value="x1"/> <antcall target="a"/> <antcall target="a" inheritall="false"/> • Beim zweiten Aufruf werden die Properties nicht „vererbt“. • Anmerkung: Es gibt keine Rückgabewerte. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 141
    142. 142. Große Projeke: <antcall> und <ant> • Dieses führt zu dem abgebildeten Ergebnis. • Mit <ant> können auch Targets in anderen Build-Dateien verwendet werden. • <ant antfile="x.xml" target="a"/> <ant antfile="x.xml" target="a" inheritall="off"/> • Wird antfile nicht angegeben, dann wird build.xml © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 142
    143. 143. Große Projeke: <import> • Build-Dateien können andere mit <import> importieren. • Dieses Statement kann überall im Dokument als Element von <project> stehen. • Wir haben zwei Build-Dateien: imported.xml und importer.xml. imported.xml definiert die beiden Targets a und b. <target name="a"> <echo>Imported A</echo> </target> <target name="b"> <echo>Imported B</echo> </target> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 143
    144. 144. Große Projeke: <import> • Die Datei importer.xml importiert X. <import file="imported.xml" /> • Und überschreibt das Target b. <target name="b"> <echo>Importer B</echo> </target> • Der Aufruf von •$ ant -f importer a b • zeigt, dass b überschrieben wurde. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 144
    145. 145. Core Tasks: Archive • <tar> und <zip> schreiben die Dateien aus einem FileSet in eine Tar bzw. Zip-Datei. <tar destfile="a.tar" basedir="." includes="**/*.xml"/> <zip destfile="a.zip" basedir="." includes="**/*.xml"/> • <untar> und <unzip> entpacken Archive. <untar src="a.tar" dest="testdir1"/> <unzip src="a.zip" dest="testdir2"/> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 145
    146. 146. Core Tasks: Archive - Jar • <jar> hat ein implizites FileSet, d.h. ein Wurzelverzeichnis. • Dieses wird mit dem Attribut basedir angegeben. • <ear> und <war> sind Erweiterung von <jar>. • Deren Funktionalität kann auch mit <jar> und den Attributen prefix und fullpath erreicht werden • <war> kennt WEB-INF/lib und WEB-INF/classes • ZipFileSet Elemente sind vorhanden • Viele empfehlen duplicate="preserve", damit keine Elemente mit gleichem Namen in das Archiv kommen. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 146
    147. 147. Core Tasks: Archive - War • Eine War-Datei enthält Klassen, Webseiten, Jars, etc. • Diese können als FileSets spezifiert werden. • <target name="war" depends="compile"> <war destfile="${dist.war}" webxml="${web.xml}"> <classes dir="${classes.dir}"> <include name="**/*.class"/> <exclude name="**/*Test.class"/> </classes> <fileset dir="${web.dir}"/> </war> </target> • Jetzt muss die War-Datei noch deployed werden. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 147
    148. 148. Core Tasks: Archive - War • Bei Servern, die „Hot-Deployment“ unterstützen, muss die Datei nur in das richtige Verzeichnis kopiert werden. • Ist der Server auf einem anderen Rechner: <scp>. <target name="deploy" depends="war"> <copy todir="${deploy.dir}" file="${dist.war}"/> </target> • Anschliessend warten wir, bis die Anwendung gestartet ist. <target name="wait-deployed"> <waitfor checkevery="1000" maxwait="15000"> <http url="${app.url}" /> </waitfor> </target> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 148
    149. 149. Core Tasks: Externe Prozesse • Mit Ant lassen sich externe Prozesse aufrufen und kontrollieren. • <apply> ruft ein externes Programm für jede Datei in einem FileSet auf. <apply command="ls -l"> <fileset dir="." includes="*.xml"/> </apply> • <exec> ruft ein externes Programm mit bestimmten Argumenten auf. <exec executable="ls"> <arg value="-l"/> <arg value="."/> </exec> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 149
    150. 150. Core Tasks: Externe Prozesse • Beide können mit dem Attribute spawn vom Ant-Prozess losgelöst werden (ähnlich nohup unter Unix). • Mit <nice> bekommt der aktuelle Prozess eine neue „niceness“. <nice newpriority="+10"/> • Schlafen mit <sleep>. <sleep minutes="3" seconds="25"/> • Mit <waitfor> kann auf die Erfüllung einer Condition warten bzw. bis ein Timeout auftritt. <waitfor checkevery="1000" maxwait="5000" timeoutproperty="not.available" > <socket server="localhost" port="8080" /> </waitfor> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 150
    151. 151. Core Tasks: Externe Prozesse • Java-Klassen und Jar-Dateien lassen <java> sich mit aufrufen. • Mit dem Attribut fork kann eine neue Java Virtual Machine (JVM) gestartet werden. • Diese hat einen eigenen Classloader und -Path. Aufpassen. <java fork="true" classname="groovy.ui.Console"/> • Ergibt einen NoClassDefFoundError auch beim Start mit $ ant target -lib lib/groovy-all-1.5.5.jar • Entweder man verzichtet auf das Fork. <java classname="groovy.ui.Console"/> • Oder man setzt den Classpath. • <java fork="true" classname="groovy.ui.Console" classpathref="gpath"> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 151
    152. 152. Optionale Tasks © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
    153. 153. Optionale Tasks Archive <cab>, <ejbjar>, <rpm> Netzwerk <ftp>, <rexec>, <scp>, <setproxy>, <sshexe>, <telnet> Sprachen <antlr>, <depend>, <icontract>, <javacc>, <javah>, <jdepend>, <jspc>, <netrexxc>, <script>, <scriptdef>, verschiedene EJB 2 Test <junit>, <junitreport> Text <native2ascii>, <replaceregexp>, <translate> Utilities <image>, <propertyfile>, <sound>, <splash> Versionsverwaltu ClearCase, Continuus, Perforce, PVCS, StarTeam, ng Visual SourceSafe XML <schemavalidate>, <xmlvalidate> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 153
    154. 154. Optionale Tasks: SCP • SCP benötigt das jsch-Jar. • Das folgende Statement übertragt ein FileSet. <scp todir="${user}:${password}@${host}:${rpath}" sftp="true" verbose="true"> <fileset dir="." includes="**/*.xml"/> </scp> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 154
    155. 155. Optionale Tasks: XML • Für XML gibt es zwei Validierungsschemata: • DTD • XML-Schema • Für DTD gibt es den Task <xmlvalidate>. <xmlvalidate file="${xml.dir}/tabellendaten.xml"> <dtd publicid="TEST" location="dtd/schema.dtd"/> </xmlvalidate> • Für XML-Schema den Task <schemavalidate>. <schemavalidate file="${xml.dir}/tools.xml" /> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 155
    156. 156. Optionale Tasks: JDepend • JDepend erstellt Metriken der Design-Qualität • siehe http://clarkware.com/software/JDepend.html • Der JDepend Task analysisiert die Klassen im classespath. Er erstelle eine XML-Datei. <jdepend format="xml" outputfile="jdepend/jdepend-report"> <exclude name="java*"/> ... <exclude name="junit.*"/> <classespath> <pathelement location="${classes.dir}" /> </classespath> <classpath location="${classes.dir}" /> </jdepend> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 156
    157. 157. Optionale Tasks: JDepend • Im zweiten Schritt wird die XML-Datei mit <xslt> in eine HTML-Datei umgeformt. • <xslt basedir="jdepend" destdir="jdepend" includes="jdepend-report" style="lib/etc/jdepend.xsl" /> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 157
    158. 158. Optionale Tasks: JDepend • Hier das Ergebnis von JDepend. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 158
    159. 159. Ant-Contrib Tasks © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
    160. 160. Ant-Contrib Tasks Ant <antcallback>, <antfetch>, <runtarget>, <relentless> Kontrollfluß <assert>, <for>, <if>, <switch>, <throw>, <trycatch> Plattform, OS <osfamily>, <shellscript> Properties <math>, <propertycopy>, <var>, <urlencode>, <sortlist>, <propertyselector>, <pathtofileset>, <propertyregexp> Conditions <isgreaterthan>, <islessthan>, <ispropertyfalse>, <ispropertytrue> Selektoren <timestampselector> Netzwerk <post>, <httpClient>, <httpState> Sonstiges <outofdate> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 160
    161. 161. Ant-Contrib Tasks • Ant-Contrib bietet eine Menge Erweiterung • Manche sehen diese Erweiterungen als zu „prozedural“ an, denn Ant soll „deklarativ“ verwendet werden • Ant-Contrib ist als Antlib verwendbar. • Dieses ist ein recht neuer Packet-Mechanismus von Ant. • Um es zu verwenden, kann man es z. B. als XML- Namespace definieren. <project name="contrib" xmlns:c="antlib:net.sf.antcontrib"> • Die Tasks sind dann mit <c:XYZ> und </c:XYZ> zu verwenden. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 161
    162. 162. Ant-Contrib Tasks: <if> • Wir testen die Erreichbarkeit eines Servers mit <if>. <c:if> <http url="${url}"/> <!-- <condition> --> <c:then> <echo>Server ist da!</echo> </c:then> <c:else> <echo>Server ist nicht da!</echo> </c:else> </c:if> • <if> erwartet als erstes Argument eine <condition>. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 162
    163. 163. Ant-Contrib Tasks: <switch> • Mit <switch> kann man z. B. eine Mehrfachabfrage machen. Wir testen, welche Shell der aktuelle Benutzer hat. <property environment="env"/> <c:switch value="${env.SHELL}"> <c:case value="/bin/bash"> <echo>Benutzer von Bash</echo> </c:case> <c:default> <echo>Sonstige Shell</echo> </c:default> </c:switch> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 163
    164. 164. Ant-Contrib Tasks: <foreach> • Mit <foreach> wird ein Target für jedes Element aufgerufen. <target name="kopf"> <c:foreach list="1,2,3,4,5" target="koerper" param="i" /> </target> <target name="koerper"> <echo>Schritt ${i}</echo> </target> • Es können andere Delimiter mit <delimiter> angeben werden. • Achtung: Da jedesmal ein neus Target aufgerufen wird, ist hier auf die Performance zu achten. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 164
    165. 165. Ant-Contrib Tasks: <foreach> • Iterieren über die Elemente eines FileSets. <c:foreach target="koerper" param="i"> <fileset dir="." /> </c:foreach> • Wir können auch mehrere FileSets benutzen. <c:foreach target="koerper" param="i"> <path> <fileset dir="src" /> <fileset dir="test" /> </path> </c:foreach> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 165
    166. 166. Ant-Contrib Tasks: <for> • Mit <for> ist das separate Target nicht notwendig. <c:for list="1,2,3,4,5" param="i"> <sequential> <echo>Schritt @{i}</echo> </sequential> </c:for> • Intern wird <macrodef> benutzt. • Daher ist es notwendig, ‚@‘ zu benutzen. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 166
    167. 167. Ant-Contrib Tasks: <for> • Wir können auch ein FileSet benutzen. <c:for param="i"> <fileset dir="." /> <sequential> <echo>Schritt @{i}</echo> </sequential> </c:for> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 167
    168. 168. 3rd Party Tasks © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com
    169. 169. 3rd Party Tasks Code-Qualität PMD, Checkstyle, Findbugs, JavaNCSS J(2)EE XDoclet, versch. Applikationsserver, Hibernate Netzwerk WebDAV Sprachen AspectJ, Groovy, Scala Test Cobertura, DbUnit, HtmlUnit, Jakarta Cactus, JMeter, JUnitEE, TestNG, XMLUnit Texte Apache FOP Versionsverwaltung SvnAnt XML Apache XML Beans, Xjc (JAXB) © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 169
    170. 170. DbUnit • DbUnit ist ein Testwerkzeug für die Datenbank. • Testdaten werden in XML-Dateien definiert. • Wir benötigen einen JDBC-Treiber. <path id="dbunit.path"> <path location="lib/slf4j-api-1.5.0.jar" /> <path location="lib/slf4j-simple-1.5.0.jar" /> <path location="${jdbc.jar}" /> <path location="lib/dbunit-2.2.jar" /> </path> • Definition des Tasks. <taskdef name="dbunit" classname="org.dbunit.ant.DbUnitTask" classpathref="dbunit.path" /> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 170
    171. 171. DbUnit • Export der DTD des Schemas. <dbunit driver="${driver}" url="${url}" userid="${user}" password="${password}"> <export dest="${dbunit.dir}/schema.dtd" format="dtd" /> </dbunit> • Export aller Tabellen in eine XML-Datei. <dbunit driver="${driver}" url="${url}" userid="${user}" password="${password}"> <export dest="${dbunit.dir}/tabellendaten.xml" /> </dbunit> • Beobachtung: Es ist sehr unpraktisch, dbunit zu verwenden, da immer die vier Parameter übergeben werden müssen. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 171
    172. 172. DbUnit und <presetdef> • Lösung: Mit <presetdef> können Default-Parameter an einen Wrapper-Task gebunden werden. • <presetdef name="mydbunit"> <dbunit driver="${driver}" url="${url}" userid="${user}" password="${password}"/> </presetdef> • Jetzt sieht der Export der DTD des Schemas folgendermaßen aus. • <mydbunit> <export dest="${dbunit.dir}/schema.dtd" format="dtd" /> </mydbunit> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 172
    173. 173. DbUnit und <presetdef> • Export der Tabelle „farbe“ mit SELECT-Statement und der Tabelle „osterei“. • <mydbunit> <export dest="${dbunit.dir}/partiell.xml"> <query name="Q" sql="SELECT * FROM farbe"/> <table name="osterei"/> </export> </mydbunit> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 173
    174. 174. XDoclet • XDoclet • Attribute-Oriented-Programming • wird bei der EJB 2-Entwicklung angewendet • XDoclet bietet eine Menge von Ant-Tasks. • ejbdoclet • webdoclet • hibernatedoclet • springdoclet • jdodoclet • jmxdoclet • und noch einige mehr © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 174
    175. 175. XDoclet: <ejbdoclet> • EJB 2-Anwendungen haben eine gewisse Redundanz an Interfacen. Diese sind jeweils für den Server und die Clients anzulegen. • Mit XDoclet werden im Sourcecode Tags hinterlegt, aus denen dann die entsprechenden Interfaces und Klassen generiert werden. • Der Pfad. <path id="xdoclet.class.path"> <fileset dir="lib/xdoclet-1.2.3/lib" includes="*.jar"/> <fileset dir="lib/xdoclet-1.2.3/samples/lib" includes="*.jar"/> </path> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 175
    176. 176. XDoclet: <ejbdoclet> • Der Task. <taskdef name="ejbdoclet" classname="xdoclet.modules.ejb.EjbDocletTask" classpathref="xdoclet.class.path"/> • Der Aufruf für alle Dateien in src.dir. <ejbdoclet destdir="${generated.dir}" excludedtags="@author" ejbspec="2.0" addedtags="@xdoclet-generated at ${TODAY}"> <fileset dir="${src.dir}" includes="**/*Bean.java"/> • Auf der nächsten Seite geht es weiter. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 176
    177. 177. XDoclet: <ejbdoclet> • Wir generieren Remote-, Local- und Home-Interfaces. • <remoteinterface pattern="{0}"/> <localinterface pattern="{0}Local"/> <homeinterface/> <localhomeinterface/> <session/> <utilobject cacheHomes="true" kind="physical" includeGUID="true"/> <deploymentdescriptor destdir="${meta.inf}"/> <jboss version="4.0" destdir="${meta.inf}" /> </ejbdoclet> • Eine genaue Erklärung wäre Out-of-Scope des Vortrags. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 177
    178. 178. JUnitEE • JUnitEE ermöglicht Unit-Tests auf dem Applikationsserver. • Mit <juniteewar> wird eine War-Datei erstellt, die den Testserver und die zu testenden Klassen enthält. <juniteewar destFile="${dist.dir}/${junitee.war}"> <lib dir="lib" includes="*.jar> <classes dir="${classes.dir}" includes="**/*.class" /> <testcases dir="${classes.dir}" includes="**/*Test.class" /> </juniteewar> • Mit <lib> werden die benötigten Bibliotheken und mit <testcases> die Testklassen angegeben. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 178
    179. 179. JUnitEE • Die Tests können automatisch mit Ant ausgeführt werden. <junitee url="${url}" printsummary="true"> <test runall="true" /> </junitee> • Oder manuell über eine Webseite. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 179
    180. 180. Groovy • Groovy ist eine dynamische Programmiersprache. • Es gibt zwei Tasks für Groovy. • Einen zum Ausführen von Groovy-Code direkt in Ant. • <taskdef name="groovy" classname="org.codehaus.groovy.ant.Groovy" classpath="${groovy.jar}"/> • Und einen Task zum Kompilieren von Groovy. <taskdef name="groovyc" classname="org.codehaus.groovy.ant.Groovyc" classpath="${groovy.jar}"/> • Groovy kann auch über die Script-Möglichkeiten von Ant genutzt werden. Siehe das Kapitel „Ant erweitern“. © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 180
    181. 181. Groovy • Groovy-Programme können direkt in Ant verfasst werden. • <groovy> println "Hallo Groovy" int n = 100 def ks = (0..n).toList().inject(0) { a,b -> a+b } println "Die Summe von 1..${n} ist ${ks}" </groovy> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 181
    182. 182. Groovy • Groovy ist vollständig in Java integriert. • Groovy kann Java-Klassen benutzen und umgekehrt. <groovy> import java.text.SimpleDateFormat def gc = new GregorianCalendar() gc.time = new Date() gc.add Calendar.MONTH, 3 def format = new SimpleDateFormat('dd.MM.yyyy') println "In drei Monaten ist der " + format.format(gc.time) </groovy> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 182
    183. 183. PMD • PMD ist ein Werkzeug zur Quellcodeanalyse. • Es kann mögliche Fehler, suboptimalen Code, etc. finden • Ist mit Regeln konfigurier und erweiterbar • Wir definieren einen Pfad für die benötigten Jars. <path id="pmd.class.path"> <path location="lib/jasm-3.1.jar"/> <path location="lib/jaxen-1.1.1.jar"/> <path location="lib/pmd-4.2.1.jar"/> </path> • Wir definieren den PMD-Task. <taskdef name="pmd" classname="net.sourceforge.pmd.ant.PMDTask" classpath="lib/pmd-4.2.1.jar" /> © 2008 - 2009 Jörn Dinkla, http://www.dinkla.com 183

    ×