ulrich
2017-01-17 b5748a4f0aaadef490d84be234df08ac8cfc0685
Dokumentation (in Arbeit)
1 files modified
1 files added
24 ■■■■ changed files
README.md 20 ●●●● patch | view | raw | blame | history
nutzung.md 4 ●●●● patch | view | raw | blame | history
README.md
@@ -3,13 +3,17 @@
Eine Klassenbibliothek für objekt-relationales Mapping und die damit verbundene Arbeit mit relationalen Datenbanken. Weitere Informationen auf der [Produktseite](http://uhilger.de/dev/Software/Libs/BaseLink/BaseLink).
## Voraussetzungen
Zur Herstellung und Nutzung von BaseLink werden ein Java Development Kit (JDK) und der Quellcode von BaseLink 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.
## BaseLink erhalten
Der Quellcode von BaseLink wird von hier an einen frei wählbaren lokalen Ablageort [heruntergeladen](http://uhilger.de/gitblit/zip/?r=BaseLink.git&format=zip) und entpackt. In der hier folgenden weiteren Beschreibung wird das so entstandene Verzeichnis `BaseLink` einschließlich des absoluten Pfades dorthin `$BASELINK` genannt. Anstelle von `$BASELINK` würde man also beispielweise `/home/fred/BaseLink` notieren, wenn in das persönliche Verzeichnis des Benutzers `fred` heruntergealden und entpackt wurde.
## Klassenbibliothek herstellen
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/) erhältlich ist. In der hier folgenden weiteren Beschreibung wird der lokale Ablageort des Java Development Kits `$JDK` genannt.
Nach Beschaffung des JDK wird der Quellcode aus diesem Git-Repository an einen frei wählbaren lokalen Ablageort [heruntergeladen](http://uhilger.de/gitblit/zip/?r=BaseLink.git&format=zip) und entpackt. In der hier folgenden weiteren Beschreibung wird das so entstandene Verzeichnis `BaseLink` einschließlich des absoluten Pfades dorthin `$BASELINK` genannt.
Dann werden die folgenden Kommandos ausgeführt (Beispiel für Linux):
BaseLink ist zur Nutzung im Zusammenspiel mit anderen Programmen 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):
```
cd $BASELINK
@@ -19,4 +23,8 @@
$JDK/bin/jar -cf dist/BaseLink.jar -C classes .
```
Die fertig verwendbare Klassenbibliothek liegt anschließend unter `$BASELINK/dist/BaseLink.jar`.
Die fertig verwendbare Klassenbibliothek liegt anschließend unter `$BASELINK/dist/BaseLink.jar`.
## Klassenbibliothek verwenden
Zur Verwendung der Klassen von BaseLink wird die Klassenbibliothek in den Classpath des Programmes aufgenommen, von dem aus BaseLink genutzt werden soll. Details zur Nutzung von BaseLink sind auf der Seite [Nutzung](nutzung.md) beschrieben.
nutzung.md
New file
@@ -0,0 +1,4 @@
# Nutzung von BaseLink
Dieses Dokument beschreibt die Nutzung von [BaseLink](README.md). Es ist noch im Aufbau.