Package de.bsvrz.ars.ars.backup
Interface BackupModul
@Deprecated
public interface BackupModul
Deprecated.
Diese Klasse dient als Interface für alle Backup-Module.
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
PROP_BACKUP_CONTAINER_PER_ZIP
Deprecated.static java.lang.String
PROP_BACKUP_MEDIUMSIZE
Deprecated. -
Method Summary
Modifier and Type Method Description void
backupContainer(int mediumID, long contID, java.io.File contFile)
Deprecated.Mit dieser Methode wird festgelegt, dass ein Container auf dem angegebenen und vorher geöffneten Medium zu speichern ist.void
closeMediumAfterBackup(int mediumID, java.io.File indexFile)
Deprecated.Sobald auf einem Medium keine Kapazität für weitere Container mehr vorhanden ist, wird der aktuelle Backup-Lauf auf diesem Medium mit dieser Methode abgeschlossen.java.util.List<java.lang.String>
getAllContFileNames(Task task, int mediumID, int maxLimit)
Deprecated.Liefert die zuletzt gesicherten Container, die sich auf dem Mediums befinden.boolean
hasMediumCapacity(int mediumID, long containerSize, int mediumIndexSize)
Deprecated.Liefert true, falls die noch zur Verfügung stehende Kapazität des angegebenen Mediums ausreicht, um einen Container der GrößefileSize
und den Medienindex mit der momentanen GrößeindexSize
zu speichern.void
initialize(java.util.Properties props)
Deprecated.Diese Methode dient dem Initialisieren des BackupModuls.void
openMediumBeforeBackup(int mediumID, java.lang.String backupRunID)
Deprecated.Diese Methode wird aufgerufen, bevor der erste Container auf dem Medium gesichert wird.java.io.InputStream
restoreContainer(int mediumID, java.lang.String contFileName)
Deprecated.Mit dieser Methode wird einInputStream
der Containerdaten des Containers mit NamencontFile
auf dem MediummediumID
erzeugt.
-
Field Details
-
PROP_BACKUP_CONTAINER_PER_ZIP
static final java.lang.String PROP_BACKUP_CONTAINER_PER_ZIPDeprecated.- See Also:
- Constant Field Values
-
PROP_BACKUP_MEDIUMSIZE
static final java.lang.String PROP_BACKUP_MEDIUMSIZEDeprecated.- See Also:
- Constant Field Values
-
-
Method Details
-
initialize
void initialize(java.util.Properties props)Deprecated.Diese Methode dient dem Initialisieren des BackupModuls. Da die Plugins immer mit leerem Konstruktor initialisiert werden, werden mit dieser Methode die Plugin-spezifischen Einstellungen vorgenommen. Fehlt ein obligatorischer Property-Key, wird eine Exception geworfen.- Parameters:
props
-
-
hasMediumCapacity
boolean hasMediumCapacity(int mediumID, long containerSize, int mediumIndexSize)Deprecated.Liefert true, falls die noch zur Verfügung stehende Kapazität des angegebenen Mediums ausreicht, um einen Container der GrößefileSize
und den Medienindex mit der momentanen GrößeindexSize
zu speichern. Falls die Gesamtkapazität nicht durch den Medientyp eindeutig festgelegt ist, liefert das Backup-Modul einen sinnvollen Wert. Beispiel: 1 GB pro Aktenschrank in Keydox, jedoch keinesfalls die Größe der gesamten Festplatte. Ist das gewünschte Medium nicht im Zugriff, wird eine entsprechende Ausnahme ausgelöst.- Parameters:
mediumID
-containerSize
-mediumIndexSize
-- Returns:
- boolean
-
openMediumBeforeBackup
void openMediumBeforeBackup(int mediumID, java.lang.String backupRunID)Deprecated.Diese Methode wird aufgerufen, bevor der erste Container auf dem Medium gesichert wird. Mit dem Parameter backupRunID können mehrere Backup-Läufe, die dasselbe Medium verwenden, unterschieden werden. Laut Spezifikation in[TanfArS]
kann es im Regelfall nicht auftreten, dass ein Container mehrmals auf demselben Medium abgelegt ist, weil bereits gesicherte Container kein zweitesmal gesichert werden. Es ist dennoch notwendig ein Verhalten für diesen Fall vorzugeben. Beim Wiederherstellen eines Containers wird daher der Container des Mediums verwendet, der unter der alphabetisch größten backupRunID abgelegt wurde.- Parameters:
mediumID
- ID des MediumsbackupRunID
- Zur Identifizierung des Sicherungslaufs falls mehrere Sicherungsläufe auf einem Medium sind. Bei der Wiederherstellung eines Containers werden die Sicherungsläufe von der alphabetisch letzten backupRunID beginnend bis zur alphabetisch ersten backupRunID nach dem angeforderten Container durchsucht.
-
backupContainer
void backupContainer(int mediumID, long contID, java.io.File contFile)Deprecated.Mit dieser Methode wird festgelegt, dass ein Container auf dem angegebenen und vorher geöffneten Medium zu speichern ist. Ob dies sofort geschieht oder später ist Sache der Implementierung. DasBackupModul
kann den ParametercontainerID
verwenden, um z.B. die Container-Dateien zu sortieren oder um Hilfsdatenstrukturen für einen schnellen Zugriff anzulegen.- Parameters:
mediumID
-contID
-contFile
-
-
closeMediumAfterBackup
void closeMediumAfterBackup(int mediumID, java.io.File indexFile)Deprecated.Sobald auf einem Medium keine Kapazität für weitere Container mehr vorhanden ist, wird der aktuelle Backup-Lauf auf diesem Medium mit dieser Methode abgeschlossen. Der Parameter übergibt eine Indexdatei, die alleContainerID
s enthält, die im aktuellen Backup-Lauf auf diesem Medium gesichert wurden. Diese Datei wird auf dem Medium gespeichert. Die weiteren Aufgaben, die einzelne Implementierungen der BackupModule-Schnittstelle hier zu erfüllen haben, sind unterschiedlich. Module, die sofort auf ein Medium schreiben können (Wechselplatten) erfordern keine weiteren Schritte. Für Medien wie DVDs wird in dieser Methode aus den gesammelten Containern ein Image erstellt und auf die DVD gebrannt; bei Keydox wird ein Logout ausgeführt.- Parameters:
mediumID
-indexFile
-
-
restoreContainer
java.io.InputStream restoreContainer(int mediumID, java.lang.String contFileName)Deprecated.Mit dieser Methode wird einInputStream
der Containerdaten des Containers mit NamencontFile
auf dem MediummediumID
erzeugt. Der BackupManager kopiert die Daten je nach Vorgang ganz oder teilweise in das Archivsystem oder in ein temporäres Verzeichnis. Diese Methode wird zum Wiederherstellen eines Containers, zum Abgleich/Wiederherstellung der Verwaltungsinformation und zur Verifikation verwendet.- Parameters:
mediumID
-contFileName
-- Returns:
- InputStream
-
getAllContFileNames
Deprecated.Liefert die zuletzt gesicherten Container, die sich auf dem Mediums befinden.Wird für den Abgleich von Verwaltungsinformationen (@link HeaderRestoreTask) benoetigt.
- Parameters:
task
- Wird zum Anhalten des Backups benötigt, falls das Archivsystem in einen kritischen Bereich eintritt.mediumID
- MedienId des Mediums.maxLimit
- maximale Anzahl an zurückgegebenen Containernamen. Wenn -1, dann ist das Ergebnis unlimitiert.- Returns:
- Liste mit den Filenames der Container.
-
BackupModule
ersetzt werden, da eine bessere Performance und ein einfacheres Interface erreicht werden kann.