com.sleepycat.client

Class SDatabase

java.lang.Object

com.sleepycat.client.SDatabase

All Implemented Interfaces:

GetHelper, PutHelper, TxnHelper, java.lang.AutoCloseable

Direct Known Subclasses:

SSecondaryDatabase

public class SDatabase
extends java.lang.Object
implements GetHelper, PutHelper, TxnHelper, java.lang.AutoCloseable

Creates a database handle for a single Berkeley DB database. A Berkeley DB database provides a mechanism for organizing key-data pairs of information. From the perspective of some database systems, a Berkeley DB database could be thought of as a single table within a larger database.

For most database activities, you must open the handle using the open method. When you are done with them, handles must be closed using the close method.

Databases are organized within a database environment. Environments provide transactions, recovery, replication and other advanced features. Also, if you are using multiple databases, then environments allow your databases to share a common in-memory cache, which makes for more efficient usage of your hardware's resources. See SEnvironment for information on using database environments.

Database attributes are specified in the SDatabaseConfig class.

To open an existing database with default attributes:

  BdbServerConnection conn = BdbServerConnection.connect(host, port);
  SEnvironment env = conn.openEnvironment(home, null);
  SDatabase myDatabase = env.openDatabase(null, "mydatabase", null);
 

To create a database that supports duplicates:

  SDatabaseConfig dbConfig = new SDatabaseConfig();
  dbConfig.setAllowCreate(true);
  dbConfig.setSortedDuplicates(true);
  SDatabase myDatabase = env.openDatabase(null, "mydatabase", dbConfig);
 

Nested Class Summary

Nested classes/interfaces inherited from interface com.sleepycat.client.GetHelper

GetHelper.RemoteGetFunction, GetHelper.RemotePGetFunction

Nested classes/interfaces inherited from interface com.sleepycat.client.PutHelper

PutHelper.RemotePutFunction

Nested classes/interfaces inherited from interface com.sleepycat.client.TxnHelper

TxnHelper.TransactionOperations<V>

Field Summary

Fields

Modifier and Type	Field and Description
protected BdbService.Client	client The remote service client.
protected TDatabase	tDb The remote database handle.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SDatabase(TDatabase tDb, java.lang.String fileName, java.lang.String databaseName, BdbService.Client client, SEnvironment env) Constructor for subclasses.

Method Summary

