Als Beispiel sei die UVD von LastSharp gegeben, die wir im folgenden Codebeispiel mithilfe einer XSL-Transformation (DescriptionPage.xsl) in eine HTML-Datei verwandeln. Das soll illustrieren, wie einfach die Verwendung von UVD sein kann, wenn entsprechende Bibliotheken vorhanden sind:

UVD lastsharp = UVD.Create("http://dev.xscheme.de/uvd/lastsharp.uvd.xml");
lastsharp.Save("c:/lastsharp.htm", "http://dev.xscheme.de/uvd/DescriptionPage.xsl");

Nun haben wir eine Datei “lastsharp.htm”, die hier eingesehen werden kann und Beschreibungen in verschiedenen Sprachen und Längen bietet, Downloadlinks, etc… Außerdem sind (wie man bei der Ansicht des Quelltextes feststellen kann) auch die META-Tags zu Schlüsselwörtern und Beschreibungen bereits gesetzt, sodass die Seite auch für Suchmaschinen verwendbar ist.

Das UVD-Objekt (s. Code) bietet noch weitere Möglichkeiten, aber ich möchte nun auf den Update-Mechanismus zu sprechen kommen, den man mithilfe von UVD implementieren kann. Eine UVD kann einen Verweis auf die vorhergehende Version, sowie Informationen zum inkrementellen Update (lösche Datei X, aktualisiere Datei Y, …) enthalten, sodass man durch Untersuchen der Versionsgeschichte jede Version auf den neuesten Stand bringen kann.

Wir verwenden die folgenden (sinnlosen) Dateien zur Demonstration: Version 1.2 >> Version 1.1 >> Version 1.0. Mithilfe der UVDs läuft ein Update von Version 1.0 auf 1.2 folgendermaßen ab:

1. Extrahiere aus der UVD zu Version 1.2 die URL zu Version 1.1!
2. Speichere die Update-Informationen in der UVD zu Version 1.1!
3. Führe nacheinander die Update-Schritte (1.0 >> 1.1) und (1.1 >> 1.2) aus!

Die Bibliothek, an der ich gerade arbeite, verwendet hierfür sog. Update-Profile, die festlegen, welche Sprache und welches Betriebssystem für das Update berücksichtigt werden soll. Code:

UVD version12 = UVD.Create("http://dev.xscheme.de/uvd/updatetest1.xml");
UVDVersion currentVs = new UVDVersion(1, 0); // aktuelle Version
UpdateProfile profile = new UpdateProfile(); // OS und Sprache egal
Update u = profile.CreateUpdate(currentVs, version12);
foreach(UpdateSegment s in u)
{
    Console.WriteLine(s.ToString());
}
u.Execute("c:/program/"); // Programmverzeichnis muss angegeben werden!

Das liefert folgende Ausgabe:

[Add: file3.txt] http://www.download.de
[Execute: file3.txt]
[Remove: file4.txt]
[Add: file1.txt] http://www.download.de
[Update: file2.txt] http://www.download.de
[Execute: file3.txt]

Anschließend werden genau diese Schritte ausgeführt. Bei der Erstellung des Updates wird im übrigen mehr oder weniger intelligent vorgegangen: wenn eine Datei in Version 1.2 gelöscht wird, wird sie in Version 1.1 gar nicht erst hinzugefügt. Und warum eine Datei hinzufügen, wenn sie irgendwann später überschrieben wird? Dieses Verhalten lässt sich über das Update-Profil festlegen. Wenn deaktiviert, lautet die Ausgabe:

[Add: file4.txt] http://www.download.de
[Add: file2.txt] http://www.download.de
[Add: file3.txt] http://www.download.de
[Execute: file3.txt]
[Remove: file4.txt]
[Add: file1.txt] http://www.download.de
[Update: file2.txt] http://www.download.de
[Execute: file3.txt]

Soviel dazu. Was jetzt noch wichtig ist, ist die Übertragung der Bibliothek auf andere Programmiersprachen. Deswegen suche ich Entwickler, die mit mir gemeinsam UVD auf Java, PHP, etc… portieren. Bei Interesse einfach eine E-Mail schreiben an Yannick_Scherer@gmx.net! Aber man sollte sich bewusst sein, dass das einiges an Arbeit bedeutet.

