API-Doku ergaenzt

ulrich

2024-11-20 a9ce27642a6280f95664b0140a356e6f4ade91b1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
/*
  neon-fm - Dateiverwaltung fuer neon
  Copyright (C) 2024  Ulrich Hilger
 
  This program is free software: you can redistribute it and/or modify
  it under the terms of the GNU Affero General Public License as
  published by the Free Software Foundation, either version 3 of the
  License, or (at your option) any later version.
 
  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU Affero General Public License for more details.
 
  You should have received a copy of the GNU Affero General Public License
  along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
package de.uhilger.neon.fm;
 
import com.sun.net.httpserver.HttpContext;
import com.sun.net.httpserver.HttpExchange;
import de.uhilger.neon.FileServer;
import de.uhilger.neon.HttpHelper;
import de.uhilger.neon.HttpResponder;
import de.uhilger.fm.Catalog;
import java.io.IOException;
 
/**
 * Erzeugung einer Liste von Dateien und Ordnern
 * 
 * @author Ulrich Hilger
 * @version 0.1, 05.11.2024
 */
public class FileCatalog extends AbstractFileActor {
 
  /**
   * <p>Diese Methode ist als Reaktion auf einen HTTP GET Aufruf an 
   * folgenden URL gedacht und liefert eine Liste des Ordnerinhalts 
   * im JSON-Format in der HTTP-Antwort aus</p>
   * 
   * <pre>
   * Ordnerinhalt auflisten:    
   * http://localhost:[port]/[kontext]/pfad/zum/ordner/
   * </pre>
   * 
   * Die Methode liefert den Dateiinhalt in der HTTP-Antwort aus, 
   * wenn der URL eine Datei bezeichnet
   * 
   * @param exchange das Objekt mit Infos zu HTTP-Request, -Response usw.
   */
  public void list(HttpExchange exchange) {
    try {
      init(exchange);
      HttpContext ctx = exchange.getHttpContext();
      //String base = ctx.getAttributes().getOrDefault(FileServer.ATTR_FILE_BASE, "").toString();
      if(base.length() == 0) {
        new HttpResponder().sendNotFound(exchange, exchange.getRequestURI().toString()); // not found
      } else {
        String fName = new HttpHelper().getFileName(exchange);
        if (fName.endsWith(FileServer.STR_SLASH)) { // Ordnerliste erzeugen
          String json = new Catalog().list(fName, ctx.getPath(), base);
          if (null != json) {
            new HttpResponder().antwortSenden(exchange, HttpResponder.SC_OK, json);
          } else {
            new HttpResponder().antwortSenden(exchange, HttpResponder.SC_OK, "{}"); // leere Liste
          }
        } else {
          new FileServer().serveFile(exchange); // Datei ausliefern
        }
      }
    } catch (IOException | IllegalArgumentException ex) {
      fehlerAntwort(exchange, ex);
    } finally {
      free();
    }
  }  
}