com.neocoretechs.rocksack.session

Class Session

java.lang.Object

com.neocoretechs.rocksack.session.Session

Direct Known Subclasses:

TransactionSession

public class Session
extends java.lang.Object

Session object. Returned by SessionManager.Connect(). Responsible for providing access to Deep Store key/value interface implementations Operations include handing out iterators, inserting and deleting objects, size, navigation, clearing, and handling commit and rollback.

Session is the universal collection of transaction and non-transaction methods, subclasses encapsulate specific transaction and non-transaction semantics.

Author:

Jonathan Groff (C) NeoCoreTechs 2003, 2017, 2021, 2022

Constructor Summary

Constructors

Constructor and Description
Session(org.rocksdb.RocksDB kvStore, org.rocksdb.Options options, java.util.ArrayList<org.rocksdb.ColumnFamilyDescriptor> columnFamilyDescriptor, java.util.List<org.rocksdb.ColumnFamilyHandle> columnFamilyHandles)

Method Summary

Modifier and Type	Method and Description
void	Close() Close this session.
void	Close(org.rocksdb.Transaction db) Close this session.
java.lang.Object	nearest(org.rocksdb.ColumnFamilyHandle cfh, java.lang.Comparable key) Return the key/value pair of Map.Entry implementation of the closest key to the passed key template.
java.lang.Object	nearest(org.rocksdb.Transaction txn, org.rocksdb.ColumnFamilyHandle cfh, java.lang.Comparable key) Return the key/value pair of Map.Entry implementation of the closest key to the passed key template.
java.lang.String	toString()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Session

public Session(org.rocksdb.RocksDB kvStore,
               org.rocksdb.Options options,
               java.util.ArrayList<org.rocksdb.ColumnFamilyDescriptor> columnFamilyDescriptor,
               java.util.List<org.rocksdb.ColumnFamilyHandle> columnFamilyHandles)

Method Detail

nearest

public java.lang.Object nearest(org.rocksdb.ColumnFamilyHandle cfh,
                                java.lang.Comparable key)
                         throws java.io.IOException

Return the key/value pair of Map.Entry implementation of the closest key to the passed key template. May be exact match Up to user. Essentially starts a tailSet iterator seeking nearest key.

Parameters:

key - target key template

Returns:

null if no next for initial iteration

Throws:

java.io.IOException

nearest

public java.lang.Object nearest(org.rocksdb.Transaction txn,
                                org.rocksdb.ColumnFamilyHandle cfh,
                                java.lang.Comparable key)
                         throws java.io.IOException

Return the key/value pair of Map.Entry implementation of the closest key to the passed key template. May be exact match Up to user. Essentially starts a tailSet iterator seeking nearest key.

Parameters:

alias - the database alias

key - target key template

Returns:

null if no next for initial iteration

Throws:

java.io.IOException

Close

public void Close()
           throws java.io.IOException

Close this session.

Parameters:

rollback - true to roll back, false to commit

Throws:

java.io.IOException - For low level failure

Close

public void Close(org.rocksdb.Transaction db)
           throws java.io.IOException

Close this session.

Parameters:

rollback - true to roll back, false to commit

Throws:

java.io.IOException - For low level failure

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object