| 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 | ||
| af1684 | 18 | Die WebBox-Lib ist zur Nutzung im Zusammenspiel mit Programmen der WebBox vorgesehen und wird dazu am besten als Klassenbibliothek genutzt. |
| U | 19 | |
| 20 | Zum Herstellen der Klassenbibliothek wird ein Java Development Kit (JDK) benötigt, wie es z.B. von [Azul](http://azul.com) oder dem [OpenJDK-Projekt](http://openjdk.java.net/) frei erhältlich ist. In der hier folgenden weiteren Beschreibung wird der lokale Ablageort des Java Development Kits `$JDK` genannt. | |
| 21 | ||
| 22 | Desweiteren werden die folgenden Klassenbibliotheken benötigt | |
| 23 | ||
| 24 | ``` | |
| 25 | Bibliothek Datei(en) Ablageort lokal | |
| 26 | ---------- --------- --------------- | |
| 27 | Tomcat .............. lib/servlet-api.jar ........... $CATALINA_HOME | |
| 28 | Thumbnailator ....... lib/thumbnailator.jar ......... $CATALINA_BASE | |
| 29 | ``` | |
| 30 | ||
| 31 | Diese sind an folgenden Orten frei erhältlich: | |
| 32 | ||
| 33 | - [Apache Tomcat](http://tomcat.apache.org) | |
| 34 | - [Thumbnailator](https://github.com/coobird/thumbnailator) | |
| 35 | ||
| 36 | Zur Herstellung einer Klassenbibliothek werden mit Hilfe der wie zuvor beschrieben geladenen Teile die folgenden Kommandos ausgeführt (Beispiel für Linux): | |
| 8953e9 | 37 | |
| U | 38 | ``` |
| 39 | cd $WBX-LIB | |
| 40 | mkdir classes | |
| 41 | mkdir dist | |
| af1684 | 42 | $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 |
| 8953e9 | 43 | $JDK/bin/jar -cf dist/wbx-lib.jar -C classes . |
| U | 44 | ``` |
| 45 | ||
| 46 | Die fertig verwendbare Klassenbibliothek liegt anschließend unter `$WBX-LIB/dist/wbx-lib.jar`. | |
| 47 | ||
| 48 | ## Klassenbibliothek verwenden | |
| 49 | ||
| af1684 | 50 | 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. |
