Unit Tests: Und private Methoden…?

Es ist eine gute Sache, daß ich mehr Unit Tests schreibe! Das hat zum einen damit zu tun, daß ich eine Menge gelernt habe; aber auch damit, daß ich viel GUI Code schreibe, und die GUI zum Testen zu starten ist extrem ineffizient.

Aber zum Thema private Methoden: Das Thema wurde für mich wieder aktuell, als ich vorgestern einen Vortrag von Andrew Glover zum Thema “Code Metrics for Targeted Code Refactoring” gehört habe (Organisiert von der Philadelphia JUG). Das Thema Unit Testing von privaten Methoden kam zur Sprache, und er erwähnte das JunitX Projekt, das dies ermöglicht.

Aber bevor wir ins Detail gehen, sollten wir uns die Frage stellen: Ist es überhaupt richtig, private Methoden zu testen, und was sind bessere Lösungen oder Alternativen?

Ich höre oft: “Wenn Du glaubst, private Methoden testen zu müssen, ist das ein Warnsignal.” Private Methoden sollten durch die nicht-privaten Methoden getestet werden, die sie benutzen. Sollte das nicht möglich sein, sollte die Architektur überdacht werden.

Ich stimme dem zu, daß diese Situationen mit Skepsis betrachtet werden sollten. Allerdings liegt meiner Meinung nach die Betonung von “Unit Test” auf “Unit”, und je kleiner die getestete Einheit, umso besser. Wenn ein Methode zu unübersichtlich wird (z.B. > 600 Zeilen), dann macht es Sinn, Teile in private Methoden auszulagern (und die Architektur zu überdenken, aber manchmal geht es eben nicht anders). Und meiner Meinung nach macht es viel Sinn, diese Teile einzeln zu prüfen. Und wenn wir diese kleinen Hilfsmethoden schreiben bevor die sie nutzende Methode geschrieben ist, dann macht es erst recht Sinn, diese zu testen. Bill Venners hat einen exellenten Aufsatz zu dem Thema geschrieben.

package private

Was können wir also tun? Das einfachste ist, die zu testenden Methoden package private zu machen. Eine package private Methode hat keine Qualifizierer (also weder private, protected oder public), und kann lediglich von Klassen in der selben Package gesehen werden. Vorteil: Extrem leicht zu implementieren; Refactoring (z.B. umbenennen) funktioniert problemlos, weil das Refactoringwerkzeug alle Referenzen finden kann. Nachteil: Wir verletzen Encapsulation. Das muß jeder für sich entscheiden, wie wichtig das ist. Aber ich finde es sehr wichtig. Zum einen gibt der Qualifizierer dem Entwickler ein starkes Signal und erlaubt, mit einem Blick die Bedeutung einer Methode einzuschätzen. Hinzu kommt, daß Eclipse mich warnt, wenn eine private Methode nicht benutzt wird. Das geht leider nicht mit package private Methoden.

Reflektion

JunitX benutzt Reflektion, um auf private Methoden zuzugreifen, und dieser Ansatz gefällt mir. Allerdings habe ich es nicht geschafft JunitX zum Laufen zu bringen (Version 5.1 schien noch nicht einmal richtig gejart worden zu sein, und 5.0 schien Bugs im Code zu haben). Aber es gibt ja genug Alternativen, und Junit Addons erfüllt diese Rolle – die Klasse junitx.util.PrivateAccessor, um genau zu sein. Diese Klasse ist sehr leicht zu nutzen. Nehmen wir mal an, wir wollen die folgende Methode testen:

 class RocketScience { private static boolean isPrime(int number) { ... } } 

Und hier ist der Test Code, der diese Methode testet:

 public void testIsPrimeExpectFalse() throws Throwable { Object isPrime = PrivateAccessor.invoke( RocketScience.class, "isPrime", new Class[] { Integer.TYPE }, new Object[] { new Integer(8) }); assertEquals(isPrime, Boolean.FALSE); } 

Diese Beispiel zeigt auch sehr schön, wie wir die Konvertierung von Primitives (int, boolean, etc.) zu Objekten durchführen, denn Reflektion funktioniert nur für Objekte. Natürlich würde man eine Methode wie diese in der Praxis nie Privat machen, sondern in einer Werkzeugklasse verfügbar machen – aber das ist ja nicht der Punkt von diesem Beispiel.

