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/FileCreator.java |   28 ++++++++++++++++++++++++----
 1 files changed, 24 insertions(+), 4 deletions(-)

diff --git a/src/de/uhilger/neon/fm/FileCreator.java b/src/de/uhilger/neon/fm/FileCreator.java
index e5e6290..a57dbf7 100644
--- a/src/de/uhilger/neon/fm/FileCreator.java
+++ b/src/de/uhilger/neon/fm/FileCreator.java
@@ -26,15 +26,35 @@
 import java.util.logging.Logger;
 
 /**
+ * Erzeugung von Ordnern und Dateien
  *
  * @author Ulrich Hilger
  * @version 0.1, 08.11.2024
  */
 public class FileCreator extends AbstractFileActor {
 
-  public void run(HttpExchange exchange) {
+  /**
+   * Die methode create legt Ordner und Dateien neu an, sofern im hier 
+   * uebergebenen HttpExchange Objekt die folgenden Angaben zu finden 
+   * sind:
+   * 
+   * <pre>
+   * Datei neu anlegen (ohne Ueberschreiben): 
+   * http://localhost:[port]/[kontext]/pfad/zur/datei.txt 
+   * Body: Dateiinhalt 
+   * Erzeugt eine neue Datei mit einer laufenden Nummer, 
+   * falls die per URL angegebene Datei schon existiert
+   *
+   * Ordner anlegen: 
+   * http://localhost:[port]/[kontext]/pfad/zum/ordner/ 
+   * erzeugt einen HTTP-Fehler 422, wenn der Ordner schon existiert
+   * </pre>
+   * 
+   * @param exchange Infos zu HTTP Request, -Response, Kontext usw.
+   */
+  public void create(HttpExchange exchange) {
     try {
-      super.run(exchange);
+      init(exchange);
       if (fileName.endsWith(FileServer.STR_SLASH)) { // es ist ein Ordner
         if (!file.exists()) {
           file.mkdir();
@@ -49,9 +69,9 @@
           file = trans.getNewFileName(file);
         }
         speichern(exchange);
-      }            
+      }
     } catch (IOException ex) {
-      Logger.getLogger(FileEraser.class.getName()).log(Level.SEVERE, null, ex);
+      Logger.getLogger(FileCreator.class.getName()).log(Level.SEVERE, ex.getMessage(), ex);
     } finally {
       free();
     }

--
Gitblit v1.9.3