WebBox Klassenbibliothek
edit | blame | history | raw

WebBox-Lib

Diese Klassenbibliothek bündelt Methoden, die von verschiedenen Teilen der WebBox verwendet werden.

Voraussetzungen

Zur Herstellung und Nutzung der WebBox-Lib werden ein Java Development Kit (JDK) und der Quellcode der WebBox-Lib benötigt. Das JDK ist z.B. von Azul oder dem OpenJDK-Projekt frei erhältlich. In der hier folgenden weiteren Beschreibung wird der lokale Ablageort des Java Development Kits $JDK genannt.

Die WebBox-Lib setzt auf die Java Database Connectivity (JDBC) auf. Zum Zugriff auf Datenbanken benötigen Programme zur Laufzeit einen passenden JDBC-Treiber wie er vom Hersteller der betreffenden Datenbanken bereitgestellt wird.

Die WebBox-Lib erhalten

Der Quellcode der WebBox-Lib wird von hier an einen frei wählbaren lokalen Ablageort heruntergeladen und entpackt. In der hier folgenden weiteren Beschreibung wird das so entstandene Verzeichnis wbx-lib einschließlich des absoluten Pfades dorthin $WBX-LIB genannt. Anstelle von $WBX-LIB würde man also beispielweise /home/fred/wbx-lib notieren, wenn in das persönliche Verzeichnis des Benutzers fred heruntergealden und entpackt wurde.

Klassenbibliothek herstellen

Die WebBox-Lib ist zur Nutzung im Zusammenspiel mit Programmen der WebBox vorgesehen und wird dazu am besten als Klassenbibliothek genutzt.

Zum Herstellen der Klassenbibliothek wird ein Java Development Kit (JDK) benötigt, wie es z.B. von Azul oder dem OpenJDK-Projekt frei erhältlich ist. In der hier folgenden weiteren Beschreibung wird der lokale Ablageort des Java Development Kits $JDK genannt.

Desweiteren werden die folgenden Klassenbibliotheken benötigt

Bibliothek            Datei(en)                       Ablageort lokal
----------            ---------                       ---------------
Tomcat .............. lib/servlet-api.jar ........... $CATALINA_HOME
Thumbnailator ....... lib/thumbnailator.jar ......... $CATALINA_BASE

Diese sind an folgenden Orten frei erhältlich:

Zur Herstellung einer Klassenbibliothek werden mit Hilfe der wie zuvor beschrieben geladenen Teile die folgenden Kommandos ausgeführt (Beispiel für Linux):

cd $WBX-LIB
mkdir classes
mkdir dist
$JDK/bin/javac -classpath $CATALINA_HOME/lib/servlet-api:$CATALINA_BASE/lib/thumbnailator.jar -d classes src/de/uhilger/wbx/*.java src/de/uhilger/wbx/web/*.java
$JDK/bin/jar -cf dist/wbx-lib.jar -C classes .

Die fertig verwendbare Klassenbibliothek liegt anschließend unter $WBX-LIB/dist/wbx-lib.jar.

Klassenbibliothek verwenden

Zur Verwendung der Klassen der WebBox-Lib wird die Klassenbibliothek in das Verzeichnis $wbx/sys/base/lib der WebBox abgelegt. Dort muss auch die Klassenbibliothek thumbnailator.jar abgelegt werden.