Modifier and Type	Method and Description
void	close() Flush any cached database information to disk, close any open cursors, free allocated resources, close underlying files, and discard the database handle.
SCompactStats	compact(STransaction txn, SDatabaseEntry start, SDatabaseEntry stop, SDatabaseEntry end, SCompactConfig config) Compact a Btree or Recno database or returns unused Btree, Hash or Recno database pages to the underlying filesystem.
protected TDbGetConfig	createConfig(SDatabaseEntryBase data, SLockMode lockMode)
SOperationStatus	delete(STransaction txn, SDatabaseEntry key) Remove key/data pairs from the database.
SOperationStatus	deleteMultiple(STransaction txn, SMultipleDataEntry keys) Remove key/data pairs from the database.
SOperationStatus	deleteMultipleKey(STransaction txn, SMultiplePairs pairs) Remove key/data pairs from the database.
SOperationStatus	exists(STransaction txn, SDatabaseEntry key) Checks if the specified key appears in the database.
SOperationStatus	get(STransaction txn, SDatabaseEntry key, SDatabaseEntryBase data, SLockMode lockMode) Retrieves the key/data pair with the given key from the database.
SDatabaseConfig	getConfig() Return this SDatabase object's configuration.
java.lang.String	getDatabaseFile() Return the database's underlying file name.
java.lang.String	getDatabaseName() Return the database name.
SEnvironment	getEnvironment() Return the SEnvironment handle for the database environment underlying this database.
SKeyRange	getKeyRange(STransaction txn, SDatabaseEntry key) Return an estimate of the proportion of keys in the database less than, equal to, and greater than the specified key.
SOperationStatus	getSearchBoth(STransaction txn, SDatabaseEntry key, SDatabaseEntryBase data, SLockMode lockMode) Retrieves the key/data pair with the given key and data value, that is, both the key and data items must match.
SOperationStatus	getSearchRecordNumber(STransaction txn, SDatabaseEntry key, SDatabaseEntryBase data, SLockMode lockMode) Retrieves the key/data pair associated with the specific numbered record of the database.
java.util.Set<SSecondaryDatabase>	getSecondaryDatabases() Return the set of secondary databases associated with this primary database.
java.nio.ByteOrder	getServerByteOrder() Return the native byte order of the connected server.
SDatabaseStats	getStats(STransaction txn, SStatsConfig config) Return database statistics.
default <V> V	handleRuntimeExceptions(com.sleepycat.client.RemoteServiceCallable<V> remote)
SJoinCursor	join(SCursor[] cursors, SJoinConfig config) Creates a specialized join cursor for use in performing equality or natural joins on secondary indices.
SCursor	openCursor(STransaction txn, SCursorConfig config) Return a cursor into the database.
SSequence	openSequence(STransaction txn, SDatabaseEntry key, SSequenceConfig config) Open a sequence represented by the key in the database.
SOperationStatus	put(STransaction txn, SDatabaseEntry key, SDatabaseEntry data) Store the key/data pair into the database.
SOperationStatus	putMultipleKey(STransaction txn, SMultiplePairs pairs, boolean overwrite) Store a set of key/data pairs into the database.
SOperationStatus	putNoDupData(STransaction txn, SDatabaseEntry key, SDatabaseEntry data) Store the key/data pair into the database if it does not already appear in the database.
SOperationStatus	putNoOverwrite(STransaction txn, SDatabaseEntry key, SDatabaseEntry data) Store the key/data pair into the database if the key does not already appear in the database.
default <V> V	remoteCall(com.sleepycat.client.RemoteServiceCallable<V> remote)
default <V> V	remoteCallWithIOException(com.sleepycat.client.RemoteServiceCallable<V> remote)
void	removeSequence(STransaction txn, SDatabaseEntry key, boolean autoCommitNoSync, boolean force) Remove the sequence from the database.
void	setConfig(SDatabaseConfig config) Change the settings in an existing database handle.
int	truncate(STransaction txn, boolean countRecords) Empty the database, discarding all records it contains.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.sleepycat.client.GetHelper

createGetSearchTerm, createPGetSearchTerm, remoteGet, remotePGet, updateKeyData, updateTuple

Methods inherited from interface com.sleepycat.client.PutHelper

calculateSKey, remotePut

Methods inherited from interface com.sleepycat.client.TxnHelper

runInSingleTxn, runInSingleTxnWithIOException

Field Detail

tDb

protected final TDatabase tDb

The remote database handle.

client

protected final BdbService.Client client

The remote service client.

Constructor Detail

SDatabase

protected SDatabase(TDatabase tDb,
                    java.lang.String fileName,
                    java.lang.String databaseName,
                    BdbService.Client client,
                    SEnvironment env)

Constructor for subclasses.

Parameters:

tDb - the Thrift object

fileName - the file name

databaseName - the database name

client - the Thrift client object

env - the enclosing environment

Method Detail

close

public void close()
           throws SDatabaseException

Flush any cached database information to disk, close any open cursors, free allocated resources, close underlying files, and discard the database handle.

Closing a database handle will close any open cursors that refer to it. However, you should make sure to close all your transaction handles before closing your database handle.

Because key/data pairs are cached in memory, failing to sync the file with the this methods may result in inconsistent or lost information. So, to ensure that any data cached in main memory are reflected in the underlying file system, applications should make a point to always close database handles.

The database handle may not be accessed again after this method is called, regardless of the method's success or failure.

When called on a database that is the primary database for a secondary index, the primary database should be closed only after all secondary indices which reference it have been closed.

Specified by:

close in interface java.lang.AutoCloseable

Throws:

SDatabaseException - if any error occurs

getConfig

public SDatabaseConfig getConfig()
                          throws SDatabaseException

Return this SDatabase object's configuration.

This may differ from the configuration used to open this object if the database existed previously.

