org.opends.server.backends.pluggable.spi

Interface Storage

All Superinterfaces:

AutoCloseable, Closeable

All Known Implementing Classes:

JEStorage

public interface Storage
extends Closeable

This interface abstracts the underlying storage engine, isolating the pluggable backend generic code from a particular storage engine implementation.

Method Summary

Modifier and Type	Method and Description
void	close()
void	createBackup(BackupConfig backupConfig) Creates a backup for this storage.
StorageStatus	getStorageStatus() Returns the current status of the storage.
Set<TreeName>	listTrees() Lists the trees that exist in this storage.
void	open(AccessMode accessMode) Opens the storage engine to allow executing operations on it.
<T> T	read(ReadOperation<T> readOperation) Executes a read operation.
void	removeBackup(BackupDirectory backupDirectory, String backupID) Removes a backup for this storage.
void	removeStorageFiles() Remove all files for a backend of this storage.
void	restoreBackup(RestoreConfig restoreConfig) Restores a backup for this storage.
Importer	startImport() Starts the import operation.
boolean	supportsBackupAndRestore() Returns true if this storage supports backup and restore.
void	write(WriteOperation writeOperation) Executes a write operation.

Method Detail

startImport

Importer startImport()
              throws ConfigException,
                     StorageRuntimeException

Starts the import operation.

Returns:

a new Importer object which must be closed to release all resources

Throws:

ConfigException - if there is a problem with the configuration

StorageRuntimeException - if a problem occurs with the underlying storage engine

See Also:

to release all resources once import is finished

open

void open(AccessMode accessMode)
   throws Exception

Opens the storage engine to allow executing operations on it.

Parameters:

accessMode - Specify the access mode to this storage.

Throws:

NullPointerException - if accessMode is null.

Exception - if a problem occurs with the underlying storage engine

See Also:

to release all resources once import is finished

read

<T> T read(ReadOperation<T> readOperation)
    throws Exception

Executes a read operation. In case of a read operation rollback, implementations must ensure the read operation is retried until it succeeds.

Type Parameters:

T - type of the value returned

Parameters:

readOperation - the read operation to execute

Returns:

the value read by the read operation

Throws:

Exception - if a problem occurs with the underlying storage engine

write

void write(WriteOperation writeOperation)
    throws Exception

Executes a write operation. In case of a write operation rollback, implementations must ensure the write operation is retried until it succeeds.

Parameters:

writeOperation - the write operation to execute

Throws:

Exception - if a problem occurs with the underlying storage engine

removeStorageFiles

void removeStorageFiles()
                 throws StorageRuntimeException

Remove all files for a backend of this storage.

Throws:

StorageRuntimeException - if removal fails

getStorageStatus

StorageStatus getStorageStatus()

Returns the current status of the storage.

Returns:

the current status of the storage

supportsBackupAndRestore

boolean supportsBackupAndRestore()

Returns true if this storage supports backup and restore.

Returns:

true if this storage supports backup and restore.

createBackup

void createBackup(BackupConfig backupConfig)
           throws LdapException

Creates a backup for this storage.

Parameters:

backupConfig - The configuration to use when performing the backup.

Throws:

LdapException - If a Directory Server error occurs.

removeBackup

void removeBackup(BackupDirectory backupDirectory,
                  String backupID)
           throws LdapException

Removes a backup for this storage.

Parameters:

backupDirectory - The backup directory structure with which the specified backup is associated.

backupID - The backup ID for the backup to be removed.

Throws:

LdapException - If it is not possible to remove the specified backup.

restoreBackup

void restoreBackup(RestoreConfig restoreConfig)
            throws LdapException

Restores a backup for this storage.

Parameters:

restoreConfig - The configuration to use when performing the restore.

Throws:

LdapException - If a Directory Server error occurs.

listTrees

Set<TreeName> listTrees()

Lists the trees that exist in this storage.

Returns:

a set of TreeNames representing the trees that exist in this storage

close

void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable