com.apple.foundationdb

Class DatabaseOptions

java.lang.Object

com.apple.foundationdb.DatabaseOptions

public class DatabaseOptions
extends java.lang.Object

A set of options that can be set on a Database.

Constructor Summary

Constructors

Constructor and Description
DatabaseOptions(OptionConsumer consumer)

Method Summary

Modifier and Type	Method and Description
OptionConsumer	getOptionConsumer() Returns the object on which these options are being set.
void	setDatacenterId(java.lang.String value) Specify the datacenter ID that was passed to fdbserver processes running in the same datacenter as this client, for better location-aware load balancing.
void	setLocationCacheSize(long value) Set the size of the client location cache.
void	setMachineId(java.lang.String value) Specify the machine ID that was passed to fdbserver processes running on the same machine as this client, for better location-aware load balancing.
void	setMaxWatches(long value) Set the maximum number of watches allowed to be outstanding on a database connection.
void	setSnapshotRywDisable() Snapshot read operations will not see the results of writes done in the same transaction.
void	setSnapshotRywEnable() Snapshot read operations will see the results of writes done in the same transaction.
void	setTransactionMaxRetryDelay(long value) Set the maximum amount of backoff delay incurred in the call to onError if the error is retryable.
void	setTransactionRetryLimit(long value) Set a timeout in milliseconds which, when elapsed, will cause a transaction automatically to be cancelled.
void	setTransactionTimeout(long value) Set a timeout in milliseconds which, when elapsed, will cause each transaction automatically to be cancelled.

Methods inherited from class java.lang.Object

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

Constructor Detail

DatabaseOptions

public DatabaseOptions(OptionConsumer consumer)

Method Detail

setLocationCacheSize

public void setLocationCacheSize(long value)

Set the size of the client location cache. Raising this value can boost performance in very large databases where clients access data in a near-random pattern. Defaults to 100000.

Parameters:

value - Max location cache entries

setMaxWatches

public void setMaxWatches(long value)

Set the maximum number of watches allowed to be outstanding on a database connection. Increasing this number could result in increased resource usage. Reducing this number will not cancel any outstanding watches. Defaults to 10000 and cannot be larger than 1000000.

Parameters:

value - Max outstanding watches

setMachineId

public void setMachineId(java.lang.String value)

Specify the machine ID that was passed to fdbserver processes running on the same machine as this client, for better location-aware load balancing.

Parameters:

value - Hexadecimal ID

setDatacenterId

public void setDatacenterId(java.lang.String value)

Specify the datacenter ID that was passed to fdbserver processes running in the same datacenter as this client, for better location-aware load balancing.

Parameters:

value - Hexadecimal ID

setTransactionTimeout

public void setTransactionTimeout(long value)

Set a timeout in milliseconds which, when elapsed, will cause each transaction automatically to be cancelled. This sets the timeout option of each transaction created by this database. See the transaction option description for more information. Using this option requires that the API version is 610 or higher.

Parameters:

value - value in milliseconds of timeout

setTransactionRetryLimit

public void setTransactionRetryLimit(long value)

Set a timeout in milliseconds which, when elapsed, will cause a transaction automatically to be cancelled. This sets the retry_limit option of each transaction created by this database. See the transaction option description for more information.

Parameters:

value - number of times to retry

setTransactionMaxRetryDelay

public void setTransactionMaxRetryDelay(long value)

Set the maximum amount of backoff delay incurred in the call to onError if the error is retryable. This sets the max_retry_delay option of each transaction created by this database. See the transaction option description for more information.

Parameters:

value - value in milliseconds of maximum delay

setSnapshotRywEnable

public void setSnapshotRywEnable()

Snapshot read operations will see the results of writes done in the same transaction. This is the default behavior.

setSnapshotRywDisable

public void setSnapshotRywDisable()

Snapshot read operations will not see the results of writes done in the same transaction. This was the default behavior prior to API version 300.

getOptionConsumer

public OptionConsumer getOptionConsumer()

Returns the object on which these options are being set. Rarely used by client code, since all options should be top-level methods on extending classes.

Returns:

target of option set calls