Returns:

this SDatabase object's configuration

Throws:

SDatabaseException - if any error occurs

setConfig

public void setConfig(SDatabaseConfig config)
               throws SDatabaseException

Change the settings in an existing database handle. Only set attributes are changed. Therefore, there is no need to call getConfig() to get the current settings because unset attributes are not changed.

Parameters:

config - the database attributes; if null, no attribute is changed

Throws:

SDatabaseException - if any error occurs

getDatabaseFile

public java.lang.String getDatabaseFile()

Return the database's underlying file name.

Returns:

the database's underlying file name

getDatabaseName

public java.lang.String getDatabaseName()

Return the database name.

Returns:

the database name

getEnvironment

public SEnvironment getEnvironment()

Return the SEnvironment handle for the database environment underlying this database.

Specified by:

getEnvironment in interface TxnHelper

Returns:

the SEnvironment handle for the database environment underlying this database

getSecondaryDatabases

public java.util.Set<SSecondaryDatabase> getSecondaryDatabases()

Description copied from interface: PutHelper

Return the set of secondary databases associated with this primary database.

Specified by:

getSecondaryDatabases in interface PutHelper

Returns:

the set of associated secondary databases

getServerByteOrder

public java.nio.ByteOrder getServerByteOrder()

Return the native byte order of the connected server.

Returns:

the native byte order of the connected server

get

public SOperationStatus get(STransaction txn,
                            SDatabaseEntry key,
                            SDatabaseEntryBase data,
                            SLockMode lockMode)
                     throws SDatabaseException

Retrieves the key/data pair with the given key from the database. If the matching key has duplicate values, the first data item in the set of duplicates is returned.

Duplicates are sorted by:

• their sort order, if a duplicate sort function was specified.
• any explicit cursor designated insertion.
• by insert order. This is the default behavior.

Retrieval of duplicates requires the use of SCursor operations. When called on a database that has been made into a secondary index, this method returns the key from the secondary index and the data item from the primary database.

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

key - the key used as input. It must be initialized by the caller.

data - the data returned as output. Use SMultipleDataEntry to return all duplicates of the key.

lockMode - the locking attributes; if null, default attributes are used

Returns:

SOperationStatus.NOTFOUND if no matching key/data pair is found; SOperationStatus.KEYEMPTY if the database is a Queue or Recno database and the specified key exists, but was never explicitly created by the application or was later deleted; otherwise, SOperationStatus.SUCCESS.

Throws:

SDatabaseException - if any error occurs

getSearchBoth

public SOperationStatus getSearchBoth(STransaction txn,
                                      SDatabaseEntry key,
                                      SDatabaseEntryBase data,
                                      SLockMode lockMode)
                               throws SDatabaseException

Retrieves the key/data pair with the given key and data value, that is, both the key and data items must match.

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

key - the key used as input. It must be initialized by the caller.

data - the data used as input; only SDatabaseEntry is supported

lockMode - the locking attributes; if null, default attributes are used

Returns:

SOperationStatus.NOTFOUND if no matching key/data pair is found; SOperationStatus.KEYEMPTY if the database is a Queue or Recno database and the specified key exists, but was never explicitly created by the application or was later deleted; otherwise, SOperationStatus.SUCCESS.

Throws:

SDatabaseException - if any error occurs

getSearchRecordNumber

public SOperationStatus getSearchRecordNumber(STransaction txn,
                                              SDatabaseEntry key,
                                              SDatabaseEntryBase data,
                                              SLockMode lockMode)
                                       throws SDatabaseException

Retrieves the key/data pair associated with the specific numbered record of the database.

The specified key must be a record number as described in SDatabaseEntry. This determines the record to be retrieved.

For this method to be called, the underlying database must be of type Btree, and it must have been configured to support record numbers.

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

key - the key returned as output

data - the data returned as output. Use SMultipleDataEntry to return all duplicates of the key.

lockMode - the locking attributes; if null, default attributes are used

Returns:

SOperationStatus.NOTFOUND if no matching key/data pair is found; SOperationStatus.KEYEMPTY if the database is a Queue or Recno database and the specified key exists, but was never explicitly created by the application or was later deleted; otherwise, SOperationStatus.SUCCESS.

Throws:

SDatabaseException - if any error occurs

createConfig

protected TDbGetConfig createConfig(SDatabaseEntryBase data,
                                    SLockMode lockMode)

exists

public SOperationStatus exists(STransaction txn,
                               SDatabaseEntry key)
                        throws SDatabaseException

Checks if the specified key appears in the database.

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

key - the key used as input

Returns:

SOperationStatus.NOTFOUND if no record is available; SOperationStatus.KEYEMPTY if the database is a Queue or Recno database and the specified key exists, but was never explicitly created by the application or was later deleted; otherwise, SOperationStatus.SUCCESS.

Throws:

SDatabaseException - if any error occurs

getKeyRange

public SKeyRange getKeyRange(STransaction txn,
                             SDatabaseEntry key)
                      throws SDatabaseException

Return an estimate of the proportion of keys in the database less than, equal to, and greater than the specified key.

The underlying database must be of type Btree.

This method does not retain the locks it acquires for the life of the transaction, so estimates are not repeatable.

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

key - the key being compared

Returns:

an estimate of the proportion of keys in the database less than, equal to, and greater than the specified key.

Throws:

SDatabaseException - if any error occurs

put

public SOperationStatus put(STransaction txn,
                            SDatabaseEntry key,
                            SDatabaseEntry data)
                     throws SDatabaseException

Store the key/data pair into the database.

If the key already appears in the database and duplicates are not configured, the existing key/data pair will be replaced. If the key already appears in the database and sorted duplicates are configured, the new data value is inserted at the correct sorted location. If the key already appears in the database and unsorted duplicates are configured, the new data value is appended at the end of the duplicate set.

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

key - the key SDatabaseEntry operated on

data - the data SDatabaseEntry stored

Returns:

the operation status

Throws:

SDatabaseException - if any error occurs

putNoDupData

public SOperationStatus putNoDupData(STransaction txn,
                                     SDatabaseEntry key,
                                     SDatabaseEntry data)
                              throws SDatabaseException

Store the key/data pair into the database if it does not already appear in the database.

This method may only be called if the underlying database has been configured to support sorted duplicates. (This method may not be specified to the Queue or Recno access methods.)

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

key - the key SDatabaseEntry operated on

data - the data SDatabaseEntry stored

Returns:

the operation status

Throws:

SDatabaseException - if any error occurs

putNoOverwrite

public SOperationStatus putNoOverwrite(STransaction txn,
                                       SDatabaseEntry key,
                                       SDatabaseEntry data)
                                throws SDatabaseException

Store the key/data pair into the database if the key does not already appear in the database.

This method will fail if the key already exists in the database, even if the database supports duplicates.

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

key - the key SDatabaseEntry operated on

data - the data SDatabaseEntry stored

Returns:

the operation status

Throws:

SDatabaseException - if any error occurs

putMultipleKey

public SOperationStatus putMultipleKey(STransaction txn,
                                       SMultiplePairs pairs,
                                       boolean overwrite)
                                throws SDatabaseException

Store a set of key/data pairs into the database.

This method may not be called on databases configured with unsorted duplicates.

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

pairs - the key and data pairs operated on

overwrite - if this flag is true and any of the keys already exist in the database, they will be replaced. Otherwise a SOperationStatus.KEYEXIST error will be returned

Returns:

if any of the key/data pairs already appear in the database, this method will return SOperationStatus.KEYEXIST

Throws:

SDatabaseException - if any error occurs

delete

public SOperationStatus delete(STransaction txn,
                               SDatabaseEntry key)
                        throws SDatabaseException

Remove key/data pairs from the database.

The key/data pair associated with the specified key is discarded from the database. In the presence of duplicate key values, all records associated with the designated key will be discarded.

The key/data pair is also deleted from any associated secondary databases. When called on a database that has been made into a secondary index, this method deletes the key/data pair from the primary database and all secondary indices.

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

key - the key operated on

Returns:

the method will return SOperationStatus.NOTFOUND if the specified key is not found in the database; the method will return SOperationStatus.KEYEMPTY if the database is a Queue or Recno database and the specified key exists, but was never explicitly created by the application or was later deleted; otherwise the method will return SOperationStatus.SUCCESS.

Throws:

SDatabaseException - if any error occurs

deleteMultiple

public SOperationStatus deleteMultiple(STransaction txn,
                                       SMultipleDataEntry keys)
                                throws SDatabaseException

Remove key/data pairs from the database.

The key/data pairs associated with the specified keys are discarded from the database. In the presence of duplicate key values, all records associated with the designated keys will be discarded.

The key/data pairs are also deleted from any associated secondary databases. When called on a database that has been made into a secondary index, this method deletes the key/data pairs from the primary database and all secondary indices.

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

keys - the set of keys operated on

Returns:

the method will return SOperationStatus.NOTFOUND if the specified key is not found in the database; the method will return SOperationStatus.KEYEMPTY if the database is a Queue or Recno database and the specified key exists, but was never explicitly created by the application or was later deleted; otherwise the method will return SOperationStatus.SUCCESS.

Throws:

SDatabaseException - if any error occurs

deleteMultipleKey

public SOperationStatus deleteMultipleKey(STransaction txn,
                                          SMultiplePairs pairs)
                                   throws SDatabaseException

Remove key/data pairs from the database.

The specified key/data pairs are discarded from the database.

The key/data pairs are also deleted from any associated secondary databases. When called on a database that has been made into a secondary index, this method deletes the key/data pairs from the primary database and all secondary indices.

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

pairs - the set of key/data pairs operated on

Returns:

the method will return SOperationStatus.NOTFOUND if the specified key is not found in the database; the method will return SOperationStatus.KEYEMPTY if the database is a Queue or Recno database and the specified key exists, but was never explicitly created by the application or was later deleted; otherwise the method will return SOperationStatus.SUCCESS.

Throws:

SDatabaseException - if any error occurs

openCursor

public SCursor openCursor(STransaction txn,
                          SCursorConfig config)
                   throws SDatabaseException

Return a cursor into the database.

Parameters:

txn - To use a cursor for writing to a transactional database, an explicit transaction must be specified. For read-only access to a transactional database, the transaction may be null. To transaction-protect cursor operations, cursors must be opened and closed within the context of a transaction, and the txn parameter specifies the transaction context in which the cursor will be used.

config - the cursor attributes; if null, default attributes are used

Returns:

a database cursor

Throws:

SDatabaseException - if any error occurs

join

public SJoinCursor join(SCursor[] cursors,
                        SJoinConfig config)
                 throws SDatabaseException

Creates a specialized join cursor for use in performing equality or natural joins on secondary indices.

Each cursor in the cursors array must have been initialized to refer to the key on which the underlying database should be joined. Typically, this initialization is done by calling SCursor.getSearchKey(com.sleepycat.client.SDatabaseEntry, com.sleepycat.client.SDatabaseEntryBase, com.sleepycat.client.SLockMode).

Once the cursors have been passed to this method, they should not be accessed or modified until the newly created join cursor has been closed, or else inconsistent results may be returned. However, the position of the cursors will not be changed by this method or by the methods of the join cursor.

Parameters:

cursors - an array of cursors associated with this primary database

config - the join attributes; if null, default attributes are used

Returns:

a specialized cursor that returns the results of the equality join operation

Throws:

SDatabaseException - if any error occurs

openSequence

public SSequence openSequence(STransaction txn,
                              SDatabaseEntry key,
                              SSequenceConfig config)
                       throws SDatabaseException

Open a sequence represented by the key in the database.

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

key - The key SDatabaseEntry of the sequence. It specifies which record in the database stores the persistent sequence data.

config - The sequence attributes; If null, default attributes are used

Returns:

a sequence handle

Throws:

SDatabaseException - if any error occurs

removeSequence

public void removeSequence(STransaction txn,
                           SDatabaseEntry key,
                           boolean autoCommitNoSync,
                           boolean force)
                    throws SDatabaseException