Mehr habe ich vorerst nicht vorzuweisen… Außer vielleicht das ultimative “einzeilige” Update (mit einer sinnvollen Datei funktioniert es dann auch…):

new UpdateProfile()
       .CreateUpdate(new UVDVersion(1, 0), UVD.Create("http://dev.xscheme.de/uvd/updatetest1.xml"))
       .Execute("c:/program/");

Soll ich?
Nein. Das steht da nicht ohne Grund.
Aber…
Kein Aber.
Was wohl passiert?
Schlimme Sachen. Schonmal von Tschernobyl gehört?
Ach, ein klein bisschen…
Denk nicht mal dran!!
Was soll’s.
AUTSCH!!!

Dieses Verhalten wurde nun in ein spielerisches Konzept überführt. Und zwar hier.

Und jetzt, genau hinhören, NICHT AUF DEN ROTEN KNOPF DRÜCKEN!

Ich gebe zu, das ist einer meiner weniger vernünftigen Beiträge. Aber zumindest hat es mir Spaß gemacht.

In Stefans Allerlei bin ich nun zufällig über OpenBooks gestolpert. Gut, mag man jetzt sagen, damit bringe ich nicht unbedingt etwas Neues (Zitat auf der Seite: “Mit unseren OpenBooks geben wir seit vielen Jahren geballtes Wissen an die Community weiter (…)”) und ich frage mich auch, warum ich bisher noch nichts davon gehört habe – aber Fakt ist, dass so eine Plattform eigentlich zu jeder Zeit Erwähnung verdient.

Denn OpenBooks bietet kostenlose IT-Bücher im PDF-/HTML-Format, sowohl auf Deutsch als auch auf Englisch. Die Themen umfassen Werkzeuge wie Samba oder GNU make, OpenSource an sich, Linux, etc… Meine Favoriten auf den ersten Blick sind:

	Praxiswissen Ruby on Rails, Deutsch, 2007 PDF (direkter Link) Kurzbeschreibung (von der OpenBooks-Seite): Wer Schritt für Schritt wissen möchte, welches Potential im Web-Framework Ruby on Rails steckt, wer in einem Schnelldurchgang die Programmiersprache Ruby lernen möchte, wer durch interessante und praktische Programmierbeispiele die beeindruckenden Features umfassend kennen lernen möchte, der kommt an diesem Buch nicht vorbei.
	Praktischer Einstieg in MySQL mit PHP, Deutsch, 2007 PDF (direkter Link) Kurzbeschreibung (von der OpenBooks-Seite): Dieses Buch ist eine MySQL-Einführung für Webentwickler, die eine elegante Datenbanklösung für ihre Webseiten suchen. Es vermittelt praxisnah, wie Sie eine MySQL-Datenbank einrichten, administrieren und mittels PHP-Skripten in die Webseiten einbinden. Für die Neuauflage wurde das Buch komplett überarbeitet, behandelt werden die Versionen MySQL 5.0 und 5.1 (Beta) sowie PHP 5.2.
	We the Media, Englisch, 2004, HTML (direkter Link) Kurzbeschreibung (von der OpenBooks-Seite): Grassroots journalists are dismantling Big Media’s monopoly on the news, transforming it from a lecture to a conversation. Not content to accept the news as reported, these readers-turned-reporters are publishing in real time to a worldwide audience via the Internet. The impact of their work is just beginning to be felt by professional journalists and the newsmakers they cover. In We the Media: Grassroots Journalism by the People, for the People, nationally known business and technology columnist Dan Gillmor tells the story of this emerging phenomenon, and sheds light on this deep shift in how we make and consume the news.

Ich hoffe, damit habe ich allen, die sich für IT (und auch das Drumherum) interessieren, geholfen. Natürlich nur, falls sie, wie ich, bis heute keine Ahnung davon hatten…

Das irrKlang-Forum liefert sogleich den ersten Hinweis (hier):

By default, a Visual Studio project is targeted for “Any CPU.” Unfortunately, when run on 64-bit Vista, the default is a 64-bit application, which creates a conflict with the 32-bit DLLs. Worse, this error only shows up at runtime, when the libraries bind to the executable.

