Am deutschen Mühlentag, dem 28.05.2012 (Pfingstmontag) zwischen 10.00 und 17.00 Uhr kann die in Sevelen, Nieukerkerstr. 30-32 gelegene Dahlen-Mühle von innen und außen besichtigt werden.

Eine Fotoausstellung 100-mal Dahlen-Mühle zeigt die wechselvolle Geschichte dieser Mühle. Führungen erläutern und erklären, insbesondere auch die in den vergangenen 15 Jahren vorgenommenen erheblichen Sanierungsarbeiten.

Vier Hobby-Künstler haben sich bereit erklärt, diesen Tag mitzugestalten und ihr Handwerk vorzuführen. So geben ein Korbflechter, ein Glaskünstler, eine Schmuckdesignerin und ein Holzbearbeiter interessante Einblicke in ihre Kunst.

Für die kleineren Gäste wird eine Märchen-Oma Geschichten und Märchen der Gebrüder Grimm vorlesen. Wer Lust hat, kann an einem Preisrätsel teilnehmen. Hier sind Rechenkünstler und Geschichtskenner besonders gefordert. Als Hauptgewinn wird eine Übernachtung in der Gästewohnung der Mühle verlost!

Auch das leibliche Wohl bleibt nicht unberücksichtigt. Ab 14.00 Uhr sind Kaffee und Kuchen im Angebot.

Wir freuen uns über viele Besucher und wünschen einen schönen und interessanten Tag.

In der Zwischenzeit hat sich allerdings auch mein Anspruch beim Einsatz einer Software gravierend geändert: Es muß in erster Linie funktionieren! Eingriffe in die Konfiguration, um die Verwendung standardisierter Pfade etc. zu verwenden, kommen nur noch selten vor.

Entsprechend startet meine Anleitung mit der Auswahl des bereitgestellten Installers, nicht der Version für die manuelle Installation.

$ wget http://www.twonkyvision.com/upfiles/twonky-i386-glibc-2.2.5-special-7.0.5.sh

Um einigen Problemen von vorneherein den Boden zu entziehen, sind vor der Ausführung des Installers noch ein Verzeichnis zu erstellen und an eine völlig absurde Stelle als symbolischer Link einzublenden:

$ sudo mkdir /var/opt/twonky
$ sudo ln -s /var/opt/twonky /var/twonky

Danach heisst es: Daumen drücken, denn ein ungeprüftes Installationsskript als root auszuführen, erfordert schon ein wenig Risikobereitschaft.

$ sudo sh twonky-i386-glibc-2.2.5-special-7.0.5.sh

Das ernüchternde Ergebnis:

1. der Installer legt seine Daten unter /usr/local/twonky ab (naja …)
2. der Installer legt leere Medienverzeichnisse unter /twonky ab
3. der Installer terminiert nicht

Bevor wir jetzt anpassen und konfigurieren, muß zunächst der Installer mittels Strg-c beendet werden. Außerdem muß der im Rahmen der Installation gestartete Server noch gestoppt werden.

$ sudo /etc/init.d/twonkyserver stop

Dann korrigieren wir erstmal den Installationsort

$ sudo mv /usr/local/twonky /opt/

und passen die SysV-Datei unter /etc/init.d/twonkyserver an. Aus den Zeilen 26-38 wird Folgendes gemacht:

#===============================[ Setup ]===
WORKDIR1="/opt/twonky"
WORKDIR2="`dirname $0`"
PIDFILE=/var/run/mediaserver.pid
LOGFILE=/var/log/twonky.log
INIFILE=/etc/opt/twonky.ini
APPDATA=/var/opt/twonky

#change this to 0 to disable the twonky proxy service
START_PROXY=1

#change this to 0 to disable the twonky webdav service
START_WEBDAV=1
#===============================[ Script ]===

Damit diese Angaben auch genutzt werden, müssen weitere Anpassungen erfolgen. In Zeile 84 muß das $APPDATA-Verzeichnis für den WebDAV/Proxy-Server hinzufügt werden, so daß die Zeile dann so aussieht:

"${SUPPORT_DAEMON_WORKDIR}/${SUPPORT_DAEMON}" -inifile "$INIFILE" -appdata "$APPDATA" &

