com.couchbase.client.java.env

Class DefaultCouchbaseEnvironment

java.lang.Object

com.couchbase.client.core.env.DefaultCoreEnvironment

com.couchbase.client.java.env.DefaultCouchbaseEnvironment

All Implemented Interfaces:

ConfigParserEnvironment, CoreEnvironment, SecureEnvironment, CouchbaseEnvironment

public class DefaultCouchbaseEnvironment
extends DefaultCoreEnvironment
implements CouchbaseEnvironment

The default implementation of a CouchbaseEnvironment.

This environment is intended to be reused and passed in across AsyncCluster instances. It is stateful and needs to be shut down manually if it was passed in by the user. Some threads it manages are non-daemon threads.

Default settings can be customized through the DefaultCouchbaseEnvironment.Builder or through the setting of system properties. Latter ones take always precedence and can be used to override builder settings at runtime too.

Since:

2.0

Author:

Michael Nitschinger

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DefaultCouchbaseEnvironment.Builder

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	CLIENT_GIT_VERSION
protected static String	CLIENT_VERSION
static String	SDK_PACKAGE_NAME_AND_VERSION
static String	SDK_USER_AGENT

Fields inherited from class com.couchbase.client.core.env.DefaultCoreEnvironment

AUTORELEASE_AFTER, BOOTSTRAP_CARRIER_DIRECT_PORT, BOOTSTRAP_CARRIER_ENABLED, BOOTSTRAP_CARRIER_SSL_PORT, BOOTSTRAP_HTTP_DIRECT_PORT, BOOTSTRAP_HTTP_ENABLED, BOOTSTRAP_HTTP_SSL_PORT, BUFFER_POOLING_ENABLED, CALLBACKS_ON_IO_POOL, COMPUTATION_POOL_SIZE, CORE_GIT_VERSION, CORE_VERSION, DCP_CONNECTION_BUFFER_ACK_THRESHOLD, DCP_CONNECTION_BUFFER_SIZE, DCP_CONNECTION_NAME, DCP_ENABLED, DISCONNECT_TIMEOUT, IO_POOL_SIZE, KEEPALIVEINTERVAL, KEYVALUE_ENDPOINTS, MAX_REQUEST_LIFETIME, MEMCACHED_HASHING_STRATEGY, MUTATION_TOKENS_ENABLED, OBSERVE_INTERVAL_DELAY, PACKAGE_NAME_AND_VERSION, QUERY_ENDPOINTS, RECONNECT_DELAY, REQUEST_BUFFER_SIZE, RESPONSE_BUFFER_SIZE, RETRY_DELAY, RETRY_STRATEGY, SEARCH_ENDPOINTS, SOCKET_CONNECT_TIMEOUT, SSL_ENABLED, SSL_KEYSTORE, SSL_KEYSTORE_FILE, SSL_KEYSTORE_PASSWORD, TCP_NODELAY_ENALED, USER_AGENT, VIEW_ENDPOINTS

Method Summary

Modifier and Type	Method and Description
static DefaultCouchbaseEnvironment.Builder	builder() Returns the DefaultCouchbaseEnvironment.Builder to customize environment settings.
String	clientBuild() Returns build information on the Couchbase Java SDK client.
String	clientVersion() Returns version information on the Couchbase Java SDK client.
long	connectTimeout() The default timeout for connect operations, set to CONNECT_TIMEOUT.
static DefaultCouchbaseEnvironment	create() Creates a CouchbaseEnvironment with default settings applied.
boolean	dnsSrvEnabled() Returns whether DNS SRV lookup for the bootstrap nodes is enabled or not.
protected StringBuilder	dumpParameters(StringBuilder sb)
long	kvTimeout() The default timeout for binary (key/value) operations, set to KV_TIMEOUT.
long	managementTimeout() The default timeout for management operations, set to MANAGEMENT_TIMEOUT.
long	queryTimeout() The default timeout for query operations, set to QUERY_TIMEOUT.
long	searchTimeout() The default timeout for search operations, set to SEARCH_TIMEOUT.
String	toString()
long	viewTimeout() The default timeout for view operations, set to VIEW_TIMEOUT.

Methods inherited from class com.couchbase.client.core.env.DefaultCoreEnvironment

autoreleaseAfter, booleanPropertyOr, bootstrapCarrierDirectPort, bootstrapCarrierEnabled, bootstrapCarrierSslPort, bootstrapHttpDirectPort, bootstrapHttpEnabled, bootstrapHttpSslPort, bufferPoolingEnabled, callbacksOnIoPool, computationPoolSize, coreBuild, coreVersion, dcpConnectionBufferAckThreshold, dcpConnectionBufferSize, dcpConnectionName, dcpEnabled, disconnectTimeout, doublePropertyOr, eventBus, instanceCounter, intPropertyOr, ioPool, ioPoolSize, keepAliveInterval, kvEndpoints, kvIoPool, longPropertyOr, maxRequestLifetime, memcachedHashingStrategy, mutationTokensEnabled, networkLatencyMetricsCollector, observeIntervalDelay, packageNameAndVersion, queryEndpoints, queryIoPool, reconnectDelay, requestBufferSize, requestBufferWaitStrategy, responseBufferSize, retryDelay, retryStrategy, runtimeMetricsCollector, scheduler, searchEndpoints, searchIoPool, shutdown, shutdown, shutdownAsync, socketConnectTimeout, sslEnabled, sslKeystore, sslKeystoreFile, sslKeystorePassword, stringPropertyOr, tcpNodelayEnabled, userAgent, viewEndpoints, viewIoPool

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.couchbase.client.core.env.CoreEnvironment

