de.bsvrz.dav.daf.main.impl.archive.filesaver
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.

Author:
Kappich+Kniß Systemberatung Aachen (K2S), Achim Wullenkord (AW)

Method Summary
 Collection<String> 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.
 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.
 

Method Detail

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