org.rocksdb

Class OptimisticTransactionDB

java.lang.Object

org.rocksdb.AbstractNativeReference

org.rocksdb.AbstractImmutableNativeReference

org.rocksdb.RocksObject

org.rocksdb.RocksDB

org.rocksdb.OptimisticTransactionDB

All Implemented Interfaces:

java.lang.AutoCloseable

public class OptimisticTransactionDB
extends RocksDB

Database with Transaction support.

Field Summary

Fields inherited from class org.rocksdb.RocksDB

DEFAULT_COLUMN_FAMILY, NOT_FOUND, options_

Fields inherited from class org.rocksdb.RocksObject

nativeHandle_

Method Summary

Methods

Modifier and Type	Method and Description
Transaction	beginTransaction(WriteOptions writeOptions) Starts a new Transaction.
Transaction	beginTransaction(WriteOptions writeOptions, OptimisticTransactionOptions optimisticTransactionOptions) Starts a new Transaction.
Transaction	beginTransaction(WriteOptions writeOptions, OptimisticTransactionOptions optimisticTransactionOptions, Transaction oldTransaction) Starts a new Transaction.
Transaction	beginTransaction(WriteOptions writeOptions, Transaction oldTransaction) Starts a new Transaction.
protected void	disposeInternal(long handle)
RocksDB	getBaseDB() Get the underlying database that was opened.
static OptimisticTransactionDB	open(DBOptions dbOptions, java.lang.String path, java.util.List<ColumnFamilyDescriptor> columnFamilyDescriptors, java.util.List<ColumnFamilyHandle> columnFamilyHandles) Open an OptimisticTransactionDB similar to RocksDB.open(DBOptions, String, List, List).
protected static long	open(long optionsHandle, java.lang.String path)
protected static long[]	open(long handle, java.lang.String path, byte[][] columnFamilyNames, long[] columnFamilyOptions)
static OptimisticTransactionDB	open(Options options, java.lang.String path) Open an OptimisticTransactionDB similar to RocksDB.open(Options, String).

Methods inherited from class org.rocksdb.RocksDB

compactRange, compactRange, compactRange, compactRange, compactRange, compactRange, compactRange, compactRange, compactRange, continueBackgroundWork, createColumnFamily, delete, delete, delete, delete, delete, delete, delete, delete, delete, delete, delete, delete, deleteRange, deleteRange, deleteRange, deleteRange, deleteRange, deleteRange, deleteRange, deleteRange, destroyDB, disableFileDeletions, dropColumnFamily, enableFileDeletions, flush, flush, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, getAggregatedLongProperty, getAggregatedLongProperty, getDefaultColumnFamily, getLatestSequenceNumber, getLongProperty, getLongProperty, getLongProperty, getLongProperty, getProperty, getProperty, getProperty0, getProperty0, getSnapshot, getSnapshot, getUpdatesSince, ingestExternalFile, ingestExternalFile, iterator, iterator, iteratorCF, iteratorCF, iterators, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, listColumnFamilies, listColumnFamilies, loadLibrary, loadLibrary, merge, merge, merge, merge, merge, merge, merge, merge, merge, merge, merge, merge, multiGet, multiGet, multiGet, multiGet, multiGet, multiGet, multiGet, multiGet, newIterator, newIterator, newIterator, newIterator, newIterators, newIterators, open, open, openReadOnly, openReadOnly, openReadOnly, openReadOnly, openROnly, openROnly, pauseBackgroundWork, put, put, put, put, put, put, put, put, put, put, put, put, releaseSnapshot, releaseSnapshot, remove, remove, remove, remove, setOptions, singleDelete, singleDelete, singleDelete, singleDelete, singleDelete, singleDelete, singleDelete, singleDelete, storeOptionsInstance, write, write, write0, write1

Methods inherited from class org.rocksdb.RocksObject

disposeInternal

Methods inherited from class org.rocksdb.AbstractImmutableNativeReference

close, disOwnNativeHandle, isOwningHandle

Methods inherited from class org.rocksdb.AbstractNativeReference

dispose, finalize

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.AutoCloseable

close

Method Detail

open

public static OptimisticTransactionDB open(Options options,
                           java.lang.String path)
                                    throws RocksDBException

Open an OptimisticTransactionDB similar to RocksDB.open(Options, String).

Parameters:

options - Options instance.

path - the path to the rocksdb.

Returns:

a OptimisticTransactionDB instance on success, null if the specified OptimisticTransactionDB can not be opened.

Throws:

RocksDBException - if an error occurs whilst opening the database.

open

public static OptimisticTransactionDB open(DBOptions dbOptions,
                           java.lang.String path,
                           java.util.List<ColumnFamilyDescriptor> columnFamilyDescriptors,
                           java.util.List<ColumnFamilyHandle> columnFamilyHandles)
                                    throws RocksDBException

Open an OptimisticTransactionDB similar to RocksDB.open(DBOptions, String, List, List).

Parameters:

dbOptions - DBOptions instance.

path - the path to the rocksdb.

columnFamilyDescriptors - list of column family descriptors

columnFamilyHandles - will be filled with ColumnFamilyHandle instances

Returns:

a OptimisticTransactionDB instance on success, null if the specified OptimisticTransactionDB can not be opened.

Throws:

RocksDBException - if an error occurs whilst opening the database.

beginTransaction

public Transaction beginTransaction(WriteOptions writeOptions)

Starts a new Transaction. Caller is responsible for calling AutoCloseable.close() on the returned transaction when it is no longer needed.

Parameters:

writeOptions - Any write options for the transaction

Returns:

a new transaction

beginTransaction

public Transaction beginTransaction(WriteOptions writeOptions,
                           OptimisticTransactionOptions optimisticTransactionOptions)

Starts a new Transaction. Caller is responsible for calling AutoCloseable.close() on the returned transaction when it is no longer needed.

Parameters:

writeOptions - Any write options for the transaction

optimisticTransactionOptions - Any options for the transaction

Returns:

a new transaction

beginTransaction

public Transaction beginTransaction(WriteOptions writeOptions,
                           Transaction oldTransaction)

Starts a new Transaction. Caller is responsible for calling AutoCloseable.close() on the returned transaction when it is no longer needed.

Parameters:

writeOptions - Any write options for the transaction

oldTransaction - this Transaction will be reused instead of allocating a new one. This is an optimization to avoid extra allocations when repeatedly creating transactions.

Returns:

The oldTransaction which has been reinitialized as a new transaction

beginTransaction

public Transaction beginTransaction(WriteOptions writeOptions,
                           OptimisticTransactionOptions optimisticTransactionOptions,
                           Transaction oldTransaction)

Starts a new Transaction. Caller is responsible for calling AutoCloseable.close() on the returned transaction when it is no longer needed.

Parameters:

writeOptions - Any write options for the transaction

optimisticTransactionOptions - Any options for the transaction

oldTransaction - this Transaction will be reused instead of allocating a new one. This is an optimization to avoid extra allocations when repeatedly creating transactions.

Returns:

The oldTransaction which has been reinitialized as a new transaction

getBaseDB

public RocksDB getBaseDB()

Get the underlying database that was opened.

Returns:

The underlying database that was opened.

open

protected static long open(long optionsHandle,
        java.lang.String path)
                    throws RocksDBException

Throws:

RocksDBException

open

protected static long[] open(long handle,
          java.lang.String path,
          byte[][] columnFamilyNames,
          long[] columnFamilyOptions)

disposeInternal

protected final void disposeInternal(long handle)

Overrides:

disposeInternal in class RocksDB