Die Sache hat einen einzigen Haken: Der Compiler (und die IDE) kann keine Korrelation zwischen diesem Test under der getesteten Methode erkennen, und wenn die Methode umbenannt wird, wird dieser Test nicht erkannt. Aber das ist in Ordnung – denn der Test wird versagen, und kann schnell und einfach repariert werden.

Using procmail with the Courier MTA and virtual mailboxes

It was tricky, as it wasn’t clear on how to tell procmail where to get its configuration and the processed files. First, the Courier Documentation clearly says how to do this with non-virtual mailboxes. In the /etc/courier/courierd configuration file, change the line

 DEFAULTDELIVERY=./Maildir 

to

 DEFAULTDELIVERY="| /usr/bin/preline /usr/bin/procmail" 

But this in itself doesn’t work – because procmail tries to process mail for the virtual mailman account (vmailman). The home directory for vmailmain is /var/mail, so it looks for /var/mail/.procmailrc. But procmail complains because of the permissions on that directory, and I really don’t want to change them anyway. And even if I change them, I won’t be able to distinguish the various virtual users (which each have directories under /var/mail).

In the end things were simple, because courier conveniently calls procmail in the virtual user’s home directory (e.g. /var/mail/user1. procmail takes a configuration file as an argument, so the following line in /etc/courier/courierd does the trick:

 DEFAULTDELIVERY="| /usr/bin/preline /usr/bin/procmail ./.procmailrc" 

I still need a custom .procmailrc file in each virtual user directory (because procmail needs absolute paths), but that’s something I can live with.

Don’t worry – it’s getting better after Monday

The components of the formular are weather, debt, money due on January’s pay day, the time since Christmas, the period since the failure to quit a bad habit, general motivational levels and the need to take action and do something about it.

As I said, it can only get better…

Ringe in Molekülen

Graf Propagations-Applet
Weiter Unten >>

Disclaimer: Den hier beschriebenen Algorithmus benutzen wir zur Zeit nicht bei meinem Arbeitgeber, und ich habe ihn in meiner Freizeit entwickelt. Die Aufgabe wurde lediglich durch meine Arbeit inspiriert.

Übrigens, Sie können per Email benachrichtigt werden, wenn ein neuer Newsletter veröffentlicht wird. Einfach ein Profil einrichten – keine Sorge, ich verspreche, nicht zu Spammen!

Was ist überhaupt das Problem? Rechts ist ein Molekül abgebildet. Falls Sie sich wundern, daß viele Verbindungen kein Atomzeichen haben: Es ist üblich, Kohlenstoff (C) implizit durch die Ecken darzustellen, und Wasserstoff (H) wird nie gezeichnet. Aber das berührt unser Problem nicht.

Wieviele Ringe hat dieses Molekül? Auf den ersten Blick wissen wir, daß es vier sind. Allerdings würde ein Algorithmus wahrscheinlich fünf sehen. Warum? Der Doppelring links oben enthält zwei kleine Ringe, und einen beide kleinen Ringe umspannenden größeren Ring. Wie ich weiter unten beschreiben werde, müssen wir diese Ringe später wieder entfernen.

Wie sollen wir Ringe repräsentieren? Dazu zog ich Robert Sedgewick’s “Algorithms in C++” zu Rate (eine uralte Edition – inzwischen gibt’s auch eine Java Ausgabe). Denn ein Molekül kann als Graf dargestellt werden. Ein Graf besteht aus Punkten (Atomen), und Kanten zwischen diesen Punkten (Bindungen). Sedgewick schlägt zwei Datenstrukturen vor, um Grafen intern zu speichern. Für dieses Problem bietet sich die “adjacency-structure” Representation an. Bei dieser Representation haben wir eine Liste mit allen Punkten, die wiederum mit einer Liste von verbundenen Punkten assoziiert sind. Zum Beispiel würden wir die folgende Datenstruktur für Wasser (H1-O-H2) bekommen:

 H1 -> [ O ] H2 -> [ O ] O  -> [ H1 H2 ] 

Beachten Sie, daß jede Bindung zweimal auftaucht. Den “verschwendeten” Speicherplatz nehmen wir gerne in Kauf. In einem Molekül sind nicht alle Bindungen gleich (einfach, doppelt, etc.). Das könnten wir speichern, indem die Einträge in der Liste Datenstrukturen sind, die diese Information auch noch aufnehmen. Um unsere Ringe zu finden, ist der Bindungstyp allerdings unwichtig.

Unser erstes Ziel ist es, den gesamten Graf abzugrasen, und zwar immer entlang der Kanten. Dabei gibt es natürlich viele, viele Wege. Sedgewick bietet zwei Algorithmen an mögliche Wege zu finden: der eine geht in die Tiefe, der andere in die Breite. Hier ist ein Diagram aus seinem Buch das den Unterschied visualisiert:

Die roten Linien zeigen die ersten Schritte eines tiefen bzw. breiten Wanderalgorithmusses. Der tiefe springt so schnell wie möglich von Punkt zu Punkt, und kehrt nur dann zu Abzweigungen zurück, wenn es nicht weiter geht. Der breite folgt allen möglichen Abzweigungen, und geht erst dann weiter vorwärts, wenn alle Abzweigungen besucht wurden. Ich denke, es ist intuitiv klar, daß der breite Algorithmus kleine, geschlossene Ringe findet. Mit dem folgenden Applet können Sie selbst Grafen erstellen, und sie mit dem gleich beschriebenen Algorithmus propagieren lassen:

Ihr Browser unterstützt nicht das <APPLET> tag!
Klicken erzeugt einen Punkt. Ziehen von einem Punkt zum anderen erzeugt eine Kante. Zum Propagieren, einen Punkt anklicken.

Weiß: Noch nicht besucht
Rot: Punkt wird besucht
Gelb: Punkt wird untersucht
Grau: Punkt wurde besucht

Aber wie funktionieren die Algorithmen, und wie benutzen wir sie? Ich werde hier nur den breiten beschreiben, weil wir den benutzen. Hier soll nur bemerkt werden, daß die Algorithmen sich ähneln, und daß der tiefe Algorithmus leicht rekursiv zu programmieren ist, während der breite sich gut als Schleife schreiben läßt. Und hier ist der Algorithmus:

Map graf; // Object -> Set von verbundenen Objekten Set visited; // Set von besuchten Objekten void visit(Object head) { List queue = new ArrayList(); queue.add(head); while (! queue.isEmpty()) { Object entry = queue.remove(0); visited.add(entry); // hier entry verarbeiten Set neighbors = (Set)graf.get(entry); for (Iterator i = neighbors.iterator(); i.hasNext();) { Object neighbor = i.next(); boolean wasVisited = visited.contains(neighbor); if (! wasVisited) queue.add(neighbor); } } } 

Ein paar Kommentare:

  • Der Graf ist in der Variablen graf in der form einer Map gespeichert. Die keys sind die Knoten, die mit einem Set assoziiert sind, welches die verbundenen Knoten enthält.
  • Das Set visited enthält die Knoten, die bereits besucht wurden, und muss vor jeder neuen iteration zurückgesetzt werden.
  • Wenn die Funktion “visit” aufgerufen wird, werden alle verbundenen Punkte entlang ihrer Kanten berührt. Sollte der Graf nicht verbunden sein, so kann man einfach für alle Punkte im Graf (also über graf.getkeys() iterieren) visit aufrufen.

Ich hoffe, daß dieser Algorithmus, im Zusammenhang mit dem Applet die Zusammenhänge verständlich macht. der gesamte Code für das Applet ist verfügbar. Falls Sie mit dem Code experimentieren möchten, können Sie weitere Implementierungen des Interfaces Crawler erstellen.

  • Crawler – ein Interface für die Implementierung von Algorithmen.
  • WidthCrawler – Implementierung eines Crawlers, der in der Breite sucht.
  • Visitor – Das Visitor Interface ist ein Argument für den Crawler, um beim Besuch eines Knoten Code ausführen zu können.
  • DrawingCanvas – Die Benutzeroberfläche: Swing Canvas der es dem Benutzer ermöglicht, Grafen zu zeichnen und die Propagation visuell auszuführen.
  • GrafDemo – Die Klasse stellt den Einstiegspunkt ins Programm zur Verfügung, das als Applet oder als Java Anwendung ausgeführt werden kann.

Wir haben zwar eine Menge geschafft heute, aber es gibt noch einiges zu tun, bis wir die Ringe haben. Vielleicht werde ich das Thema in der Zukunft noch einmal ansprechen. Falls nicht, hier sind die Schritte, die wir durchführen müssen, um die Ringe zu finden:

  • Den Propagator anhalten, sobald der Anfangspunkt wiedergefunden wurde, ohne Ecken zweimal zu benutzen (einmal vor und zurück gilt nicht!). Dann haben wir nämlich einen Ring gefunden.
  • Den Propagator für jedes Atom einmal ausführen. Damit finden wir alle Ringe, denn jeder Ring hat mindestens ein Atom, daß mit keinem anderen Ring geteilt wird.
  • Ringduplikate ausfiltern!
  • Doppelringe wie oben beschrieben rausfiltern. Das machen wir, indem wir Ringe suchen, die zwei oder mehr Kanten gemeinsam haben. Den größeren von den zweien entfernen wir.

Bleibt nur noch die Frage, ob wir mit diesem Algorithmus wirklich alle Ringe finden. Außerdem könnten wir noch die Performance des Algorithmus untersuchen. Ich überlasse dies gerne dem Leser.

Tsunami Disaster

I was shocked and speechless, as within a few days the death toll from the Tsunami rose from 10,000 to over 130,000, and still rising. Please donate!

Der Spring Container (oder: Dependency Injection)

Die Beispielanwendung (und warum Sie beim Start eine Warnung bekommen)
Die Beispielanwenung benötigt Java Webstart zum Laufen – und wenn Sie ein Java Entwickler sind, haben sie die Software auch schon installiert. Leider brauche ich mehr zugang zu Ihrem System, als der normale SecurityManager zuläßt. Um genau zu sein, Spring benutzt Reflektion (getDeclaredConstructors()) um Objekte zu instantiieren. Daher müssen alle jars zertifiziert sein. Das habe ich gemacht, allerdings kann ich mir im Moment keinen Schl¨ssel von Verisign leisten, und habe meinen eigenen Schlüssel erstellt, der dementsprechend in keiner zentralen Datenbank zu finden ist.

Spring Demo Ausführen >>
Code runterladen >>

Zunächst einmal: Spring ist wesentlich mehr als der Container den ich gleich beschreiben werde. Spring bietet Aspect Oriented Programming (AOP), Transaktionsmanagement, Metadata-Unterstützung (ähnlich wie JDK 1.5 Metadata, orthogonal zu XDoclet), und viel Unterstützung für Datenbankoperationen (inklusive der Unterstützung von O/R-Mappern wie Hibernate oder JDO). Die Englische Onlinedokumentation ist excellent!

Das klingt zwar so, als gäbe es hier keine Struktur; aber trotz der Vielfalt ist Spring seinen Grundprinzipien treu: (1) Den Programmierer nicht einschränken; (2) Guten Programmierstil unterstützen; (3) Das Rad nicht neu erfinden.

BeanFactory und ApplicationContext

Der grundliegenste Aspekt von Spring ist die BeanFactory – der ApplicationContext ist lediglich eine erweiterte BeanFactory mit Unterstützung für AOP, Internationalisierung, etc. Die Beispielanwenung benutzt eine XMLBeanFactory, und in der Regel werden die Beans per XML definiert. Schau’n wir uns doch erst einmal an, wie eine Bean Definition aussieht, und untersuchen dann, warum so etwas sinnvoll ist.

Die BeanFactory kann jede Art von Objekt enthalten, aber sie ist besonders für JavaBeans geeignet. Zum Experimentieren habe ich die folgende Klasse erstellt:

public class SampleBean { private String name = "(no name)"; private Set friends = new HashSet(); public Set getFriends() { return friends; } public void setFriends(Set friends) { this.friends = friends; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String toString() { return name + friends; } } 

Die Klasse ist eine JavaBean, denn sie hat (1) einen Default Konstruktor und (2) Setters und Getters, die dem JavaBean Standard entsprechen. Wenn wir so eine Klasse im Spring Container erstellen wollen, dann stecken wir das folgende XML in die Containerdefinition:

<bean id="aSampleBean" class="de.jastram.SampleBean"> <property name="name"> <value>Sample Bean Name</value> </property> <property name="friends"> <set> <value>123</value> <value>Hello, World</value> </set> </property> </bean> 

Das können Sie gleich mit der Beispielanwendung ausprobieren! Wenn auf dem linken Tab das XML editiert wird, werden die Änderungen auf dem rechten Tab reflektiert.

Alles Singletons

Soweit, so gut. Wir können also über XML Java Objekte erstellen. Wir kommen auch leicht an die Objekte ran – das Interface BeanFactory hat methoden um Beans per Name zu finden. Wenn wir also eine Referenz zu unserer BeanFactory verfügbar halten, kommen wir an unsere Beans ran. Normalerweise haben wir nur Singletons im Container – und das wollen wir normalerweise auch. Allerdings ist es auch möglich, “Prototypen” im Swing Container zu haben – dann wird bei jedem Aufruf von getBean() ein neues Objekt erstellt. Dazu wird einfach singleton="false" dem <bean> Tag hinzugefügt.

Eine typische Anwendung benutzt ein DataSource Objekt, das mit einer Datenbank assoziiert ist. Es wird einmal erstellt, konfiguriert, und kann dann von überall dort benutzt werden, wo der Container verfügbar ist.

Aber gerade ein DataSource Objekt wollen wir nicht unbedingt per Constructor erstellen, oder? Und hier glänzt Spring wieder: Es gibt weitere Möglichkeiten, Objekte zu erstellen: Factories. Factories sind ganz normale Objekte. Aber diesmal ist das Objekt nicht das Endprodukt, sondern der “Objektproduzent”. Zum Beispiel, die Klasse java.lang.System hat die statische Methode currentTimeMillis(), die wir als Factory benutzen können – probieren wir das doch einfach mal aus: Kopieren Sie das folgende XML in die Beispielanwendung:

<bean id="systemTimeFactory" class="java.lang.System" factory-method="currentTimeMillis"/> 

Wenn wir uns das resultierende Objekt anschauen, was für ein Klassentyp ist es? Die Antwort ist Long (und nicht System). Übrigens können wir immer noch an das Factoryobjekt herankommen, wenn wir unbedingt wollen, indem wir einfach ein “&” vor den Namen setzen. Also factory.getBean("&systemTimeFactory") gibt uns die Factory.

In diesem Beispiel ist die Factorymethode eine statische Methode – Spring hat selbstverständlich auch die Möglichkeit, eine (nicht statische) Methode eines Singletons als Factorymethode aufzurufen.

Und jetzt…?

Wozu das ganze? Gut strukturierte Anwendungen haben eine Reihe von Singletons, die untereinander verbunden sind. Wie oben schon erwähnt, haben wir fast immer eine DataSource um mit einer Datenbank zu sprechen. Die Logik, die mit der Datenbank kommuniziert, ist normalerweise in Data Access Objects (DAOs) untergebracht. Die Geschäftslogik lebt ebenfalls in Singletons, die nur zu den DAOs sprechen, und darauf sitzt normalerweise eine weitere Schicht (oft Servlets), die zu mit der Geschäftslogik kommunizieren, und die Benutzeroberfläche bilden. Es ist also einzusehen, dass wir viel mit Singletons arbeiten, die untereinander kommunizieren. Spring macht die Verknüpfung dieser Singletons ungleich einfacher.

Und existierende Techniken? Applikation Server wie Tomcat sind zwar ähnlich leistungsfähig, aber beschränken sich auf Servlets im Container. Ein Riesenvorteil von Spring ist, daß es mit POJOs arbeiten kann. Und der Unterschied ist noch viel extremer, wenn wir uns EJB anschauen, daß ohne Codegenerierungssoftware kaum zu bewältigen ist!

Aber die Authoren von Spring sind sich dieser Technologien natürlich bewußt, und haben sehr darauf geachtet, daß Spring problemlos mit diesen Technologien zusammenarbeiten kann – es ist also keine “entweder – oder” Entscheidung notwendig.

Der Spring Container bringt den Anwender dazu, besseren Code zu schreiben. Plötzlich ist klar, wie wir Objekte konfigurieren: Mit JavaBean Setters. Und wenn alle Komponenten unseres Systems plötzlich Setters für die Konfiguration haben (die am Besten auch noch Interfaces wie DataSource statt Klassen als Argument haben), dann wird auch das Testen dieser Komponenten mit Unit Tests und Mock Objekten plötzlich viel einfacher.

Weitere Juwelen in Spring

Ist Ihnen aufgefallen, daß wir <value>1234<value> schreiben, und ein Integer Objekt erhalten? Wie geht das? Der Container hat eine erweiterbare Infrastruktur, die Text in Objekte umwandelt.

Manchmal gibt es nur ein einziges Objekt von einem bestimmten Typ im Container – zum Beispiel nur eine einzige DataSource. In diesem Fall können wir Spring’s auto-wiring (automatisches verbinden) benutzen, um automatisch alle Setters, die eine DataSource als Argument benutzen, mit diesem Objekt aufzurufen. (einfach autowire="byType" der Bean hinzufügen). Auto-wiring per Name ist auch unterstützt (autowire="byName").

Ein heißes Thema heutzutage sind “Interceptors” (Abfänger) – ein zentraler Aspekt von AOP. Ein Interceptor kann vor oder nach dem Aufruf einer Methode eingreifen. Zum Beispiel könnten wir einen Sicherheits-Interceptor entwerfen, der vor dem Aufruf einer Methode prüft, ob der Benutzer genug Befugnisse hat. In einem traditionellem Programm müßte jede Methode extra Code für diesen Zweck haben, oder wir müßten eine gute Proxy-Architektur haben. Mit Spring AOP können wir mit RegExps definieren, welche Methoden abgefangen werden sollen, und den Spring Container informieren, diesen Interceptor zu aktivieren. Die abgefangenen Objekte brauchen davon überhaupt nichts zu wissen!

Schlußbemerkung

Spring hat unglaublich viel für die Enterpriseentwicklung zu bieten – und es ist unglaublich unaufdringlich dabei. Es ist vor allem sehr einfach, Spring hier und da in einer existierenden Anwendung einzuführen, und dann langsam den Einfluß von Spring zu erweitern. Spring ist kein Allheilmittel für alles – aber es ist erfreulich, so ein Leichtgewicht im Reportoir als Alternative zu EJB et. al. zu haben,

KDE or Gnome…?

Why KDE? Because (1) it’s easier to customize, and (2) more like Windows. Let me elaborate:

(1) Maybe I didn’t do things right, but the ability to configure look and feel, font sizes, widget sizes was quite awkward in Gnome. While it is possible to select a specific Theme, it’s quite difficult to fine-tune it without editing configuration files. Well, I don’t mind editing the configuration file for my mail server, because I often access my mail server through a ssh session. But for a system with the only purpuse of giving me graphical access, I’d rather have the ability to fine-tune the system quickly and efficiently within this system. On that account, KDE beats Gnome by far.

(2)Windows… I am not a big fan of Microsoft, and I think they do a bad job on the server side. But they do understand the desktop! There are few things that I miss on Windows (like multiple desktops), and I gut used to their keybindings, and am unwilling to learn something new without a good reason. So I was pleased to see that KDE supported the Windows-Key right out of the box.

Gnome apps under KDE

My biggest struggle was to get Gnome apps look right under KDE. And I am dependent on Gnome (or more acurately, GTK) apps, specifically Firefox, Gimp and Eclipse.

I tried Debian and Suse, and on both distributions the fonts were huge, and the empty space around widgets unproportionally wide, eating up all my real estate. I tried to tinker with the gtk configuration files (.gtkrc and .gtkrc-2.0), but eventually gave up (I’ll tell you why later on).

For a while, I was limping along with workarounds. I used a different Firefox Theme. It didn’t look great, but saved me real estate. I was using the Motif version of Eclipse. Again, it saved me real estate, but it looked horrible

Suse screws up Gnome

When I tried to find some advice online once more, I finally found out why I didn’t go anywhere by editing my .gtkrc files: Suse designed their own hook to make sure Gnome applications would look good under KDE – but they didn’t take users changing the widget set into account, and screwed things up. How to fix it is documented here. Essentially, you have to edit /opt/kde3/bin/startkde to allow the .gtkrc file to be picked up! It looks like an ugly hack to me, but at least it works.

Now I set my .gtkrc and .gtkrc-2.0 files to use the “Simple” theme, and things started to look much, much better! The fonts were still a little too big for my taste, but I could fix that by adding the following entry to my .gtkrc* files: gtk-font-name = "Sans 7".

Now I feel that my Linux System is truly usable on a daily basis, but fixing these things made quite a difference. I hope these notes will be useful for somebody – including myself the next time I set up a Linux box.

Economist calls Bush “incompetent”

To be fair, they call Kerry incoherent, but endorse him nevertheless. The Editorial talks about “two deeply flawed men”. Interestingly, they think that Bush’s biggest mistake was “in dealing with prisoners-of-war by sending hundreds of them to the American base at Guantánamo Bay in Cuba, putting them in a legal limbo, outside the Geneva conventions and outside America’s own legal system.” On the other hand they state that “invading Iraq was not a mistake” – something I disagree, because in my opinion, American military force could have decreased the risk of terrorism elsewhere much more effectively – namely to resolve the Israeli-Palestinian conflict. And the Economist acknowledges that “Israel and Palestine remain in their bitter conflict, with America readily accusable of bias.”

Kerry, on the other hand, receives some harsh words, too, and on foreign affairs they consider him a “ruthless opportunist.” Nevertheless, they acknowlege that his actions (rather than his words) “speak well of his judgment.” I wish him good luck on Tuesday.

Unit Tests: Wohin damit…?

Warum ist es überhaupt wichtig, wo wir die Unit Tests unterbringen? Weil wir die kleinste “Einheit” (Unit) des Systems testen wollen, und die kleinste Einheiten (Klassen, Methoden und Constructoren) sind oft package private oder protected, und nicht immer public. Um leicht auf diese Elemente zugreifen zu können, sollte der Testcode in der selben Package sein. Das gibt uns zwar keinen Zugang zu privaten Variablen und Funktionen, aber wenn die zum Testen notwendig wären, sollte die Architektur der Klasse überprüft werden. Die naive Klassenstruktur wäre dann folgendermaßen:

 src/de/jastram/unit/MyClass.java src/de/jastram/unit/MyClassTest.java 

Mir gefällt diese Struktur nicht (und viele andere Entwickler stimmen mir zu), weil nun der Ordner normalen und Testcode mischt. Das ist aus vielerlei Gründen schlecht: JavaDoc würde die Testklassen enthalten, es ist schwierig, eine Distributionsdatei ohne Testklassen zu erstellen, usw. Diese Probleme könnten zwar mit einem geschickten Ant Skript gelöst werden, aber das Resultat ist nicht elegant, und für neue Entwickler schwer zu verstehen.

Die zweite Lösung gfällt mir wesentlich besser, und ist meine Empfehlung: Testklassen sind in der selben Package, aber in unterschiedlichen Ordnern:

 src/de/jastram/unit/MyClass.java test/de/jastram/unit/MyClassTest.java 

Alle IDEs die ich kenne, unterstützen diese Struktur, und Ant Skripte sowieso. Es ist nicht unüblich, eine Reihe von Sourceverzeichnissen zu haben. Jetzt ist es kinderleicht, JavaDoc zu erzeugen, oder eine JAR ohne die Testklassen zu bauen. Aber diese Struktur läßt zwei Fragen offen: (1) Was tun, wenn wir aus irgendeinem Grund doch Zugang zu privaten Elementen haben wollen, und (2) ist diese Struktur nicht ein bißchen übertrieben für kleine Projekte?

Für Punkt 1 gibt es eine Lösung (auch ohne Reflektion): Wir bringen die Testklasse einfach als static Memberklasse in unserer Hauptklasse unter! Das ist auch eine gute Struktur für Demonstrationen, weil wir nur eine einzige Klasse haben:

 src/de/jastram/unit/MyClass.java 

Und wo ist die Testklasse? In der selben Datei – der Code sieht etwa folgendermaßen aus:

public class MyClass { ... public static class Test extends TestCase { ... } } 

Und wie gesagt, nun können wir sogar auf die privaten Elemente zugreifen. Wie gesagt, diese Architektur muß mit Vorsicht genossen werden, und ist nicht für größere Projekte geeignet. Es ist (fast) unmöglich, das Programm ohne den Testcode zu verarbeiten, es ist noch nicht einmal möglich, die Datei ohne den Testcode zu drucken! Dennoch, für kleine Tests und Demos ist das eine prima Architektur.

Gibt es vielleicht noch bessere Ansätze zur Codeorganisation? Schreibt Eure Meinung weiter unten ins Formum!