com.couchbase.client.core.config

Class DefaultConfigurationProvider

java.lang.Object

com.couchbase.client.core.config.DefaultConfigurationProvider

All Implemented Interfaces:

ConfigurationProvider

public class DefaultConfigurationProvider
extends java.lang.Object
implements ConfigurationProvider

The default implementation of a ConfigurationProvider.

The ConfigurationProvider is the central orchestrator for configuration management. Observers can subscribe bucket and cluster configurations from this component. Behind the scenes, it facilitates configuration loaders and configuration refreshers that grab initial configurations and keep them refreshed respectively. The structure looks like this:

Since:

1.0

Constructor Summary

Constructors

Constructor and Description
DefaultConfigurationProvider(ClusterFacade cluster, CoreEnvironment environment) Create a new DefaultConfigurationProvider.
DefaultConfigurationProvider(ClusterFacade cluster, CoreEnvironment environment, java.util.List<Loader> loaderChain, java.util.Map<LoaderType,Refresher> refreshers) Create a new DefaultConfigurationProvider.

Method Summary

Methods

Modifier and Type	Method and Description
rx.Observable<ClusterConfig>	closeBucket(java.lang.String name)
rx.Observable<java.lang.Boolean>	closeBuckets()
ClusterConfig	config() Returns the current config or null if not set.
rx.Observable<ClusterConfig>	configs() Returns an Observable, which pushes a new ClusterConfig once available.
rx.Observable<ClusterConfig>	openBucket(java.lang.String bucket, java.lang.String password) Start to fetch a config for the given bucket and also watch for changes, depending on the mechanism used.
void	proposeBucketConfig(java.lang.String bucket, java.lang.String rawConfig)
boolean	seedHosts(java.util.Set<java.net.InetAddress> hosts, boolean shuffle) Set the initial seed hosts for bootstrap.
void	signalOutdated()

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultConfigurationProvider

public DefaultConfigurationProvider(ClusterFacade cluster,
                            CoreEnvironment environment)

Create a new DefaultConfigurationProvider.

When this constructor is used, the default loader chain is populated (first carrier is tried and the http loader is registered as a fallback).

Parameters:

cluster - the cluster reference.

environment - the environment.

DefaultConfigurationProvider

public DefaultConfigurationProvider(ClusterFacade cluster,
                            CoreEnvironment environment,
                            java.util.List<Loader> loaderChain,
                            java.util.Map<LoaderType,Refresher> refreshers)

Create a new DefaultConfigurationProvider.

Parameters:

cluster - the cluster reference.

environment - the environment.

loaderChain - the configuration loaders which will be tried in sequence.

Method Detail

configs

public rx.Observable<ClusterConfig> configs()

Description copied from interface: ConfigurationProvider

Returns an Observable, which pushes a new ClusterConfig once available.

Specified by:

configs in interface ConfigurationProvider

Returns:

the configuration.

config

public ClusterConfig config()

Description copied from interface: ConfigurationProvider

Returns the current config or null if not set.

Specified by:

config in interface ConfigurationProvider

Returns:

returns the current cluster config.

seedHosts

public boolean seedHosts(java.util.Set<java.net.InetAddress> hosts,
                boolean shuffle)

Description copied from interface: ConfigurationProvider

Set the initial seed hosts for bootstrap.

This should only be done as long as the ConfigurationProvider is not bootstrapped, otherwise it might be ignored.

Specified by:

seedHosts in interface ConfigurationProvider

Parameters:

hosts - list of seed hosts.

shuffle - shuffle seed host list.

Returns:

true if host list updated, false otherwise.

openBucket

public rx.Observable<ClusterConfig> openBucket(java.lang.String bucket,
                                      java.lang.String password)

Description copied from interface: ConfigurationProvider

Start to fetch a config for the given bucket and also watch for changes, depending on the mechanism used.

Specified by:

openBucket in interface ConfigurationProvider

Parameters:

bucket - the name of the bucket.

password - the name of the password.

Returns:

an observable with the configuration if success, and failures otherwise.

closeBucket

public rx.Observable<ClusterConfig> closeBucket(java.lang.String name)

Specified by:

closeBucket in interface ConfigurationProvider

closeBuckets

public rx.Observable<java.lang.Boolean> closeBuckets()

Specified by:

closeBuckets in interface ConfigurationProvider

proposeBucketConfig

public void proposeBucketConfig(java.lang.String bucket,
                       java.lang.String rawConfig)

Specified by:

proposeBucketConfig in interface ConfigurationProvider

signalOutdated

public void signalOutdated()

Specified by:

signalOutdated in interface ConfigurationProvider