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.
Modifier and Type | Method and 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.
|
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.
filename
- Dateiname, unter dem die Datei gesichert werden mussdirectory
- Verzeichnis, unter dem die Datei zu finden ist, die gesichert werden solljava.io.IOException
- Fehler beim speichern der Datei auf dem Datenträger der Sicherung oder beim Zugriff auf die zu sichernden Dateivoid 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.
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 mussjava.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 Sicherungjava.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.
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.
volumeId
- Speichermedium, von dem alle Dateinamen angefordert werdensaveFile
der Sicherung übergeben worden seinjava.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