Gleiches gilt für Zeile 177ff. Der Bereich soll nach der Änderung so aussehen:

echo -n "Starting $TWONKYSRV … "
"$TWONKYSRV" -inifile "$INIFILE" -logfile "$LOGFILE" -appdata "$APPDATA"
rc_status -v

Anschließend kann der Server erneut gestartet werden, damit eine Konfiguration der Freigaben und anderer Einstellungen über das Webinterface auf Port 9000 erfolgen kann. Ein Hinweis noch, der auch für Version 6 gilt: Es gibt eine Liste von Verzeichnissen, die nicht für Freigaben verwendet werden können. So gehört z.B. /srv dazu, /var/share geht aber.

Entsprechen alle Einstellungen, die über das Webinterface eingestellt werden können den eigenen Vorlieben, ist noch eine letzte manuelle Änderung notwendig: Für das Management von hochgeladenen Medien (auf welchem Wege auch immer), erstellt Twonky das Verzeichnis “/twonky” direkt im root-Verzeichnis. Ein für mich besserer Ort ist /var/opt/twonky/managed. Leider ist die Einstellung (noch) nicht über das Webinterface möglich, also ist nochmal manueller Eingriff in die Konfigurationsdatei /etc/opt/twonky.ini notwendig. Die entsprechenden Parameter werden auf folgende Werte gesetzt:

servermanagedmusicdir=/var/opt/twonky/managed/music
servermanagedpicturedir=/var/opt/twonky/managed/pictures
servermanagedvideodir=/var/opt/twonky/managed/videos

Einen Neustart des Servers später kann kurz aufgeräumt werden …

$ sudo rm -r /twonky
$ sudo rm -f /var/twonky

… und schon stehen die Medien für den Abruf zur Verfügung. Die Informationen zur Transkodierung und Vorschaubild-Erstellung können der Anleitung für Version 6 entnommen werden. Dabei auf geänderte Pfade achten!

Nach einem Jahr Pause stehen ausgedehnte Einblicke in den Japan-Garten, den Park und die Bereiche rund um die Dahlen-Mühle zur Verfügung. Und wie immer wird sich auch dieses Mal sicherlich die Gelegenheit für einem Plausch unter Gartenfreuden ergeben.

Die Gartenpforte ist jeweils von 10 – 17h geöffnet

• am 19./20. Mai 2012,
• am 16./17. Juni 2012 und
• am 21./22. Juli 2012.

Der Eintritt ist frei, es wird um eine Spende von 3€ für den Museumsverein Dahlenmühle e.V. gebeten. Verbinden Sie Ihren Besuch doch mit einer Übernachtung in unserer Gästewohnung!

Die Wahl der Software fiel dabei auf den TwonkyServer der PacketVideo Corporation, ein kommerzielles aber bezahlbares closed-source Produkt der TwonkyMedia Suite. Für die Installation unter Ubuntu 10.04 Lucid Lynx mussten einige Informationen zusammengesucht werden, die ich hier gesammelt zur Verfügung stelle.

Hinweis: Twonky hat kürzlich den Twonky Server in der Version 7.0 veröffentlicht, der mit dieser Beschreibung nicht eingerichtet werden kann. Die hier gemachten Angaben sind also ausschließlich auf die Version 6 anwendbar.

Mein Heimserver ist ein stromsparender PC auf Intel Atom 330 Basis mit Ubuntu Linux 10.04.2 LTS (Lucid Lynx) in der 64-Bit Server-Variante. Angesprochen wird die Maschine ausschließlich per SSH oder Browser, einen Bildschirm gibt es nicht.

Falls bisher noch keine 32-Bit-Applikation installiert wurde, muß zunächst ein Paket zur Kompatibilität installiert werden.

$ sudo apt-get install ia32-libs

Zur Installation des TwonkyServers habe ich mich für das einfache ZIP-Archiv entschieden. Der Installer funktioniert zwar grundsätzlich, bot mir aber nicht genug Kontrolle über die Installation.

$ wget http://www.twonky.com/upfiles/twonkymedia-i386-glibc-2.2.5-6.0.38.zip

Gemäß des Linux FHS werden die eigentlichen Programmdateien unter /opt/twonkymedia installiert.

