Oli's Blog

Motivation

1. Die klassische Herangehensweise

Meist ist die Dokumentation oft die erste Anlaufstelle, um sich mit einer Alt-Anwendung vertraut zu machen. Auch wenn sie oftmals von der Realität abweicht, gibt sie doch einen wertvollen Einblick und wichtige Informationen, die den Einstieg in die Thematik erleichtern.

1.1. Der Ideal-Fall

Im Ideal-Fall ist eine aktuelle Dokumentation vorhanden, die diesen Namen auch verdient und verschiedene Sichten auf die Anwendung erlaubt. Vor allem Übersichts-Dokumente über die Architektur, Infrastruktur und Randbedingen sind hier für die Einarbeitung, aber auch als Nachschlagewerk sehr hilfreich.

Um festzustellen, inwieweit der Code tatsächlich mit der Dokumentation übereinstimmt, sind Testfälle (sofern vorhanden) von eminenter Bedeutung. Sie bilden den Ausgangspunkt, um verschiedene Programmteile zu erkunden und deren Verhalten zu studieren. Die meisten Schwierigkeiten bestehen meist darin, die Testfälle zum Laufen zu bringen.

Hat man die Tests am Laufen, kann man sich an Refactoring-Maßnahmen wagen mit dem Ziel, die Businesslogik stärker zum Vorschein zu bringen und die Lesbarkeit und Wartbarkeit zu erhöhen. Vor allem JEE-Anwendungen sind oftmals over-designed, was eine Einarbeitung meist erschwert.

Mit den neuen Erkenntnisse sollte nochmals die Dokumentation begutachtet werden: welche Dokumente müssen überarbeitet, welche Dokumente können aussortiert oder/und in Form von neuen Testfällen ausgedrückt werden.

1.2. Der Normal-Fall

Die Realität sieht oft ganz anders aus: Die Dokumentation ist oft Teil des Problems und nicht der Lösung. Ehemalige Entwickler sind samt KnowHow im Bermuda-Dreieck des Outsourcings verschwunden und als Test-Umgebung dient das Produktiv-System. Da heißt es dann im Code graben und die Mosaikstücke der ursprünglichen Architektur richtig zu deuten. Alles, was mir dabei hilft, den Source-Code zu verstehen, hilft mir bei der Rekonstruktion des Gesamt-Systems.

Auch die wenigen Test-Ruinen, die man dabei oft noch findet, sind von unschätzbarem Wert, geben Sie doch einen Einblick auf die dynamischen Zusammenhänge. Zusammen mit Aspektorientierten Code-Injektionen kann man darauf aufbauend neue Erkenntnisse über den Zusammenhalt der Code-Bereich gewinnen.

2. Abstecher in die Welt von AOP

Motivation

Neue Projekte auf der grünen Wiese sind selten. Viel öfters wird man mit Altlasten konfrontiert und steht vor der undankbaren Aufgabe, vergangene Architekturen wieder freizulegen und unbekannten Code zu deuten, um das Projekt zu vergangenen Hochkulturen wieder zurückzuführen.

Dabei gibt es verschiedenen Möglichkeiten, dem Code seine Geheimnisse zu entreißen. Ein vielversprechender Ansatz ist dabei der Einsatz von Aspekt-Orientierung und AspectJ, um unbekannte Codestellen zu erschließen und das Programmverhalten zu ergründen. Damit lassen sich:

• Schnittstellen überwachen
• Schnittstellen simulieren
• Events aufzeichen
• Sequenz-Diagramme für ausgesuchte Bereiche generieren
• …

Alles Dinge, die helfen, das Verhalten unbekannter Code-Bereich zu analysieren und Tests für weitere Belastungsproben aufzustellen. Dies kann auch aktuellen Projekten helfen, SW-Erosionen vorzubeugen.

Die klassische Herangehensweise

Am 9. Juli ist es soweit - das Java Forum Stuttgart 2015 und damit auch mein Talk zu SW-Archäologie mit AspectJ steht vor der Tür. Zeit, um einige Begriffe zu klären:

Archäologie ist eine Wissenschaft, die die kulturelle Entwicklung der Menschheit erforscht. SW-Archäologie dagegen ist kein "offizieller" Begriff, steht hier aber für die mühsame Erforschung gewachsener SW-Systeme ("Altlasten"), die Ähnlichkeiten mit Ausgrabungen versunkener Ruinen, der Suche nach weiteren Puzzle-Teilen oder der Deutung unbekannter Code-Stücke ähnelt.