Die Lösung wäre es unter Visual Studio, so wird weiter ausgeführt, die Projekteinstellungen zu öffnen und auf der Registerkarte “Erstellen” als Zielplattform “x86″ auszuwählen. Blöd nur, dass die Visual Studio Express Editions diese Option gar nicht bieten…

Erster Weg

Ich folge dem Vorgehen von jenkz.org und editiere meine Projektdatei von Hand, indem ich in den zweiten PropertyGroup-Abschnitt die Zeile <PlatformTarget>x86</PlatformTarget> einfüge.

Zweiter Weg

Ich nehme einen kleinen Umweg in Kauf und kann dann doch die Express Edition für diesen Zweck missbrauchen. Hierzu folge man den Instruktionen in Frobozz’s Blog.

Fazit

Ich bin gespannt, ob LastSharp damit 64-Bit-fähig wird… LastSharp läuft damit auch auf Vista x64.

Vor allem letzter Punkt macht natürlich Eindruck, äußert er sich doch in dynamischen Bildergallerien (z.B. Galleria, s. Bild), Unterstützung des Users durch Auto-Complete und Auto-Suggest, Tooltips, sowie einer Menge an kleinen Mini-Applikationen und Widgets, die es einfach machen, die eigene Website um eine ganze Reihe an Funktionalitäten zu erweitern und aufzupeppen.

Die große Anzahl an Möglichkeiten lässt sich auf so wenig Platz natürlich nicht beschreiben, Smashing Magazine hat dennoch eine Liste mit 75 (wirklich) nützlichen JavaScript-Techniken (englisch) [via] herausgebracht, die ich hiermit jedem ambitionierten Web-Designer wärmstens ans Herz legen will.

Ich verwende selbst einige der dort vorgestellten Techniken (z.B. Lightbox 2 oder den Google Syntax Highlighter) und muss sagen, dass in dieser Liste echt noch ein paar weitere Schmuckstücke vertreten sind, die super aussehen, praktisch sind und deshalb nur darauf warten, von mir sobald als möglich ausprobiert zu werden!

Ich habe mich in letzter Zeit viel mit Last.FM beschäftigt, nicht zuletzt wegen meinen beiden Programmen LastSharp und Lea. Aufgrund eines Problems mit letzterem (Tracks/Künstler mit Umlauten machen Schwierigkeiten) habe ich mich ein wenig umgesehen und bin auf eine (angeblich vollständige) Implementierung des Last.FM-APIs in .NET gestoßen: LastFmLib.Net.

Und weil diese Bibliothek wirklich einzigartig einfach zu verwenden ist (obwohl auch hier die Umlaute noch nicht extra betrachtet werden), möchte ich meine Erfahrungen gerne teilen und eine winzige, deutschsprachige Erklärung zu ihrer Verwendung bzw. Anwendung auf das API 2.0 schreiben.

Vorbereitung

