Interface ArchiveFileSaver


public interface ArchiveFileSaver
Dieses Interface stellt einem Archivsystem die Möglichkeit zur Verfügung Dateien dauerhaft zu speichern. Die Implementierung, die diese Aufgabe übernimmt, wird auch als Sicherung bezeichnet.
  • Method Summary

    Modifier and Type
    Method
    Description
    getAllFilenames(int volumeId)
    Die Implementierung dieser Methode gibt alle Dateinamen eines Speichermediums der Sicherung zurück.
    void
    restoreFile(String filename, int volumeID, File restoreDirectory)
    Die Implementierung dieser Methode stellt eine Datei zur Verfügung, die mit der Methode saveFile auf einen Datenträger der Sicherung gesichert wurde.
    int
    saveFile(String filename, File directory)
    Die Implementierung dieser Methode speichert eine Datei mit einem festgelegten Dateinamen auf einen Datenträger der Sicherung.
    Die Implementierung dieser Methode stellt eine Liste mit den eindeutigen Identifizierungen aller Datenträger zusammen, die sich im direkten Zugriff der Sicherung befinden.
  • Method Details

    • saveFile

      int saveFile(String filename, File directory) throws IOException
      Die Implementierung dieser Methode speichert eine Datei mit einem festgelegten Dateinamen auf einen Datenträger der Sicherung. Nachdem die Datei dauerhaft auf dem Datenträger gesichert wurde, wird die eindeutige Datenträgeridentifikation des Datenträgers zurückgegeben.
      Parameters:
      filename - Dateiname, unter dem die Datei gesichert werden muss
      directory - Verzeichnis, unter dem die Datei zu finden ist, die gesichert werden soll
      Returns:
      Eindeutige Datenträgerindentifikation, auf dem die zu sichernde Datei gesichert wurde
      Throws:
      IOException - Fehler beim speichern der Datei auf dem Datenträger der Sicherung oder beim Zugriff auf die zu sichernden Datei
    • restoreFile

      void restoreFile(String filename, int volumeID, File restoreDirectory) throws IOException, IllegalArgumentException, BadVolumeException
      Die Implementierung dieser Methode stellt eine Datei zur Verfügung, die mit der Methode saveFile auf einen Datenträger der Sicherung gesichert wurde. Damit die Datei eindeutig zu identifizieren ist, wird sowohl die Identifizierung des Speichermediums, als auch der Name der Datei angegeben. Die Datei wird dem angegebenen Verzeichnis zur Verfügung gestellt.
      Parameters:
      filename - Name der Datei, die benötigt wird
      volumeID - Eindeutige Identifizierung des Datenträgers, auf dem die benötigte Datei gespeichert wurde (volumeID > 0)
      restoreDirectory - Verzeichnis, unter dem die Datei zur Verfügung gestellt werden muss
      Throws:
      IOException - Der Zugriff auf die Datei über das Speichermedium der Sicherung ist fehlgeschlagen
      IllegalArgumentException - Die angegebene Datei war auf dem angegebenen Datenträger nicht zu finden
      BadVolumeException - Der angegebene Datenträger ist nicht mehr vorhanden oder nicht mehr im direkten Zugriff der Sicherung
    • volumesDirectAccess

      Collection<Integer> volumesDirectAccess()
      Die Implementierung dieser Methode stellt eine Liste mit den eindeutigen Identifizierungen aller Datenträger zusammen, die sich im direkten Zugriff der Sicherung befinden.
      Returns:
      Eindeutige Datenträgeridentifikation aller Datenträger, die sich im direkten Zugriff befinden
    • getAllFilenames

      Collection<String> getAllFilenames(int volumeId) throws IOException, BadVolumeException
      Die Implementierung dieser Methode gibt alle Dateinamen eines Speichermediums der Sicherung zurück. Die ausgwählten Dateien müssen mit der Methode saveFile der Sicherung übergeben worden sein.
      Parameters:
      volumeId - Speichermedium, von dem alle Dateinamen angefordert werden
      Returns:
      Alle Dateinamen, die auf dem angegebenen Speichermedium gespeichert sind. Die Dateien müssen mit der Methode saveFile der Sicherung übergeben worden sein
      Throws:
      IOException - Der physische Zugriff auf den Datenträger ist fehlgeschlagen
      BadVolumeException - Der angegebene Datenträger ist nicht mehr vorhanden oder nicht mehr im direkten Zugriff der Sicherung