autoreleaseAfter, bootstrapCarrierDirectPort, bootstrapCarrierEnabled, bootstrapCarrierSslPort, bootstrapHttpDirectPort, bootstrapHttpEnabled, bootstrapHttpSslPort, bufferPoolingEnabled, callbacksOnIoPool, computationPoolSize, coreBuild, coreVersion, dcpConnectionBufferAckThreshold, dcpConnectionBufferSize, dcpConnectionName, dcpEnabled, disconnectTimeout, eventBus, ioPool, ioPoolSize, keepAliveInterval, kvEndpoints, kvIoPool, maxRequestLifetime, mutationTokensEnabled, networkLatencyMetricsCollector, observeIntervalDelay, packageNameAndVersion, queryEndpoints, queryIoPool, reconnectDelay, requestBufferSize, requestBufferWaitStrategy, responseBufferSize, retryDelay, retryStrategy, runtimeMetricsCollector, scheduler, searchEndpoints, searchIoPool, shutdown, shutdown, shutdownAsync, socketConnectTimeout, tcpNodelayEnabled, userAgent, viewEndpoints, viewIoPool

Methods inherited from interface com.couchbase.client.core.env.SecureEnvironment

sslEnabled, sslKeystore, sslKeystoreFile, sslKeystorePassword

Methods inherited from interface com.couchbase.client.core.env.ConfigParserEnvironment

memcachedHashingStrategy

Field Detail

CLIENT_VERSION

protected static String CLIENT_VERSION

CLIENT_GIT_VERSION

protected static String CLIENT_GIT_VERSION

SDK_PACKAGE_NAME_AND_VERSION

public static String SDK_PACKAGE_NAME_AND_VERSION

SDK_USER_AGENT

public static String SDK_USER_AGENT

Method Detail

create

public static DefaultCouchbaseEnvironment create()

Creates a CouchbaseEnvironment with default settings applied.

Returns:

a DefaultCouchbaseEnvironment with default settings.

builder

public static DefaultCouchbaseEnvironment.Builder builder()

Returns the DefaultCouchbaseEnvironment.Builder to customize environment settings.

Returns:

the DefaultCouchbaseEnvironment.Builder.

managementTimeout

public long managementTimeout()

Description copied from interface: CouchbaseEnvironment

The default timeout for management operations, set to MANAGEMENT_TIMEOUT.

Specified by:

managementTimeout in interface CouchbaseEnvironment

Returns:

the default management timeout.

queryTimeout

public long queryTimeout()

Description copied from interface: CouchbaseEnvironment

The default timeout for query operations, set to QUERY_TIMEOUT.

Specified by:

queryTimeout in interface CouchbaseEnvironment

Returns:

the default query timeout.

viewTimeout

public long viewTimeout()

Description copied from interface: CouchbaseEnvironment

The default timeout for view operations, set to VIEW_TIMEOUT.

Specified by:

viewTimeout in interface CouchbaseEnvironment

Returns:

the default view timeout.

searchTimeout

public long searchTimeout()

Description copied from interface: CouchbaseEnvironment

The default timeout for search operations, set to SEARCH_TIMEOUT.

Specified by:

searchTimeout in interface CouchbaseEnvironment

Returns:

the default search timeout.

kvTimeout

public long kvTimeout()

Description copied from interface: CouchbaseEnvironment

The default timeout for binary (key/value) operations, set to KV_TIMEOUT.

Specified by:

kvTimeout in interface CouchbaseEnvironment

Returns:

the default binary timeout.

connectTimeout

public long connectTimeout()

Description copied from interface: CouchbaseEnvironment

The default timeout for connect operations, set to CONNECT_TIMEOUT.

Specified by:

connectTimeout in interface CouchbaseEnvironment

Returns:

the default connect timeout.

dnsSrvEnabled

public boolean dnsSrvEnabled()

Description copied from interface: CouchbaseEnvironment

Returns whether DNS SRV lookup for the bootstrap nodes is enabled or not.

Specified by:

dnsSrvEnabled in interface CouchbaseEnvironment

Returns:

true if enabled, false otherwise.

clientVersion

public String clientVersion()

Description copied from interface: CouchbaseEnvironment

Returns version information on the Couchbase Java SDK client. Version number is in the form MAJOR.MINOR.PATCH, and is the one for the java-client layer.

Specified by:

clientVersion in interface CouchbaseEnvironment

Returns:

the version string for the Java client.

See Also:

for a more specific build information (relevant for tracking the exact version of the code the client was built from), for the same information but relative to the core layer.

clientBuild

public String clientBuild()

Description copied from interface: CouchbaseEnvironment

Returns build information on the Couchbase Java SDK client. This has a better granularity than CouchbaseEnvironment.clientVersion() and thus is more relevant to track the exact version of the code the client was built from.

Build information can contain VCS information like commit numbers, tags, etc…

Specified by:

clientBuild in interface CouchbaseEnvironment

Returns:

the build string for the Java client.

See Also:

for more generic version information., for the same information but relative to the core layer.

dumpParameters

protected StringBuilder dumpParameters(StringBuilder sb)

Overrides:

dumpParameters in class DefaultCoreEnvironment

toString

public String toString()

Overrides:

toString in class DefaultCoreEnvironment