/*
  fm - File management class library
  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.fm;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.net.URLDecoder;
import java.util.logging.Level;
import java.util.logging.Logger;

/**
 * Dateien und Ordner anlegen sowie gegebenenfalls den Inhalt von Dateien speichern.
 * 
 * @author Ulrich Hilger
 * @version 0.1, 07.11.2024
 */
public class Writer {

  /**
   * Einen Ordner anlegen, wenn er noch nicht exisitert
   * 
   * @param file der Ordner, der angelegt werden soll
   * @return 0, wenn der Ordner angelegt wurde, -1 wenn nicht
   */
  public int newFolder(File file) {
    if (!file.exists()) {
      file.mkdir();
      return 0;
    } else {
      return -1;
    }
  }
  
  /**
   * Datei speichern. 
   * 
   * <p>Eine existierende Datei gleichen Namens wird 
   * zuvor geloescht (= Ueberschreiben).</p> 
   * 
   * <p>Wenn Aenderungen in eine schon existierende Datei gespeichert werden 
   * sollen, ist es noetig, die existierende Datei mit dem neuen Inhalt zu 
   * ueberschreiben, so, wie es diese Methode ausfuehrt.</p>
   * 
   * <p>Soll statdessen eine Datei neu erstellt werden und wird dabei also unterstellt, dass 
   * unter ihrem Namen am Ablageort noch keine Datei gleichen Namens existiert, muss 
   * vor der Verwendung dieser Methode sichergestellt werden, dass es so ist.</p>
   * 
   * @param file die Datei, in die gespeichert werden soll
   * @param content  der zu speichernde Inhalt
   * @return 0, wenn erfolgreich, sonst -1
   */
  public int speichern(File file, String content) {
    try {
      if (file.exists()) {
        /*
        muss delete() sein?
        pruefen: ueberschreibt der FileWriter den alten Inhalt oder
        entsteht eine unerwuenschte Mischung aus altem und neuem
        Inhalt?
        */
        file.delete();
      } else {
        file.getParentFile().mkdirs();
      }
      String decoded = URLDecoder.decode(content, "UTF-8");
      byte[] bytes = decoded.getBytes();
      file.createNewFile();
      try (OutputStream os = new FileOutputStream(file)) {
        os.write(bytes);
        os.flush();
      }
      return 0;
    } catch (IOException ex) {
      Logger.getLogger(Writer.class.getName()).log(Level.SEVERE, null, ex);
      return -1;
    }      
  }  
}