$cd /opt
$ sudo unzip twonkymedia-i386-glibc-2.2.5-6.0.38.zip
$ sudo ln -s twonkymedia-6.0.38 twonkymedia

Dann werden das mitgelieferte Start/Stop-Skript und die Beispiel-Konfiguration an entsprechende Stellen kopiert.

$ sudo cp /opt/twonkymedia/twonkymedia.sh /etc/init.d/twonkymedia
$ sudo chmod +x /etc/init.d/twonkymedia
$ sudo cp /opt/twonkymedia/twonkymedia-server-default.ini /etc/opt/twonkymedia.ini

Als nächstes stehen Anpassungen an diesen beiden Dateien an. In der Start/Stop-Datei werden zunächst einige Pfade gesetzt. Ohne diese Anpassungen tendiert TwonkyServer dazu, sich im gesamten System zu verteilen.

Ich bin vim-Freund, natürlich kann auch jeder andere Editor zum Einsatz kommen.

$ sudo vim /etc/init.d/twonkymedia

Ab Zeile 28 wird der Setup-Bereich modifiziert:

#==================================================================[ Setup ]===

WORKDIR1="/opt/twonkymedia"
WORKDIR2="`dirname $0`"
PIDFILE=/var/run/mediaserver.pid
LOGFILE=/var/log/twonkymedia.log
INIFILE=/etc/opt/twonkymedia.ini
APPDATA=/var/opt/twonkymedia/config

#=================================================================[ Script ]===

Gerne hätte ich auch den Namen des PID-Files geändert, aber dies wird vom Server nicht unterstützt. Ab Zeile 94 überredet man den Server-Prozeß zur Verwendung der neuen Werte. Außerdem wird duch das Entfernen des -D Parameters der Dienst nicht mehr im Dämon-Modus gestartet:

"$TWONKYSRV" -inifile "$INIFILE" -logfile "$LOGFILE" -appdata "$APPDATA"

Jetzt geht es in die Konfigurationsdatei. Hier sind ebenfalls einige Pfade zu setzen, damit der Server innerhalb der angedachten Grenzen des Filesystems bleibt.

$ sudo vim /etc/opt/twonkymedia.ini

Meine Medien liegen unter /var/share in Unterverzeichnissen. Entsprechend des eigenen Setups ist mindestens der Parameter “contentbase” anders zu belegen.

Wichtig: Es ist eine ausgiebige Liste an “black listed” (ignorierten) Verzeichnissen in TwonkyServer eingebaut in denen nicht gesucht wird, auch wenn sie durch contentbase und contentdir eigentlich erfasst werden! Die Liste findet sich im Twonky Forum.

Der vorhandene, überschaubare Bestand an Optionen wird auf den folgenden Stand ausgebaut bzw. geändert:

contentbase=/var/share
contentdir=+A|/audio,+P|/image,+P|/video
followlinks=0
radio=0
readdbondemand=0
ignoredir=AppleDouble,AppleDB,AppleDesktop,TemporaryItems
suppressmenu=divAutoShare
cachedir=/var/cache/twonkymedia
dbdir=/var/opt/twonkymedia/db
servermanagedmusicdir=/var/opt/twonkymedia/managed/music
servermanagedpicturedir=/var/opt/twonkymedia/managed/pictures
servermanagedvideodir=/var/opt/twonkymedia/managed/videos
onlinedir=/var/cache/twonkymedia/online-data
mediastatisticsdir=/var/opt/twonkymedia/statistics
rmhomedrive=/var/opt/twonkymedia/db
bgtrans=JPEG=1,MP3=0,MPEG2=1,WMV=0,MPEG4=0,Flash=0
language=de

Bevor der Server jetzt gestartet wird, sind noch einige Pakete zu installieren, damit das Transcoding (die Wandlung von Video- und Audioströmen in ein Format) funktioniert. Den entsprechenden Hinweis habe ich diesem Post entnommen.

$ sudo apt-get install libavcodec-unstripped-52 libavdevice-unstripped-52
 libavformat-unstripped-52 libavutil-unstripped-49 libpostproc-unstripped-51
 libswscale-unstripped-0 ffmpeg

