From a9ce27642a6280f95664b0140a356e6f4ade91b1 Mon Sep 17 00:00:00 2001 From: ulrich <undisclosed> Date: Wed, 20 Nov 2024 14:58:09 +0000 Subject: [PATCH] API-Doku ergaenzt --- src/de/uhilger/neon/fm/package-info.java | 49 +++---------------------------------------------- 1 files changed, 3 insertions(+), 46 deletions(-) diff --git a/src/de/uhilger/neon/fm/package-info.java b/src/de/uhilger/neon/fm/package-info.java index 921000f..67d611c 100644 --- a/src/de/uhilger/neon/fm/package-info.java +++ b/src/de/uhilger/neon/fm/package-info.java @@ -6,8 +6,10 @@ * 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) + * GET (Klasse FileCatalog) * - Dateiinhalt ausliefern (URL ohne Slash am Ende) FileContent + FileList * - Ordnerinhalt auflisten (URL mit Slash am Ende) FileList * @@ -27,51 +29,6 @@ * 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; \ No newline at end of file -- Gitblit v1.9.3