Tutorial: Entwicklung eines TvDataService

Die TV-Daten werden in TV-Browser über spezielle Plugins - wir nennen sie DataServices - geladen. Auf diese Weise läßt sich TV-Browser beliebig um weitere Sender erweitern (vorausgesetzt, jemand verfügt über die TV-Daten und schreibt ein DataService dazu).

Dieses Tutorial beschreibt die Entwicklung eines DataServices in den Grundzügen. Als weitere Hilfen empfehle ich das TvDataStarterKit, einen Blick in die JavaDoc-Dokumentation von TV-Browser bzw. den Quellcode der existierenden DataServices.

Entwicklungsumgebung einrichten

Erweitere den Java-Klassenpfad um die Jar-Datei tvbrowser.jar (zu finden im Verzeichnis der TV-Browser-Installation).

Implementieren

Entwickle eine Klasse, die das Interface tvdataservice.TvDataService implementiert.

Anmerkungen:

• Um TvDataServices vor der TV-Browser-Version 0.9.7 weiterhin verwenden zu können, müssen diese die von der abstrakten Klasse AbstractOldTvDataServiceBridge erben (bzw. das neue Interface implementieren).
• Statt das Interface TvDataService direkt zu implementieren, kann auch die Klasse util.tvdataservice.AbstractTvDataService verwendet werden.
• Sämtliche Methoden dieser Klasse werden von der Host-Applikation (also dem TV-Browser) aufgerufen und sind somit die Einstiegspunkte des Plugins.
• Die Klasse muß in einem Package liegen, das den selben Namen wie die Klasse selbst hat, allerdings in Kleinbuchstaben.

Jar-Datei erstellen

Als nächstes müssen wir das DataService in eine einzige Datei zusammenpacken, damit man es leicht installieren und anderen Leuten anbieten kann.

Mit folgendem Befehl wird nun die Jar-Datei erstellt:

jar cvf MyTVDataService.jar mytvdataservice

Wichtig: Der Dateiname der Jar-Datei muß dabei mit dem Namen der oben erstellten Klasse identisch sein (Auch Groß-/Kleinschreibung beachten!).

Installation

Kopiere die eben erstellte Jar-Datei in das Verzeichnis dataservice deiner TV-Browser-Installation. Jetzt musst du nur noch TV-Browser neu starten und schon kannst du dein DataService benutzen, indem du im Menü TV-Daten auf Aktualisieren klickst.