org.rocksdb

Class TransactionDB

java.lang.Object

org.rocksdb.AbstractNativeReference

org.rocksdb.AbstractImmutableNativeReference

org.rocksdb.RocksObject

org.rocksdb.RocksDB

org.rocksdb.TransactionDB

All Implemented Interfaces:

java.lang.AutoCloseable

public class TransactionDB
extends RocksDB

Database with Transaction support

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TransactionDB.DeadlockInfo
static class	TransactionDB.DeadlockPath
static class	TransactionDB.KeyLockInfo

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, Transaction oldTransaction) Starts a new Transaction.
Transaction	beginTransaction(WriteOptions writeOptions, TransactionOptions transactionOptions) Starts a new Transaction.
Transaction	beginTransaction(WriteOptions writeOptions, TransactionOptions transactionOptions, Transaction oldTransaction) Starts a new Transaction.
protected void	disposeInternal(long handle)
java.util.List<Transaction>	getAllPreparedTransactions()
TransactionDB.DeadlockPath[]	getDeadlockInfoBuffer()
java.util.Map<java.lang.Long,TransactionDB.KeyLockInfo>	getLockStatusData() Returns map of all locks held.
Transaction	getTransactionByName(java.lang.String transactionName)
static TransactionDB	open(DBOptions dbOptions, TransactionDBOptions transactionDbOptions, java.lang.String path, java.util.List<ColumnFamilyDescriptor> columnFamilyDescriptors, java.util.List<ColumnFamilyHandle> columnFamilyHandles) Open a TransactionDB, similar to RocksDB.open(DBOptions, String, List, List).
static TransactionDB	open(Options options, TransactionDBOptions transactionDbOptions, java.lang.String path) Open a TransactionDB, similar to RocksDB.open(Options, String).
void	setDeadlockInfoBufferSize(int targetSize)

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, open, open, 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 TransactionDB open(Options options,
                 TransactionDBOptions transactionDbOptions,
                 java.lang.String path)
                          throws RocksDBException

Open a TransactionDB, similar to RocksDB.open(Options, String).

Parameters:

options - Options instance.

transactionDbOptions - TransactionDBOptions instance.

path - the path to the rocksdb.

Returns:

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

Throws:

RocksDBException - if an error occurs whilst opening the database.

open

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

Open a TransactionDB, similar to RocksDB.open(DBOptions, String, List, List).

Parameters:

dbOptions - DBOptions instance.

transactionDbOptions - TransactionDBOptions instance.

path - the path to the rocksdb.

columnFamilyDescriptors - list of column family descriptors

columnFamilyHandles - will be filled with ColumnFamilyHandle instances

Returns:

a TransactionDB instance on success, null if the specified TransactionDB 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,
                           TransactionOptions transactionOptions)

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

transactionOptions - 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,
                           TransactionOptions transactionOptions,
                           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

transactionOptions - 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

getTransactionByName

public Transaction getTransactionByName(java.lang.String transactionName)

getAllPreparedTransactions

public java.util.List<Transaction> getAllPreparedTransactions()

getLockStatusData

public java.util.Map<java.lang.Long,TransactionDB.KeyLockInfo> getLockStatusData()

Returns map of all locks held.

Returns:

a map of all the locks held.

getDeadlockInfoBuffer

public TransactionDB.DeadlockPath[] getDeadlockInfoBuffer()

setDeadlockInfoBufferSize

public void setDeadlockInfoBufferSize(int targetSize)

disposeInternal

protected final void disposeInternal(long handle)

Overrides:

disposeInternal in class RocksDB