From 0a58e2c709547269ddbe4b2d92601521667cd765 Mon Sep 17 00:00:00 2001
From: ulrich
Date: Thu, 08 Apr 2021 10:47:32 +0000
Subject: [PATCH] REST-Konformitaet des StorageHandler verbessert
---
src/de/uhilger/mediaz/api/StorageHandler.java | 112 ++++++++++++++++++++++++++++---------------------------
1 files changed, 57 insertions(+), 55 deletions(-)
diff --git a/src/de/uhilger/mediaz/api/StorageHandler.java b/src/de/uhilger/mediaz/api/StorageHandler.java
index 5899bef..a44c326 100644
--- a/src/de/uhilger/mediaz/api/StorageHandler.java
+++ b/src/de/uhilger/mediaz/api/StorageHandler.java
@@ -21,12 +21,12 @@
import com.sun.net.httpserver.HttpExchange;
import com.sun.net.httpserver.HttpHandler;
import de.uhilger.mediaz.App;
+import static de.uhilger.mediaz.App.RB_EP_LISTE;
import de.uhilger.mediaz.Server;
import static de.uhilger.mediaz.Server.RB_SLASH;
import de.uhilger.mediaz.store.FileStorage;
import de.uhilger.mediaz.entity.Entity;
import java.io.BufferedReader;
-import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
@@ -46,32 +46,34 @@
private static final Logger logger = Logger.getLogger(StorageHandler.class.getName());
- /*
- Das REST-Muster sieht je Entitaet fuenf Faelle vor (Beispiel Ablageort):
+ /*
+ Das REST-Muster fuer die Mediazentrale (Beispiel Ablageort):
- 1. HTTP GET Ablageort/[Name]: Liefere den Ablageort als JSON
- 2. HTTP GET Ablageort/: Liefere einer Liste von Ablageorten als JSON
- 3. HTTP PUT: schreibe einen neuen Ablageort auf die Platte
- 4. HTTP POST: schreibe Aenderungen auf die Platte
- 5. HTTP DELETE: loesche den Ablageort
+ 1. HTTP GET Ablageort/[Name] - Liefere den Ablageort namens [Name]
+ 2. HTTP GET Ablageort/liste/ - Liefere eine Liste mit Namen aller Ablageorte
+ Es duerfen keine Elemente namens "liste" angelegt werden
+ 3. HTTP GET Ablageort/ - Liefere eine Liste aller Ablageort-Objekte als JSON
+ 4. HTTP PUT Ablageort/[Name] - Der Ablageort wird angelegt. Wenn er bereits existiert,
+ wird er geändert. (im Falle einer Aenderung des Namens
+ muss der alte Name im URL stehen und im Body die Aenderung)
+ 5. HTTP DELETE - loesche den Ablageort
Beispiele:
- HTTP GET an /mz/api/store/Ablageort/
+ HTTP GET /mz/api/store/Ablageort/
+ liefert alle Ablageort-Objekte
+
+ HTTP GET /mz/api/store/Ablageort/liste/
liefert eine Liste der Namen vorhandener Ablageorte
- HTTP GET an /mz/api/store/Ablageort/Katalog
- liest den Ablageort namens "Katalog"
+ HTTP GET /mz/api/store/Ablageort/[Name]
+ liest den Ablageort namens [Name]
- HTTP POST an /mz/api/store/Ablageort
- schreibt den neuen Ablageort im Body der Anfrage (Neu)
+ HTTP PUT /mz/api/store/Ablageort/[Name]
+ wenn [Name] existiert: Aenderung, sonst neu anlegen
- HTTP PUT an /mz/api/store/Ablageort
- sucht den Ablageort mit dem Namen laut Body der Anfrage
- und schreibt den Inhalt aus der Anfrage in die Datei (Aenderung)
-
- HTTP DELETE an /mz/api/store/Ablageort/Katalog
- löscht den Ablageort namens "Katalog"
+ HTTP DELETE /mz/api/store/Ablageort/[Name]
+ löscht den Ablageort namens [Name]
*/
@@ -86,6 +88,8 @@
/** Name der HTTP Methode DELETE */
public static final String HTTP_DELETE = "DELETE";
+
+ public static final String EP_LISTE = "liste/";
@Override
public void handle(HttpExchange e) throws IOException {
@@ -104,11 +108,12 @@
break;
case HTTP_PUT:
- response = aendern(e);
+ response = put(e);
break;
case HTTP_POST:
- response = neu(e);
+ response = "nicht unterstuertzt.";
+ code = 404;
break;
case HTTP_DELETE:
@@ -127,42 +132,32 @@
os.close();
}
- private String neu(HttpExchange e) throws IOException {
- return schreiben(e, false);
- }
-
- private String aendern(HttpExchange e) throws IOException {
- return schreiben(e, true);
- }
-
- private String schreiben(HttpExchange e, boolean overwrite) throws IOException {
+ private String put(HttpExchange e) throws IOException {
String path = e.getRequestURI().toString();
String[] elems = path.split(App.getRs(Server.RB_SLASH));
- String type = elems[elems.length - 1];
- String body = bodyLesen(e);
- String filename = "";
- FileStorage fs = new FileStorage(App.getInitParameter(App.getRs(App.RB_AP_CONF)));
- Gson gson = new Gson();
- logger.log(Level.FINE, "type: {0}, token: {1}", new Object[]{type, fs.typeFromName(type).getType().getTypeName()});
- Object o = gson.fromJson(body, fs.typeFromName(type).getType());
- if(o instanceof Entity) {
- Object antwortObjekt = fs.write((Entity) o, overwrite);
- if(antwortObjekt instanceof File) {
- File file = (File) antwortObjekt;
- logger.log(Level.FINE, "Datei {0} geschrieben.", file.getAbsolutePath());
- filename = file.getName();
- return type + FileHandler.STR_BLANK + filename;
+ String type = elems[elems.length - 2];
+ String elemName = elems[elems.length - 1]; // alter Name, wenn Aenderung
+ if(!elemName.equalsIgnoreCase(App.getRs(RB_EP_LISTE))) {
+ FileStorage fs = new FileStorage(App.getInitParameter(App.getRs(App.RB_AP_CONF)));
+ Gson gson = new Gson();
+ logger.log(Level.FINE, "type: {0}, token: {1}", new Object[]{type, fs.typeFromName(type).getType().getTypeName()});
+ Object o = gson.fromJson(bodyLesen(e), fs.typeFromName(type).getType());
+ if(o instanceof Entity) {
+ Entity entity = (Entity) o;
+ if(fs.exists(type, elemName)) {
+ fs.delete(type, elemName);
+ fs.write(entity, true);
+ } else {
+ fs.write(entity, false);
+ }
+ return type + App.getRs(Server.RB_SLASH) + entity.getName();
+ } else {
+ return "Ungueltiges Objekt im Body.";
}
+ } else {
+ return "Ungueltiger Elementname: " + App.getRs(RB_EP_LISTE);
}
- return type + FileHandler.STR_BLANK + " Operation 'neu' fuer bereits existierende Entitaet.";
}
-
- /*
- private String aendern(HttpExchange e) throws IOException {
- return neu(e); // einstweilen wird einfach ueberschrieben
- }
- */
-
private boolean loeschen(HttpExchange e) {
String path = e.getRequestURI().toString();
String[] elems = path.split(App.getRs(Server.RB_SLASH));
@@ -177,9 +172,16 @@
String[] elems = path.split(App.getRs(Server.RB_SLASH));
FileStorage fs = new FileStorage(App.getInitParameter(App.getRs(App.RB_AP_CONF)));
if(path.endsWith(App.getRs(RB_SLASH))) {
- String type = elems[elems.length - 1];
- logger.fine(type);
- List list = fs.list(type);
+ List list = null;
+ if(elems[elems.length - 1].equalsIgnoreCase(App.getRs(RB_EP_LISTE))) {
+ String type = elems[elems.length - 2];
+ logger.fine(type);
+ list = fs.list(type);
+ } else {
+ String type = elems[elems.length - 1];
+ logger.fine(type);
+ list = fs.listObjects(type);
+ }
return jsonWithEnclosingType(list);
} else {
String type = elems[elems.length - 2];
--
Gitblit v1.9.3