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.

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/.

Nachdem der Japan-Garten nach der überreichen Rho­do­den­don­blüte inzwischen wieder zu einem Garten der Stille geworden ist, der Körper und Geist zum Entspannen und Meditieren einlädt, lassen an anderer Stelle die Rosen und die ersten Hortensien ein buntes Blumenmeer erwarten.

Der Eintritt ist frei, es wird um eine Spende von 3€ für den Museumsverein Dahlenmühle e.V. gebeten.

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

Was soll vermittelt werden und an wen?

Die Antwort auf die Frage „was” ist interessanterweise ein Ausschluß: keine persönlichen Dinge. Nichts, was man nicht im lokalen Käseblättchen veröffentlichen oder von außen an die Haustüre kleben würde.

Und darum beinhaltet diese Site aktuell nicht mehr als grundsätzliche Familien- und Personen-Daten, nichts was man nicht auch anderswo erfahren kann. Vorbei die Zeiten scheußlicher Jugendphotos oder peinlicher Teenager-Erinnerungen. Natürlich bin ich mir bewusst – Tante Google vergisst nicht!

Für den zweiten Aspekt der Frage, das „wer” gibt es eine einfache Antwort: Jeder, den es interessiert. Betrachtet man die Logfiles von dahlen.org der letzten Monate, so ergibt sich ein beständiges, stabiles Interesse an der Dahlenmühle und dem anliegenden Garten. Dazu tragen sicherlich die Galerie und die regelmässigen Termine, wie der Mühlentag und die „Offene Gartenpforte” bei. In Zukunft wird dieser Bereich daher einen Schwerpunkt von dahlen.org bilden. Auch die Aktualität soll erhöht werden, was nicht weiter schwer fällt, schließlich wird in Sevelen zu jeder Zeit irgendetwas erneuert oder umgebaut.

Und um all das zu bewerkstelligen habe mir Hilfe von WordPress geholt. Als Blog-Software für die eher statischen Seiten von dahlen.org überqualifiziert, bietet es doch genug CMS-Fähigkeiten, um meinem Ansinnen gerecht werden. Auch habe ich kein eigenes Design erstellt, sondern verwende eine fertige Vorlage.

Lediglich die Übersetzung ins Deutsche muß an einigen Stellen noch vollzogen werden, aber daran soll es jetzt nicht mehr scheitern. Denn, auch wenn ich eine Niete am Zeichenstift bin, an der Tastatur bin ich unschlagbar.

Christoph

Die kleine Ina ist 51cm lang, 3160g schwer und der ganze Stolz von Corinna, Peter und Schwesterchen Pia.