org.rocksdb

Class ColumnFamilyHandle

java.lang.Object

org.rocksdb.AbstractNativeReference

org.rocksdb.AbstractImmutableNativeReference

org.rocksdb.RocksObject

org.rocksdb.ColumnFamilyHandle

All Implemented Interfaces:

AutoCloseable

public class ColumnFamilyHandle
extends RocksObject

ColumnFamilyHandle class to hold handles to underlying rocksdb ColumnFamily Pointers.

Field Summary

Fields inherited from class org.rocksdb.RocksObject

nativeHandle_

Fields inherited from class org.rocksdb.AbstractImmutableNativeReference

owningHandle_

Method Summary

Modifier and Type	Method and Description
protected void	disposeInternal() Deletes underlying C++ iterator pointer.
protected void	disposeInternal(long handle)
boolean	equals(Object o)
ColumnFamilyDescriptor	getDescriptor() Gets the up-to-date descriptor of the column family associated with this handle.
int	getID() Gets the ID of the Column Family.
byte[]	getName() Gets the name of the Column Family.
int	hashCode()
protected boolean	isDefaultColumnFamily()

Methods inherited from class org.rocksdb.RocksObject

getNativeHandle

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, getClass, notify, notifyAll, toString, wait, wait, wait

Method Detail

getName

public byte[] getName()
               throws RocksDBException

Gets the name of the Column Family.

Returns:

The name of the Column Family.

Throws:

RocksDBException - if an error occurs whilst retrieving the name.

getID

public int getID()

Gets the ID of the Column Family.

Returns:

the ID of the Column Family.

getDescriptor

public ColumnFamilyDescriptor getDescriptor()
                                     throws RocksDBException

Gets the up-to-date descriptor of the column family associated with this handle. Since it fills "*desc" with the up-to-date information, this call might internally lock and release DB mutex to access the up-to-date CF options. In addition, all the pointer-typed options cannot be referenced any longer than the original options exist. Note that this function is not supported in RocksDBLite.

Returns:

the up-to-date descriptor.

Throws:

RocksDBException - if an error occurs whilst retrieving the descriptor.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

isDefaultColumnFamily

protected boolean isDefaultColumnFamily()

disposeInternal

protected void disposeInternal()

Deletes underlying C++ iterator pointer.

Note: the underlying handle can only be safely deleted if the RocksDB instance related to a certain ColumnFamilyHandle is still valid and initialized. Therefore disposeInternal() checks if the RocksDB is initialized before freeing the native handle.

Overrides:

disposeInternal in class RocksObject

disposeInternal

protected final void disposeInternal(long handle)

Specified by:

disposeInternal in class RocksObject