Wer mehr dazu wissen will (und vor allem, wie man mit AspectJ - einer Aspekt-Orientierten Erweiterung von Java - das Graben im Code unterstützen kann), sollte zum Vortrag kommen oder diesen Blog hier verfolgen - für die nächsten Tage sind als Vorbereitung auf das JFS einige begleitende Artikel zu diesem Thema geplant.

Teil 0: Motivation

If you override Object.equals(..) you should also override Object.hashCode(). So your unit test for your class may look like:

    MyClass one = new MyClass();
    MyClass anotherOne = new MyClass();
    assertEquals(one, anotherOne);
    assertEquals(one.hashCode(), another.hashCode();

But does your implementation returns false if the argument is null? Or is a.equals(b) the same as b.equals(a)?

To answer theses questions PatternTesting provides an ObjectTester class which checks that for you:

    MyClass one = new MyClass();
    MyClass anotherOne = new MyClass();
    ObjectTester.assertEquals(one, anotherOne);

But the ObjectTester can do much more for you: it can check all equals implementation of a package hierarchy:

    ObjectTester.assertEqualsOfPackage("java");

For each class in the java package which have overriden the equals method the ObjectTester creates two test objects with the default constructor (if it has one) to verify the implementation.

But stop - what is, if the default constructor creates two different objects which are not equals? E.g. the Date class does it! Then you can exclude classes from the check in different ways:

    ObjectTester.assertEqualsOfPackage("java",
             Pattern.compile("java.*\\.Date"));

Here a Java pattern (which is new in PatternTesting 1.5.1) is used to exclude the Date classes in java.util and java.sql from testing the equals and hashCode implementation.

In a similiar way you can test different properties of your class like Serializable or Comparable with the different XxxTester classes in patterntesting.runtime.junit - try it!

Happy Testing

Das Programm zu den vierten Stuttgarter Test-Tage steht jetzt und ist unter jugs.org/tt2015 online. Die Auswahl des Programmes war nicht ganz einfach, weil wir über 20 Einreichungen aus halb Europa bekommen haben, aber ich denke, es ist eine gelungene Mischung aus verschiedenen Themen, die für's Testen relevant sind.

Die Örtlichkeiten werden wieder die gleichen wie bei den Stuttgarter Test-Tagen 2013 sein, auch wenn damals das WLAN dem Ansturm der Teilnehmer nicht gewachsen war. Aber das soll Vermittlung von Theorie und Praxis keinen Abbruch tun. Wer jetzt Lust bekommen hat, Test-Mittel und neue Kollegen kennenzulernen, sollte sich möglichst bald anmelden - beim letzten Mal mussten wir Interessierte am Ende auf eine Warteliste setzen.

Endlich ist es soweit - Version 1.0 von gdv.xport ist jetzt draußen. Die wichtigsten Änderungen gegenüber der 0.9er-Version sind:

• Unterstützung der 2013er Version des GDV-Datenformats
• Unterstützung aller Satzarten dank der XML-Datei des GDVs
• erhebliche Reduzierung des benötigten Hauptspeichers dank Streaming-API

Weitere Änderungen können den Release Notes entnommen werden.

One of the most exciting features of PatternTesting 1.5 is the chance to log and monitor SQL statements. This feature was introduced with 1.4.1 and is described in SQL Logging and Monitoring - all you have to do is to add patterntesting-rt.1.5.0.jar as library and to use

jdbc:proxy:hsqldb:mem:testdb

as JDBC URL for an in-memory DB (HSQL) - or any other valid JDBC URL, prefixed with "jdbc:proxy:...".

Another improvement of 1.5 is the better performance of the ClasspathMonitor. Especially for large classpathes with more than 20,000 classes it needed some minutes to dump the unused classes and other informations into several files. Now the different infos are collected and dumped much faster. And the ClasspathMonitor should work better now together with the classloader of WebSphere if you use the PatternTesting Agent as described in Enabling ClasspathMonitor in Websphere.

“An optimist stays up until midnight to see the new year in. A pessimist stays up to make sure the old year leaves.”
(Bill Vaughan)

Christmas is a time in which, of all times in the year, the memory of every remediable sorrow, wrong, and trouble in the world around us, should be active with us, not less than our own experiences, for all good.

(Charles Dickens)

Die Seiten zu den Stuttgarter Test-Tage 2015 sind jetzt unter jugs.org/tt2015 online. Ähnlich wie beim letzten Mal wollen wir auch dieses Mal den praktischen und sozialen Teil nicht zu kurz kommen lassen. So ist der Nachmittag wieder für praktische Übungen reserviert, während es am Donnerstag Gelegenheit gibt, sich beim virtuellen Lagerfeuer mit anderen Teilnehmern nicht nur über Java und Testen auszutauschen.

Dafür suchen wir noch Sponsoren, die uns den Abend-Event ermöglichen. Und natürlich suchen wir noch jede Menge Beiträge, um ein attraktives Programm gestalten zu können. Bis zum 15. Februar hat man noch Zeit, seinen CfP einzureichen...

Das 17. Java Forum Stuttgart ist jetzt vorbei. Zeit, einen kleinen Rückblick zu ziehen über Themen und Trends im Java-Bereich.

Ein Thema war natürlich Java 8, das im März veröffentlicht wurde. Nach Java 5 von 2005 ist es das erste Release, das mit Lambdas, Interfaces mit Default-Implementierung oder Streams wieder mit Spracherweiterungen glänzt. Java FX hat mit Java 8 jetzt einen großen Sprung nach vorne gemacht nimmt mächtig Fahrt auf. Leider sind viele Projekte noch in Java 6 gefangen - aber man darf sich als Entwickler schonmal darauf freuen.

Im Web-Bereich geht der Trend eindeutig zu Javascript-Bibliotheken wie jQuery oder AngularJS. Auch ist der Trend zu Javascript als "Bytecode" (GWT, TypeScript, ...) erkennbar. Im Java-Bereich dagegen herrscht immer noch die Qual der Wahl bei den Web-UI-Frameworks: JFS, Vaadin, Wicket, ... - was nehm' ich denn nur?

Bei 1600 Teilnehmer war die Wahrscheinlichkeit relativ hoch, alte Bekannte zu treffen oder sich mit anderen Entwicklern auszutauschen. Dazu dienten auch die 2 BoF-Sessions, die abends stattgefunden haben. Alles in allem war es wieder eine schöne Veranstaltung und ich freue mich schon auf's nächste Jahr.

Letzten Monat gab es einen Festplatten-Crash auf Blogger.de. Während die Daten für diesen Blog hier wieder eingespielt werden konnten, fehlen Bilder und PDFs. Für die kaputte Festplatte wird wohl eine Datenrettung in Auftrag gegeben werden, sodass ich hoffe, dass die fehlenden Dateien im Verlaufe des Julis wieder auftauchen werden.

Bis dahin kann man sich evtl. mit dem Internet Archive behelfen, wenn man die Bilder oder Dateien zu einem bestimmten Blog-Eintrag braucht.

Manche JDBC-Treiber erlauben es, dass SQL-Statements mitprotokolliert werden können. Was aber, wenn dies der Treiber im Projekt nicht kann? Dann gibt es die Möglichkeit auf PatternTesting auszuweichen. Dort gibt es seit 1.4.1 die Möglichkeit, über eine spezielle Proxy-URL einen ProxyDriver anzusprechen, der u.a. die Protokollierung der SQL-Anweisungen übernimmt.

jdbc:proxy:hsqldb:mem:testdb

So sieht z.B. die Proxy-URL für eine HSQL-Datenbank aus. Der Unterschied zur normalen JDBC-URL von HSQL (jdbc:hsqldb:mem:testdb) ist nur der zusätzliche "...proxy:..."-Eintrag in der URL.

Damit die SQL-Anweisung auch tatsächlich im Log erscheinen, muss der Log-Level für patterntesting.runtime.monitor.db auf DEBUG gesetzt werden. Als weiteres Schmankerl kann man die Anzahl der offenen Connections per JMX überwachen.

Genaueres kann im PatternTesting-Wiki unter SQL Logging and Monitoring nachgelesen werden.

The generation of sequence diagrams was slightly improved although it is still marked as "experimental". One bigger news is the support of ProxyDriver as JDBC driver. This allows you to monitor the number of open connections if your configured JDBC URL starts with "jdbc:proxy:...".