| | |
|---|
| | | /** |
|---|
| | | * Klassen fuer das Dateimanagement. |
|---|
| | | * Klassen fuer das Dateimanagement mit <code>java.nio.file</code>. |
|---|
| | | * |
|---|
| | | * Die folgenden Funktionen sind enthalten: |
|---|
| | | * |
|---|
| | | * Dateiinhalt abrufen: |
|---|
| | | * String json = new Lister().liste(ordnerName, ctx, basisOrdner); |
|---|
| | | * <pre> |
|---|
| | | * Ordnerinhalt auflisten: |
|---|
| | | * Catalog().list(relPathAndName, miniUrlBase, baseDir) |
|---|
| | | * |
|---|
| | | * Datei speichern: |
|---|
| | | * Writer().speichern(file, content) |
|---|
| | | * |
|---|
| | | * Dateien und Ordner loeschen: |
|---|
| | | * Eraser().deleteFiles(relPfad, dateiname, basis) |
|---|
| | | * |
|---|
| | | * Kopieren von Dateien und Ordnern: |
|---|
| | | * Mover().copy(quelle, ziel, dateiNamen, base) |
|---|
| | | * |
|---|
| | | * Verschieben von Dateien und Ordnern: |
|---|
| | | * Mover().move(quelle, ziel, dateiNamen, base) |
|---|
| | | * |
|---|
| | | * Duplizieren einer Datei: |
|---|
| | | * Duplicator().duplizieren(base, fileName) |
|---|
| | | * |
|---|
| | | * Umbenennen einer Datei oder eines Ordners: |
|---|
| | | * Renamer().umbenennen(exchange, fileName, params[1], file) |
|---|
| | | * |
|---|
| | | * Packen eines Ordners: |
|---|
| | | * Deflator().packFolder(fileName, path, base) |
|---|
| | | * |
|---|
| | | * Entpacken einer ZIP-Datei: |
|---|
| | | * Inflator().extractZipfile(fileName, path, base) |
|---|
| | | * </pre> |
|---|
| | | * |
|---|
| | | * Die hier enthaltenen Funktionen beinhalten keine Massnahmen gegen Path Traversal o.ä. |
|---|
| | | * Dies ist beabsichtigt, um Pfadausdruecke wie z.B. '../' bei den hier implementierten |
|---|
| | | * Dateioperationen verarbeiten zu koennen. |
|---|
| | | * |
|---|
| | | * <p><b>Programme, die diese Klassenbibliothek einsetzen, muessen eigene Massnahmen gegen |
|---|
| | | * Path Traversal o.ä. vorschalten, sofern dies nicht gewuenscht ist.</b></p> |
|---|
| | | * |
|---|
| | | * <p>Die folgenden Funktionalitaeten sind in dieser Auspraegung einer |
|---|
| | | * Dateiverwaltung fest angelegt. Sie sind damit Kandidaten fuer eine |
|---|
| | | * Erweiterung dieser Klassenbibliothek um andere evtl. benoetigte |
|---|
| | | * Auspraegungen.</p> |
|---|
| | | * |
|---|
| | | * <p><b>Handhabung von Bilddateien</b></p> |
|---|
| | | * |
|---|
| | | * Neben der Datei eines Bildes in Originalgroesse werden weitere Dateien als Varianten |
|---|
| | | * eines Bildes unterstuetzt. |
|---|
| | | * |
|---|
| | | * In Dateilisten werden diese Varianten ausgeblendet und nur das Originalbild gezeigt. |
|---|
| | | * |
|---|
| | | * Die Dateinamen von Varianten eines Bildes muessen dazu einen mit Unterstrich beginnenden |
|---|
| | | * Namenszusatz enthalten wie bspw. <code>_tn</code> fuer thumbnail oder <code>_sm</code> |
|---|
| | | * fuer small usw. Gleichsam lassen sich damit Eigenschaften wie zum Beispiel |
|---|
| | | * eine Base64-Kodierung kombinieren. Hier waere der Namenszusatz dann eine Kombination |
|---|
| | | * aus Groesse und Kodierung wie mit <code>_sm_b64</code>, so dass sich fuer ein Bild stets |
|---|
| | | * eine ganze Gruppe von Dateien ergibt, z.B.: |
|---|
| | | * |
|---|
| | | * <pre> |
|---|
| | | * bild.jpg |
|---|
| | | * bild_sm.jpg |
|---|
| | | * bild_sm_b64.jpg |
|---|
| | | * </pre> |
|---|
| | | * |
|---|
| | | * Alle Dateioperationen dieser Klassenbibliothek wirken dennoch stets auf |
|---|
| | | * alle Varianten des Bildes, wie es auf der Kommandozeile mit einem Wildcard-Operator |
|---|
| | | * gemacht wuerde, z.B. |
|---|
| | | * |
|---|
| | | * <pre> |
|---|
| | | * cp /pfad/zum/bild*.jpg /pfad/zum/zielordner |
|---|
| | | * </pre> |
|---|
| | | * |
|---|
| | | * Eine Dateiliste enthaelt aus diesem Grund fuer Bilddateien die beiden zusaetzlichen Angaben |
|---|
| | | * <code>miniurl</code> und <code>imgsrc</code>. |
|---|
| | | * |
|---|
| | | * <p><b>Ordnerliste im JSON-Format</b></p> |
|---|
| | | * |
|---|
| | | * Die Liste mit Dateien eines Ordners wird im JSON-Format ausgegeben. Ueber eine |
|---|
| | | * entsprechende Erweiterung koennte die Ausgabe in verschiedenen waehlbaren Formaten |
|---|
| | | * erfolgen. |
|---|
| | | * |
|---|
| | | * Die Transformation nach JSON erfordert die Package <code>com.google.gson.Gson</code>. |
|---|
| | | * |
|---|
| | | */ |
|---|
| | | package de.uhilger.fm; |
|---|
