/**
|
* Die Package de.uhilger.neon.fm stellt eine Schnittstelle via HTTP bereit,
|
* ueber die Dateien verwaltet werden koennen. In dieser Package sind die
|
* Klassen enthalten, die den HTTP-Teil einer solchen Schnittstelle abdecken.
|
*
|
* Fuer die Ausfuehrung der auf diese Weise via HTTP bereitgestellten Dateioperationen
|
* werden die Klassen der Package de.uhilger.fm verwendet.
|
*
|
* Die folgenden HTTP-Aufrufe werden von dieser Package als HTTP-Aufrufe implementiert:
|
*
|
* <pre>
|
* GET (Klasse FileList)
|
* - Dateiinhalt ausliefern (URL ohne Slash am Ende) FileContent + FileList
|
* - Ordnerinhalt auflisten (URL mit Slash am Ende) FileList
|
*
|
* PUT (Klasse FileManipulator)
|
* - Inhalt einer einzelnen Datei anlegen oder ueberschreiben Writer
|
* - Liste mit Dateien kopieren (?copyFrom) Mover
|
* - Liste mit Dateien verschieben (?moveFrom) Mover
|
* - einzelne Datei duplizieren (?duplicate) Duplicator
|
* - einzelne Datei umbenennen (?renameTo) Renamer
|
* - Ordner packen (?zip) Deflator
|
* - Zip-Datei entpacken (?unzip) Inflator
|
*
|
* POST (Klasse FileCreator)
|
* - Datei neu anlegen, unter neuem Namen, wenn schon existent (URL ohne Slash am Ende)
|
* - Ordner anlegen oder Fehler 422, wenn schon existent (URL mit Slash am Ende)
|
*
|
* DELETE (Klasse FileEraser)
|
* - Liste mit Dateien und Ordnern loeschen (rekursiv!)
|
* </pre>
|
*
|
* <p>HTTP-Beispiele</p>
|
*
|
* <p>HTTP GET fuer eine Datei innerhalb dieses Ordners liefert den Dateiinhalt aus</p>
|
*
|
* <p>HTTP GET fuer einen Ordner liefert eine Liste von dessen Inhalt in JSON</p>
|
*
|
* <p>HTTP PUT fuer eine Datei ueberschreibt eine bestehende Datei mit dem im Body
|
* uebergebenen Inhalt oder legt eine Datei mit diesem Inhalt an</p>
|
*
|
* <p>HTTP POST fuer eine Datei legt eine neue Datei mit dem im Body uebergebenen
|
* Inhalt an oder erzeugt eine neue Datei mit einer laufenden Nummer, falls
|
* diese Datei schon existiert</p>
|
*
|
* <p>HTTP POST fuer einen Ordner legt einen neuen Ordner an wenn er noch nicht
|
* existiert oder erzeugt einen HTTP-Fehler 422</p>
|
*
|
* <p>HTTP DELETE loescht die Liste der Dateien und Ordner im Body</p>
|
*
|
* <p>HTTP PUT ?copyFrom=pfad kopiert die Liste der Datei- oder Ordnernamen im Body
|
* der Anfrage vom Pfad in 'copyFrom' zum Pfad dieser Anfrage. Jede Datei, die
|
* im Ziel bereits existiert, bekommt im Ziel einen neuen Namen mit einer
|
* laufenden Nummer. Bei Ordnern, die im Ziel bereits existieren, bekommt der
|
* betreffende Ordner im Ziel zunaechst einen neuen Namen mit einer laufenden
|
* Nummer, dann wird der Quellordner ans Ziel kopiert.</p>
|
*
|
* <p>HTTP PUT ?moveFrom=pfad verschiebt die Liste der Datei- oder Ordnernamen im
|
* Body der Anfrage vom Pfad in 'moveFrom' zum Pfad dieser Anfrage. Jede Datei,
|
* die im Ziel bereits existiert, bekommt im Ziel einen neuen Namen mit einer
|
* laufenden Nummer. Bei Ordnern, die im Ziel bereits existieren, bekommt der
|
* betreffende Ordner im Ziel zunaechst einen neuen Namen mit einer laufenden
|
* Nummer, dann wird der Quellordner ans Ziel kopiert.</p>
|
*
|
* <p>HTTP PUT mit ?duplicate legt eine Kopie der Datei an</p>
|
*
|
* <p>HTTP PUT mit '?renameTo=neuer Name' benennt die Datei oder den Ordner um,
|
* sofern der neue Name noch nicht vergeben ist</p>
|
*
|
* <p>HTTP PUT mit '?zip' packt den Ordner</p>
|
*
|
* <p>HTTP PUT mit '?unzip' entpackt eine Datei</p>
|
*
|
* <p>Namenskonventionen:<br>
|
* Ein Pfad mit Schraegstrich ('/') am Ende bezeichnet einen Ordner<br>
|
* Ein Pfad ohne Schraegstrich ('/') am Ende bezeichnet eine Datei</p> *
|
*
|
*/
|
package de.uhilger.neon.fm;
|