Nun ist der Pfad zu ffmpeg in der entsprechenden Datei einzutragen,

$ sudo vim /opt/twonkymedia/cgi-bin/ffmpeg.location

so daß sie nun folgenden Inhalt hat:

/usr/bin

Gleiches wird nun für das Matroska Container-Format eingestellt:

$ sudo touch /opt/twonkymedia/cgi-bin/ffmpeg-mkv-mpeg.desc
$ sudo chmod 644 /opt/twonkymedia/cgi-bin/ffmpeg-mkv-mpeg.desc
$ sudo vim /opt/twonkymedia/cgi-bin/ffmpeg-mkv-mpeg.desc

Die neue Datei erhält folgenden Inhalt:

exec: ffmpeg -threads 2 -i $infile -vcodec mpeg2video -sameq -acodec copy -f vob -copyts -y $outfile
# capabilities
from=video/x-matroska
to=video/mpeg
synchronous
priority=idle

Mit Version 6.0.34 hat eine neue Datei Einzug gehalten, welche zur Anlage von Vorschaubildern (thumbnails) für Videos verwendet wird. Leider gibt es hier einen Fehler beim Aufruf von ffmpeg (zumindest unter Ubuntu 10.04 LTS), so daß statt Vorschaubildern nur Fehler durchs Log rasseln. Man ändere in der Datei /opt/twonkymedia/cgi-bin/ffmpeg-video-thumb.desc die Zeile 3 von

exec: ffmpeg  -itsoffset -$videothumbtime  -i $infile …

zu

exec: ffmpeg  -itsoffset $videothumbtime  -i $infile …

Sprich – das führende Minus vor $videothumbtime muß entfernt werden.

So, das war’s – die restlichen Parameter lassen sich einfacher über das Webinterface einstellen. Zeit den Server zu starten …

$ sudo /etc/init.d/twonkymedia start

Wenn der Start erfolgreich war, steht der Server jetzt auf Port 9000 zur Verfügung. Als letzten Schritt kann der TwonkyServer noch automatisch beim Hochfahren der Maschine gestartet werden:

$ sudo update-rc.d twonkymedia defaults

Falls es wider Erwarten Probleme beim Start gibt, liefert das Logfile unter /var/log/twonkymedia.log vielleicht eintscheidende Hinweise.

In einer kurzen Sequenz ist ab 00:15min die Dahlenmühle zu sehen, vor welcher der historische Reisebus das Gelände verlässt. Nur für Familienmitglieder zu erkennen, zieht im Hintergrund Fabian Dahlen auf dem Fahrrad seine Kreise.

Die Themenseite zur Serie ist unter http://www.landundlecker.wdr.de/ zu erreichen, ein Mitschnitt der Sendung wird als Flash-Film bereitgestellt.

Weitere Details, Bilder und Preise finden Sie unter http://www.dahlen.org/gaestezimmer/.

Wie auch bei bei seinen Schwestern Pia und Ina fand die Entbindung im Krankenhaus Krefeld-Uerdingen statt. Trotz seines leichten Frühstarts geht es Kai und seiner Mutter gut, die „Eckdaten” sind: 52cm Körpergröße, knapp 3.000 Gramm Gewicht.

Wir alle wünschen Kai, seinen Schwestern und seinen Eltern alles Gute!

package demo.api;

public interface IQuoter {
        String quote(String s);
}

Dazu steuern die Entwickler eine Implementierung für den deutschen Sprachraum bei, welcher tief- und hochgestellte Anführungszeichen verwendet (über Unicode):

package demo.impl;

public class GermanQuoter implements IQuoter {
        public String quote(String s) {
                return '\u201E' + s + '\u201D';
        }
}

Die Frage ist nun, wie kann man diese Implementierung verwenden,

• ohne sie direkt in der Applikation zu importieren und
• ohne sie direkt in der API zu referenzieren?

Die Lösung ist interessanterweise bereits seit dem JDK 1.3 Teil der Java Standard Edition (SE), auch wenn sie zwischen den Versionen einige Male den Platz gewechselt hat. Mit Java 6 scheint sie nun aber ihren endgültigen Platz gefunden zu haben als java.util.ServiceLoader.

