Successfully reported this slideshow.
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
Nächste SlideShare
Wird geladen in …5
×

Ant im Detail

6.390 Aufrufe

Veröffentlicht am

Unterlagen für eine Schulung über das Werkzeug Ant

Veröffentlicht in: Technologie
  • Als Erste(r) kommentieren

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

×