Kapitel 4. Integration der jadice document platform

Um Gedankenanstöße, Beispiele und lauffähige Integrationen der jadice document platform anbieten zu können, liegen der Auslieferung verschiedene Demo-Clients bei. Die Klassen sowie der zugehörige Quellcode werden im Verzeichnis Auslieferungsverzeichnis/demo und dessen Unterverzeichnissen zur Verfügung gestellt.^[6]

Die in dieser Demo-Integration vorliegenden Klassen stehen allesamt unter einer BSD-Lizenz und können somit nach Bedarf verwendet werden. Diese Klassen sind als Beispiele und Hilfe zur Integration sowie der Verwendung der jadice API gedacht. Sie werden daher als Zusatz mit der jadice document platform ausgeliefert. Die Demo-Klassen sind nicht Teil der zugesicherten jadice API und können sich deshalb in kommenden Versionen verändern, erweitern oder ganz wegfallen.

Mit den Klassen BasicDemoApplication und BasicJadicePanel liegt dem Demo-Paket eine direkt lauffähige Beispiel-Integration der jadice document platform bei. BasicDemoApplication bietet mit einem JFrame das notwendige Rahmenwerk um BasicJadicePanel, die eigentliche Integration der jadice-Komponenten, als Java-Anwendung zu starten.

Das BasicJadicePanel beinhaltet eine Toolbar mit den wichtigsten Viewer-Tools, eine Annotation-Toolbar zur Erstellung von Annotationen, eine Statusbar zur Anzeige der Seitenzahl und des Zoom-Faktors, sowie eine Menubar, die im JFrame der BasicDemoApplication gesetzt wird.

Das Erscheinungsbild der Applikation sowie die Strukturen von Toolbars und Menüs sind – basierend auf dem Action- und Command-Konzept des Viewers – beispielhaft über Konfigurationsdateien definiert. Nähere Informationen dazu werden in den folgenden Abschnitten gegeben.

Obwohl die Beispiel-Integration nicht direkt von eigenen Integrationen anprogrammiert werden sollte, bietet sie doch eine Hilfe zur groben Strukturierung der eigenen Umsetzung, Code-Abschnitte, die verändert und übernommen werden können, sowie eine Möglichkeit, große Teile der jadice-Funktionalität ohne größeren Aufwand auszuprobieren.

Mit dem JadiceDemoLauncher gibt es nun die Möglichkeit, eine von mehreren vorkonfigurierten Demo-Varianten zu starten. Es gibt drei vordefinierte Demo-Konfigurationen: »Standard«, »Minimal« und »Integriert«.

Diese Demos starten jeweils die BasicDemoApplication mit einer unterschiedlichen Action- und Command-Framework Konfiguration.

Die integrierte Demo^[7] bietet ein anderes Erscheinungsbild durch einen angepassten Frame.

Weitere Informationen zur Konfiguration von weiteren Varianten sowie den Einstellungsmöglichkeiten können den jeweiligen Klassenkommentaren des JadiceDemoLaunchers entnommen werden.

Neben der BasicDemoApplication liegt mit JadiceFilterDemoApplication noch eine weitere Java-Anwendung der Auslieferung bei. Sie bietet die Möglichkeit, die existierenden Bildskalierungsfilter auszuprobieren.

Um die Integration in Web-basierte Umgebungen zu demonstrieren, integriert die Auslieferung eine Gesamtdemo unter dem Titel JadiceWebDemos. Diese startet eine Java-Applikation mit grafischer Oberfläche und einem WebServer im Hintergrund. Das jadice Demo-Applet und die Demo-WebStart Anwendung können daraufhin im Browser geladen werden.