| commit | author | age | ||
| 8953e9 | 1 | |
| U | 2 | # WebBox-Lib |
| 3 | ||
| 4 | Diese Klassenbibliothek bündelt Methoden, die von verschiedenen Teilen der [WebBox](/gitblit/docs/wbx-shell.git) verwendet werden. | |
| 5 | ||
| 6 | ## Voraussetzungen | |
| 7 | ||
| 8 | 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](http://azul.com) oder dem [OpenJDK-Projekt](http://openjdk.java.net/) frei erhältlich. In der hier folgenden weiteren Beschreibung wird der lokale Ablageort des Java Development Kits `$JDK` genannt. | |
| 9 | ||
| 10 | 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. | |
| 11 | ||
| 12 | ## Die WebBox-Lib erhalten | |
| 13 | ||
| 14 | Der Quellcode der WebBox-Lib wird von hier an einen frei wählbaren lokalen Ablageort [heruntergeladen](/gitblit/zip/?r=wbx-lib.git&format=zip) 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. | |
| 15 | ||
| 16 | ## Klassenbibliothek herstellen | |
| 17 | ||
| 18 | Die WebBox-Lib ist zur Nutzung im Zusammenspiel mit Programmen der WebBox vorgesehen und wird dazu am besten als Klassenbibliothek genutzt. Zur Herstellung einer Klassenbibliothek werden mit Hilfe der wie zuvor beschrieben geladenen Teile die folgenden Kommandos ausgeführt (Beispiel für Linux): | |
| 19 | ||
| 20 | ``` | |
| 21 | cd $WBX-LIB | |
| 22 | mkdir classes | |
| 23 | mkdir dist | |
| 24 | $JDK/bin/javac -d classes src/de/uhilger/wbx/*.java src/de/uhilger/wbx/web/*.java | |
| 25 | $JDK/bin/jar -cf dist/wbx-lib.jar -C classes . | |
| 26 | ``` | |
| 27 | ||
| 28 | Die fertig verwendbare Klassenbibliothek liegt anschließend unter `$WBX-LIB/dist/wbx-lib.jar`. | |
| 29 | ||
| 30 | ## Klassenbibliothek verwenden | |
| 31 | ||
| 32 | Zur Verwendung der Klassen der WebBox-Lib wird die Klassenbibliothek in das Verzeichnis `$wbx/sys/base/lib` der WebBox abgelegt. | |