Dafür muß die Implementierung als eigenes JAR ausgeliefert werden, denn folgende Punkte sind Voraussetzung für die Nutzung des ServiceLoader:

1. im JAR muß ein Verzeichnis META-INF/services vorhanden sein
2. in diesem Verzeichnis muß für jede API Klasse (Interface oder abstrakte Klasse) eine Datei gleichen Namens liegen
3. in jeder dieser Dateien muß der vollqualifizierte Namen der Implementations-Klasse vermerkt sein

Für unser Beispiel bedeutet das also, daß der Inhalt des Implementierungs-JAR wie folgt aussieht:
demo.impl.GermanQuoter
META-INF/services/demo.api.IQuoter

Und die einzige Zeile in der Datei demo.api.IQuoter liest sich wie folgt:
demo.impl.GermanQuoter

Wie kommt nun unsere Applikation, welche die API und das Implementierungs-JAR im Klassenpfad hat an die Implementierung? Nun, über Aufruf der entsprechenden Service Locator, welche sich je nach JDK an verschiedenen Stellen finden:

• im JDK 1.3 als sun.misc.Service
• im JDK 1.4 – 1.5 als javax.imageio.spi.ServiceRegistry(!)
• seit dem JDK 1.6 endlich an richtiger Stelle als java.util.ServiceLoader

Also schreiben wir uns für das JDK 1.6 eine kleine, generische Utility-Klasse, welche eine oder alle Implementierungen für eine API-Artefakt liefern kann:

package demo.util;

import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import java.util.ServiceLoader;

public final class GenericServiceLocator {

    private GenericServiceLocator() {
    }

    public static <T> T locate(final Class<T> clazz) {
        final List services = locateAll(clazz);
        return services.isEmpty() ? (T) null : services.get(0);
    }

    public static <T> List<T> locateAll(final Class<T> clazz) {

        final Iterator<T> iterator = ServiceLoader.load(clazz).iterator();
        final List<T> services = new ArrayList<T>();

        while(iterator.hasNext()) {
            try {
                services.add(iterator.next());
            } catch (Error e) {
                e.printStackTrace(System.err);
            }
        }

        return services;

    }
}

Und so sieht dann der Aufruf aus unserer Beispiel-Applikation aus:

package demo;

import demo.api.IQuoter;
import demo.util.GenericServiceLocator;

public class App {
    public static void main( String[] args ) {
        System.out.println(
                GenericServiceLocator
                    .locate(IQuoter.class)
                    .quote("Quote Me")
        );
    }
}

Das ist alles. Befinden sich API, Implementierung und Applikation im Klassenpfad, kann der Test über den Aufruf von
java -cp demo-api.jar;demo-impl.jar;demo-app.jar demo.App
erfolgen. Das Ergebnis sollte auf Unicode-Terminals ein „Quote Me” sein. Auf der Windows XP Console ist es übrigens äQuote Meö …

Zum Ausprobieren ist das Beispiel-Projekt als Maven2 Multi-Module beigefügt, die Verwendung in eigenen Projekten ist – selbstverständlich – gestattet.

Metriken

Viele der eingesetzen Werkzeuge (wie JDepend, CAP, SonarJ) verwenden Metriken, die bereits 1994 von Robert Martin als OO Design Quality Metrics[1] definiert wurden. Die maßgeblichen Kennzahlen dabei sind:

• die Abstraktheit (abstractness, A) einer Kategorie
• die Instabilität (instability, I) einer Kategorie
• die Distanz (distance, D) einer Kategorie zur Ideallinie, der sog. main sequence

Der Begriff „Kategorie” beschreibt in diesem Kontext eine logische Gruppierung innerhalb der Architektur, hierbei könnte es sich z.B. um eine Java Library, ein Java Package oder ein Maven Modul handeln.

Abstraktheit

Die Abstraktheit wird nun aus dem Verhältnis von „abstrakten” (N_a) zur Summe aller Klassen gebildet (abstrakte und „konkrete”, N_c). Im Java-Kontext schließt die Qualifizierung als „abstrakt” dabei auch Interfaces mit ein. Es gilt:

A = N_a : (N_a + N_c)

