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 MethodesaveFile
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 mussdirectory
- 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 MethodesaveFile
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 wirdvolumeID
- 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 fehlgeschlagenjava.lang.IllegalArgumentException
- Die angegebene Datei war auf dem angegebenen Datenträger nicht zu findenBadVolumeException
- 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 MethodesaveFile
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 fehlgeschlagenBadVolumeException
- Der angegebene Datenträger ist nicht mehr vorhanden oder nicht mehr im direkten Zugriff der Sicherung
-
-