Jeder, der den Last.FM-Webservice verwenden will, benötigt zuallererst einen öffentlichen und einen dazugehörigen geheimen API-Schlüssel, den man hier beantragen kann. Da LastFmLib.Net eine Klassenbibliothek für das .NET-Framework ist, wird eine entsprechende Entwicklungsumgebung (z.B. Visual C# Express Edition) benötigt, um damit arbeiten zu können.

Hat man einen öffentlichen und einen geheimen API-Schlüssel (Key und Secret) erhalten, so muss man LastFmLib.Net diese beiden mitteilen. Dies geschieht, indem man das LastFmLib.API20.Settings.AuthData-Objekt neu setzt, in C# beispielsweise:

LastFmLib.General.MD5Hash key
    = new LastFmLib.General.MD5Hash("APIKey", true, Encoding.UTF8);
LastFmLib.General.MD5Hash secret
    = new LastFmLib.General.MD5Hash("APISecret", true, Encoding.UTF8);
LastFmLib.API20.Settings20.AuthData
    = new LastFmLib.API20.Types.AuthData(key, secret, null);

Hat man das nun erledigt, kann man (nach der Authentifizierung) auf die einzelnen API-Methoden zugreifen.

Allgemein: Request schicken

In LastFmLib.Net sind alle Anfragen an das API in Klassen gekapselt. Für jede Art von Anfrage (Request) erstellt man also ein entsprechendes Objekt, startet die Verarbeitung, überprüft ob die Anfrage erfolgreich war und verarbeitet das Ergebnis. Alle Requests befinden sich im Namespace LastFmLib.API20.<Art>, wobei <Art> die entsprechende Obergruppe einer Anfrage ist, z.B. “Auth”, “User”, “Playlists”, etc… Diese Obergruppen sieht man auf der API-Seite fettgedruckt in der Spalte links.

In C# würde das also so aussehen:

LastFmLib.API20.<Art>.<Irgendeine Request> req
    = new LastFmLib.API20.<Art>.<Irgendeine Request>(<notwendige Parameter>);
req.Start();
if (req.Succeeded) {
    // Mach etwas mit dem Ergebnis
} else {
    // Mach etwas mit dem Fehler (req.ErrorMessage)
}

Authentifizierung

Alles beginnt mit der Anmeldung des Users. Bei Last.FM geht dies in drei Schritten vonstatten:

1. Holen des sog. “Tokens”, der sozusagen das Passwort für alle nun kommenden Anfragen darstellt und nur eine begrenzte Zeit gültig ist. Dies geschieht mit der API-Methode getToken():

   LastFmLib.API20.Auth.AuthGetToken req
       = new LastFmLib.API20.Auth.AuthGetToken();
   req.Start();
   if (req.Succeeded) {
       // Token speichern
       LastFmLib.API20.Settings20.AuthData.Token = req.Result;
   } else {
       // Mach etwas mit dem Fehler
   }

2. Zulassung des Programms für den eigenen Last.FM-Account. Hierfür wird der Browser geöffnet, sodass der User sich einloggen und die entsprechende Berechtigung vergeben kann. LastFmLib.Net stellt hierfür auch gleich eine Funktion bereit (1.Parameter: Anwendung unterbrechen, 2. Parameter: Timeout):

   LastFmLib.API20.Settings.AuthData.AskUserToGrantPermissions(false, 0);

3. Holen der Session-Informationen (Benutzername, Session-Key, Subscriber-Status) mit der Methode getSession(token). Achten Sie darauf, dass dieser Schritt auch wirklich erst nach der Bestätigung im Browser ausgeführt wird, ansonsten klappt das Holen der Informationen nämlich nicht.

   LastFmLib.API20.Auth.AuthGetSession sk =
       new LastFmLib.API20.Auth.AuthGetSession(LastFmLib.API20.Settings20.AuthData.Token, false);
   sk.Start();
   if (sk.Succeeded)
   {
       // Session speichern
       LastFmLib.API20.Settings20.AuthData.Session = sk.Result;
   }
   else {
       // Mach etwas mit dem Fehler
   }

Wenn diese drei Schritte erfolgreich ausgeführt wurden, kann man die eigentlichen Anfragen starten, immer nach dem oben genannten Muster.

Beispiel: Playlisten eines Users holen

LastFmLib.API20.User.UserGetPlaylists req =
    new LastFmLib.API20.User.UserGetPlaylists(LastFmLib.API20.Settings20.AuthData.Session.Username);
gp.Start();
if (gp.Succeeded)
{
    foreach (LastFmLib.API20.Types.SimplePlaylist pl in gp.Result) {
        // Playliste verarbeiten
    }
} else {
    // Mach etwas mit dem Fehler
}

Anmerkungen

Der Aktualität halber sollte man nicht die vorgefertigte DLL von der Website des Entwicklers laden, sondern die neuesten Quelldateien aus dem SVN-Verzeichnis, um daraus die letztendliche Bibliothek zu erstellen. Dies geht mithilfe von Subversion und dem Befehl:

svn co https://lastfmlibnet.svn.sourceforge.net/svnroot/lastfmlibnet lastfmlibnet

Eine entsprechende Dokumentation der Klassenbibliothek findet sich auch im SVN-Verzeichnis. Vor allem, wenn man keine Möglichkeit hat, über die Entwicklungsumgebung Informationen zu einzelnen Funktionen zu erhalten (Parametertypen/-anzahl, Rückgabetyp), sollte man sich darin vertiefen.

Mein Programm Lea (ab Version 1.2) ist dank LastFmLib.Net keine große Sache mehr, dafür (hoffentlich) um einiges stabiler und wartungsfreundlicher.

So, ich hoffe, dieses HowTo hat ein wenig geholfen. Weitere Informationen und natürlich auch Support gibt es auf der Website des Entwicklers.