Der Wertbereich ist [0,1], kann also als Prozentzahl wiedergegeben werden. 0% bedeutet, das die Kategorie ausschließlich aus konkreten Klassen besteht, 100% bedeutet, daß die Kategorie ausschließlich aus abstrakten Klassen oder Interfaces besteht.

Instabilität

Zur Bestimmung der Instabilität verwendet R. Martin die Abhängigkeiten einer Kategorie von anderen Kategorien. Dabei unterscheidet er zwischen eingehenden Abhängigkeiten (afferent couplings, C_a) und ausgehenden Abhängigkeiten (efferent couplings, C_e).

Afferent couplings sind also Abhängigkeiten, welche andere Kategorien in die betrachtete Kategorien haben, efferent couplings sind Abhängigkeiten, welche die betrachtete Kategorie in andere Kategorien hat.

Wieder wird das Verhältnis gebildet, es gilt:

I = C_e : (C_e + C_a)

Auch hier kann der Wertebereich [0,1] in Prozent ausgedrückt werden. Je mehr ausgehende Abhängigkeiten eine Kategorie hat, desto höher ist der Grad an Instabilität. I ist also 0 für Kategorien, die keinerlei ausgehende Abhängigkeiten haben und 1 für Kategorien, die ausschließlich ausgehende Abhängigkeiten haben.

Main Sequence

Die für eine Kategorie ermittelte Abstraktheit A und Instabilität I lassen sich hervorragend als Achsen eines Graphen verwenden. Jede Kategorie kann dann als Koordinate in das System eingetragen werden. Doch welche Aussage lässt sich aus ihrer Plazierung machen?

A=1, I=0

eine Kategorie, die zu 100% abstrakt ist und keinerlei ausgehende Abhängigkeiten hat, ist eine API. Interfaces und abstrakte Klassen definieren dabei die notwendigen Operationen, welche durch eine konkrete Implementierung zu realisieren sind

A=0, I=1

eine Kategorie, die zu 0% abstrakt ist und ausschließlich abgehende Abhängigkeiten hat, ist eine Implementierung. Am Ende der Vererbungskette realisiert sie z.B. eine API

A=1, I=1

eine Kategorie, die zu einem hochgradig abstrakt ist und andererseits ausschließlich abgehende Abhängigkeiten hat, stellt keinen erstrebenswerten Zustand dar. Als API ist sie zu instabil, als Implementierung müssten konkrete Klassen vorhanden sein

A=0, I=0

Kategorien, welche stabil und konkret sind, haben ihre Berechtigung als geschlossenes, kleines System. Ein klassisches Beispiel dafür ist das typische HelloWorld.java, lässt man die Abhängigkeiten zu den JRE/JEE Bibliotheken außen vor. In größeren Architekturen wird dieser Punkt vermutlich nie erreicht werden.

Metriken nach R. Martin

In der Theorie von R. Martin bildet die Strecke zwischen den Extremen von A und I nun die sog. Main Sequence (A + I = 1). Sie beschreibt das Verhältnis zwischen Abstraktheit und Instabilität, welches als ausgewogen (balanced) gilt.

Distanz

Die oben beschriebenen Kennzahlen dienen bisher nur der Einordnung einer Kategorie in den Graphen. Zur Bestimmung der „Güte” einer Kategorie empfiehlt R. Martin nun die Berechnung der Distanz (distance) einer Kategorie von der main sequence. Es gilt:

D = |(A + I – 1) : 2|

oder einfacher (um einen Wert zwischen 0 und 1 zu erhalten):

D = |A + I – 1|

Ziel des objekt-orientierten Design sollte es nun sein, die Distanz nahe an 0 zu bringen, etwa indem man ausgehende Abhängigkeiten eliminiert und damit die Stabilität erhöht, oder Kategorien in APIs mit hoher Abstraktheit und Implementierungs-Bereiche unterteilt.

Fazit

Die oben aufgeführten Metriken können eine Hilfe beim objekt-orientieren Design bzw. der objekt-orientierten Analyse sein. Man sollte sich ihnen aber nicht blind unterwerfen, denn wie immer gilt: Das Ideal im Blick, das Projektziel unter den Fingern.

¹ Robert Martin: OO Design Quality Metrics – An Analysis of Dependencies, 1994