Remove the sequence from the database. This method should not be called if there are open handles on this sequence.

If force is set to true, all open handles for the sequence are closed so that the remove can proceed. If force is false, and there is at least one open handle for the sequence, SResourceInUseException is thrown.

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

key - The key SDatabaseEntry of the sequence. It specifies which record in the database stores the persistent sequence data.

autoCommitNoSync - if true, configure auto-commit operations on the sequence to not flush the transaction log

force - if true all open handles on the sequence are closed and the sequence is removed; if false the sequence is removed only if there is no open handle on it

Throws:

SDatabaseException - if any error occurs

compact

public SCompactStats compact(STransaction txn,
                             SDatabaseEntry start,
                             SDatabaseEntry stop,
                             SDatabaseEntry end,
                             SCompactConfig config)
                      throws SDatabaseException

Compact a Btree or Recno database or returns unused Btree, Hash or Recno database pages to the underlying filesystem.

Parameters:

txn - if the operation is part of an application-specified transaction, the txn parameter is a transaction handle returned from SEnvironment.beginTransaction(com.sleepycat.client.STransaction, com.sleepycat.client.STransactionConfig), otherwise NULL. If a transaction handle is supplied to this method, then the operation is performed using that transaction. In this event, large sections of the tree may be locked during the course of the transaction. If no transaction handle is specified, the operation will be implicitly transaction protected using multiple transactions. These transactions will be periodically committed to avoid locking large sections of the tree. Any deadlocks encountered cause the compaction operation to be retried from the point of the last transaction commit.

start - if not null, the start parameter is the starting point for compaction in a Btree or Recno database. Compaction will start at the smallest key greater than or equal to the specified key. If null, compaction will start at the beginning of the database.

stop - if not null, the stop parameter is the stopping point for compaction in a Btree or Recno database. Compaction will stop at the page with the smallest key greater than the specified key. If null, compaction will stop at the end of the database.

end - if not null, the end parameter will be filled in with the key marking the end of the compaction operation in a Btree or Recno database. It is generally the first key of the page where processing stopped.

config - the compaction operation attributes; if null, default attributes are used

Returns:

compaction operation statistics

Throws:

SDatabaseException - if any error occurs

truncate

public int truncate(STransaction txn,
                    boolean countRecords)
             throws SDatabaseException

Empty the database, discarding all records it contains.

When called on a database configured with secondary indices, this method truncates the primary database and all secondary indices. If configured to return a count of the records discarded, the returned count is the count of records discarded from the primary database.

It is an error to call this method on a database with open cursors.

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

countRecords - if true, count and return the number of records discarded

Returns:

the number of records discarded, or -1 if countRecords is false

Throws:

SDatabaseException - if any error occurs

getStats

public SDatabaseStats getStats(STransaction txn,
                               SStatsConfig config)
                        throws SDatabaseException

Return database statistics.

If this method has not been configured to avoid expensive operations (using the SStatsConfig.setFast(boolean) method), it will access some of or all the pages in the database, incurring a severe performance penalty as well as possibly flushing the underlying buffer pool.

In the presence of multiple threads or processes accessing an active database, the information returned by this method may be out-of-date.

If the database was not opened read-only and this method was not configured using the SStatsConfig.setFast(boolean) method, cached key and record numbers will be updated after the statistical information has been gathered.

Parameters:

txn - an explicit transaction may be specified, or null may be specified to use auto-commit

config - the statistics returned; if null, default statistics are returned

Returns:

database statistics

Throws:

SDatabaseException - if any error occurs

remoteCallWithIOException

public <V> V remoteCallWithIOException(com.sleepycat.client.RemoteServiceCallable<V> remote)
                                throws java.io.IOException

Throws:

java.io.IOException

remoteCall

public <V> V remoteCall(com.sleepycat.client.RemoteServiceCallable<V> remote)

handleRuntimeExceptions

public <V> V handleRuntimeExceptions(com.sleepycat.client.RemoteServiceCallable<V> remote)
                              throws org.apache.thrift.TException

Throws:

org.apache.thrift.TException