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

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      java.util.Collection<java.lang.String> getAllFilenames​(int volumeId)
      Die Implementierung dieser Methode gibt alle Dateinamen eines Speichermediums der Sicherung zurück.
      void restoreFile​(java.lang.String filename, int volumeID, java.io.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​(java.lang.String filename, java.io.File directory)
      Die Implementierung dieser Methode speichert eine Datei mit einem festgelegten Dateinamen auf einen Datenträger der Sicherung.
      java.util.Collection<java.lang.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.
    • Method Detail

      • saveFile

        int saveFile​(java.lang.String filename,
                     java.io.File directory)
              throws java.io.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:
        java.io.IOException - Fehler beim speichern der Datei auf dem Datenträger der Sicherung oder beim Zugriff auf die zu sichernden Datei
      • restoreFile

        void restoreFile​(java.lang.String filename,
                         int volumeID,
                         java.io.File restoreDirectory)
                  throws java.io.IOException,
                         java.lang.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:
        java.io.IOException - Der Zugriff auf die Datei über das Speichermedium der Sicherung ist fehlgeschlagen
        java.lang.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

        java.util.Collection<java.lang.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

        java.util.Collection<java.lang.String> getAllFilenames​(int volumeId)
                                                        throws java.io.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:
        java.io.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