Beispiele zu "Der AspectJ-Werkzeugkasten"

Beispiele zu "Der AspectJ-Werkzeugkasten"

Folgende Beispiel-Programme finden sich in diesem Verzeichnis:

Verzeichnis Kap. Beschreibung s.a.
1Hello 9.2.1, 9.2.4, 9.3 Das Hello-World-Beispiel dient als Grundlage für den Umgang mit dem Compiler (ajc) und dem AspectJ-Doc-Generator (ajdoc) Quell-Dateien, Xlint-Option, AspectJ-Doc-Generator
2LazyTjp 9.2.3 "fauler thisJoinPoint" - Test-Programm für die Option "-XlazyTjp" Fauler thisJoinPoint
3Xlint 9.2.5 Test-Programm für die verschiedenen Xlint-Optionen Xlint-Beispiel
4AntTest 9.4.1 ein leeres Ant-Beispiel für den ersten Test Einbindung in Ant
5Lotto 9.4.2 ff ein etwas ausführlicheres Ant-Beispiel Aufruf des Compilers Generierung der API-Dokumentation

Die Datei build.xml dient zum Aufräumen ('ant clean') und zum Übersetzen der AspectJ-Beispiele ('ant').

Der Compiler (ajc) und seine Optionen

Um Ihnen das Abtippen aus dem Buch zu erleichtern, finden Sie auf dieser Seite unter der jeweiligen Überschrift die einzelnen Kommandos. Für Linux und Mac OS-X können Sie die Kommandos sollten Sie die einzelnen Befehle direkt kopieren können, für Windows müssen Sie sie evtl. ein wenig anpassen.

Quell-Dateien

Im Gegensatz zum Buch wurde hier noch die Option "-d ../classes" eingefügt, um die erzeugten Class-Dateien von den Sourcen zu trennen.

Fauler thisJoinPoint

Hier die einzelne Schritte der Compilation und Start von der Kommandozeile (Linux). Die Zeiten wurden unter Linux (SuSE 9.3) auf einem IBM T41 (Pentium M 1,6 GHz) ermittelt und gelten für die Variante, die im Buch abgedruckt ist (before-Pointcut).
Falls nicht anders vermerkt, wurde AspectJ 1.5M2 und Java 1.5.0 eingesetzt.

Ohne -XlazyTjp:

Ergebnis mit AspectJ 1.2 / JDK 1.4.2: ca. 4600 - 5100 ms

Mit -XlazyTjp:

Ergebnis mit AspectJ 1.2 / JDK 1.4.2: ca 1300 - 1800 ms

Mit Hotspot-Compiler wurden in beiden Fällen fast dieselben Zeiten erreicht.

Ohne Pointcut:

Ergebnis: ca. 600 - 800 ms (JDK 1.4.2) bzw. 500 - 700 ms (JDK 1.5.0)

Xlint-Beispiele

Für die Xlint-Beispiele müssen Sie den Source-Level auf mindestens Java 5 setzen, da mit Anotations gearbeitet wird.

In der Ausgabe wurde die Pfad-Angabe gekürzt.

Xlint-Option

Um den Compiler mit den verschiedenen Xlint-Optionen aufzurufen, geben Sie unter Linux eines der folgenden Kommandos auf der Kommandozeile ein:

Der AspectJ-Doc-Generator

Wenn bei Ihnen alles geklappt hat, finden Sie anschließend im doc-Verzeichnis die enstrechend API-Dokumentation

Einbindung in Ant

Vorbereitung

Aufruf des Compilers

Sollten Sie stattdessen die Fehlermeldung ReflectionFactory unable to load org.aspectj.ajdt.ajc.AjdtCommand as org.aspectj.bridge.ICommand erhalten, überprüfen Sie nochmals, ob sich apsectjtools.jar im CLASSPATH oder im lib-Verzeichnis von Ant befindet.

Nachträgliche Instrumentierung

Generierung der API-Dokumentation

Das Ergebnis kann anschliepend im build/doc-Verzeichnis unter index.html gegutachtet werden.


letzte Änderung: 19. September 2005