org.opends.server.backends.pluggable.spi

Interface Importer

All Superinterfaces:

AutoCloseable, Closeable

@ThreadSafe
public interface Importer
extends Closeable

Allows to run an import. For performance reasons, imports are run without transactions.

Since import is multi threaded, implementations must be thread-safe.

Method Summary

Modifier and Type	Method and Description
void	clearTree(TreeName treeName) Clear the tree whose name is provided.
void	close()
SequentialCursor<ByteString,ByteString>	openCursor(TreeName treeName) Opens a cursor on the tree whose name is provided.
void	put(TreeName treeName, ByteSequence key, ByteSequence value) Creates a record with the provided key and value in the tree identified by the provided name.
ByteString	read(TreeName treeName, ByteSequence key) Reads the record's value associated to the provided key, in the tree whose name is provided.

Method Detail

clearTree

void clearTree(TreeName treeName)

Clear the tree whose name is provided. Ensure that an empty tree with the given name exists. If the tree already exists, all the data it contains will be deleted. If not, an empty tree will be created.

Parameters:

treeName - name of the tree to clear

put

void put(TreeName treeName,
         ByteSequence key,
         ByteSequence value)

Creates a record with the provided key and value in the tree identified by the provided name. At the end of this method, the record is visible by read(TreeName, ByteSequence) and openCursor(TreeName) methods of this instance. The record is guaranteed to be persisted only after close().

Parameters:

treeName - the tree name

key - the new record's key

value - the new record's value

read

ByteString read(TreeName treeName,
                ByteSequence key)

Reads the record's value associated to the provided key, in the tree whose name is provided.

Parameters:

treeName - the tree name

key - the record's key

Returns:

the record's value, or null if none exists

openCursor

SequentialCursor<ByteString,ByteString> openCursor(TreeName treeName)

Opens a cursor on the tree whose name is provided. Cursors are predictable only if there is no pending put(TreeName, ByteSequence, ByteSequence) operations. Indeed, once opened, cursors might not reflect changes.

Parameters:

treeName - the tree name

Returns:

a new cursor

close

void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable