Java Web Services via REST bereitstellen
ulrich@undisclosed
2020-05-03 1da9cc31f03389234cd545433e0bde4c872046f6
Links in Doku angepasst
1 files modified
30 ■■■■ changed files
README.md 30 ●●●● patch | view | raw | blame | history
README.md
@@ -1,15 +1,20 @@
# Transit
Java-Code auf einem Server lässt sich mit Transit ohne statische Annotationen via Ajax rufen. Ein einfacher Uniform Resource Locator (URL) wie der folgende genügt:
Java-Code auf einem Server lässt sich mit Transit ohne statische Annotationen
via Ajax rufen. Ein einfacher Uniform Resource Locator (URL) wie der folgende genügt:
`http://example.com/package.klasse/methode/format/param1/param2/../paramN`
Weitere Informationen auf der [Produktseite](/data/ulrich/prg/transit/)
Weitere Informationen auf der [Produktseite](/data/pg/transit/)
## Voraussetzungen
Zur Herstellung und Nutzung von Transit werden ein Java Development Kit (JDK) und der Quellcode von Transit 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. Desweiteren werden die folgenden Klassenbibliotheken benötigt
Zur Herstellung und Nutzung von Transit werden ein Java Development Kit (JDK) und
der Quellcode von Transit 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. Desweiteren werden die folgenden Klassenbibliotheken benötigt:
```
Bibliothek            Datei(en)                       Ablageort lokal
@@ -22,17 +27,26 @@
- [XStream](https://x-stream.github.io/)
- [Jettison](http://repo.maven.apache.org/maven2/org/codehaus/jettison/jettison/1.2/jettison-1.2.jar)
- [XStream auf Github](https://github.com/codehaus/xstream)
- [Jettison auf Github](https://github.com/codehaus/jettison)
## Transit erhalten
Der Quellcode von Transit wird von hier an einen frei wählbaren lokalen Ablageort [heruntergeladen](/gitblit/zip/?r=Transit.git&format=zip) und entpackt. In der hier folgenden weiteren Beschreibung wird das so entstandene Verzeichnis `Transit` einschließlich des absoluten Pfades dorthin `$TRANSIT` genannt. Anstelle von `$TRANSIT` würde man also beispielweise `/home/fred/Transit` notieren, wenn in das persönliche Verzeichnis des Benutzers `fred` heruntergealden und entpackt wurde. Ferner wird angenommen, dass die oben aufgeführten Klassenbibliotheken lokal an Orten abgelegt sind, deren Pfade mit dem Platzhalter `$JLIB` gemeint ist. Anstelle des Platzhalters muss in den folgenden Kommandos also der absolute Pfad des lokalen Ablageortes eingesetzt werden.
Der Quellcode von Transit wird von hier an einen frei wählbaren lokalen Ablageort
[heruntergeladen](/gitblit/zip/?r=Transit.git&format=zip) und entpackt. In der hier
folgenden weiteren Beschreibung wird das so entstandene Verzeichnis `Transit` einschließlich
des absoluten Pfades dorthin `$TRANSIT` genannt. Anstelle von `$TRANSIT` würde man also
beispielweise `/home/fred/Transit` notieren, wenn in das persönliche Verzeichnis des
Benutzers `fred` heruntergealden und entpackt wurde. Ferner wird angenommen, dass die
oben aufgeführten Klassenbibliotheken lokal an Orten abgelegt sind, deren Pfade mit dem
Platzhalter `$JLIB` gemeint ist. Anstelle des Platzhalters muss in den folgenden Kommandos
also der absolute Pfad des lokalen Ablageortes eingesetzt werden.
## Klassenbibliothek herstellen
Transit 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):
Transit 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 $TRANSIT
@@ -49,4 +63,6 @@
## Klassenbibliothek verwenden
Zur Verwendung der Klassen von Transit wird die Klassenbibliothek in den Classpath des Programmes aufgenommen, von dem aus Transit genutzt werden soll. Details zur Nutzung von Transit sind in der [Anleitung](/data/ulrich/prg/transit/Anleitung.htmi) beschrieben.
Zur Verwendung der Klassen von Transit wird die Klassenbibliothek in den Classpath des Programmes
aufgenommen, von dem aus Transit genutzt werden soll. Details zur Nutzung von Transit sind in
der [Anleitung](/data/pg/transit/anleitung.adoc) beschrieben.