com.couchbase.client.core.config.DefaultConfigurationProvider Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of core-io Show documentation
Show all versions of core-io Show documentation
The official Couchbase JVM Core IO Library
/**
* Copyright (C) 2014 Couchbase, Inc.
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALING
* IN THE SOFTWARE.
*/
package com.couchbase.client.core.config;
import com.couchbase.client.core.ClusterFacade;
import com.couchbase.client.core.config.loader.CarrierLoader;
import com.couchbase.client.core.config.loader.HttpLoader;
import com.couchbase.client.core.config.loader.Loader;
import com.couchbase.client.core.config.parser.BucketConfigParser;
import com.couchbase.client.core.config.refresher.CarrierRefresher;
import com.couchbase.client.core.config.refresher.HttpRefresher;
import com.couchbase.client.core.config.refresher.Refresher;
import com.couchbase.client.core.env.CoreEnvironment;
import com.couchbase.client.core.event.EventBus;
import com.couchbase.client.core.event.system.BucketClosedEvent;
import com.couchbase.client.core.event.system.BucketOpenedEvent;
import com.couchbase.client.core.lang.Tuple2;
import com.couchbase.client.core.logging.CouchbaseLogger;
import com.couchbase.client.core.logging.CouchbaseLoggerFactory;
import rx.Observable;
import rx.functions.Action1;
import rx.functions.Func1;
import rx.subjects.PublishSubject;
import rx.subjects.Subject;
import java.net.InetAddress;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.concurrent.atomic.AtomicReference;
/**
* **The default implementation of a {@link ConfigurationProvider}.**
*
* The {@link ConfigurationProvider} is the central orchestrator for configuration management. Observers can observe
* 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:
*
* ![Configuration Provider Architecture](architecture.png)
*
* @startuml architecture.png
*
* [ConfigurationProvider] --> [Config from REST]
* [ConfigurationProvider] --> [Config from Carrier]
*
* package "Config from REST" {
* [HttpLoader]
* [HttpRefresher]
* }
*
* [HttpLoader] --> 8091
* [HttpRefresher] --> 8091
*
* package "Config from Carrier" {
* [CarrierLoader]
* [CarrierRefresher]
* }
*
* [CarrierLoader] --> 11210
* [CarrierRefresher] --> 11210
*
* @enduml
*
* @author Michael Nitschinger
* @since 1.0
*/
public class DefaultConfigurationProvider implements ConfigurationProvider {
/**
* The logger used.
*/
private static final CouchbaseLogger LOGGER = CouchbaseLoggerFactory.getInstance(ConfigurationProvider.class);
/**
* Reference to the cluster to issue config fetching commands.
*/
private final ClusterFacade cluster;
/**
* The observable which will push out new config changes to interested parties.
*/
private final Subject configObservable;
/**
* Represents the current cluster-wide configuration.
*/
private final AtomicReference currentConfig;
/**
* List of initial bootstrap seed hostnames.
*/
private final AtomicReference> seedHosts;
private final List loaderChain;
private final Map refreshers;
private final CoreEnvironment environment;
private final EventBus eventBus;
/**
* Signals if the provider is bootstrapped and serving configs.
*/
private volatile boolean bootstrapped;
/**
* Create a new {@link 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).
*
* @param cluster the cluster reference.
* @param environment the environment.
*/
public DefaultConfigurationProvider(final ClusterFacade cluster, final CoreEnvironment environment) {
this(
cluster,
environment,
Arrays.asList((Loader) new CarrierLoader(cluster, environment), new HttpLoader(cluster, environment)),
new HashMap() {
{
put(LoaderType.Carrier, new CarrierRefresher(environment, cluster));
put(LoaderType.HTTP, new HttpRefresher(cluster));
}
}
);
}
/**
* Create a new {@link DefaultConfigurationProvider}.
*
* @param cluster the cluster reference.
* @param environment the environment.
* @param loaderChain the configuration loaders which will be tried in sequence.
*/
public DefaultConfigurationProvider(final ClusterFacade cluster, final CoreEnvironment environment,
final List loaderChain, final Map refreshers) {
if (cluster == null) {
throw new IllegalArgumentException("A cluster reference needs to be provided");
}
if (loaderChain == null || loaderChain.isEmpty()) {
throw new IllegalArgumentException("At least one config loader needs to be provided");
}
this.cluster = cluster;
this.loaderChain = loaderChain;
this.refreshers = refreshers;
this.environment = environment;
this.eventBus = environment.eventBus();
configObservable = PublishSubject.create().toSerialized();
seedHosts = new AtomicReference>();
bootstrapped = false;
currentConfig = new AtomicReference(new DefaultClusterConfig());
Observable
.from(refreshers.values())
.doOnNext(new Action1() {
@Override
public void call(Refresher refresher) {
refresher.provider(DefaultConfigurationProvider.this);
}
})
.flatMap(new Func1>() {
@Override
public Observable call(Refresher refresher) {
return refresher.configs();
}
}).subscribe(new Action1() {
@Override
public void call(BucketConfig bucketConfig) {
upsertBucketConfig(bucketConfig);
}
});
}
@Override
public Observable configs() {
return configObservable;
}
@Override
public ClusterConfig config() {
return currentConfig.get();
}
@Override
public boolean seedHosts(final Set hosts, boolean shuffle) {
if (bootstrapped) {
LOGGER.debug("Seed hosts called with {}, but already bootstrapped.", hosts);
return false;
}
LOGGER.debug("Setting seed hosts to {}", hosts);
if (shuffle) {
List hostsList = new ArrayList(hosts);
Collections.shuffle(hostsList);
this.seedHosts.set(new HashSet(hostsList));
} else {
this.seedHosts.set(hosts);
}
return true;
}
@Override
public Observable openBucket(final String bucket, final String password) {
LOGGER.debug("Got instructed to open bucket {}", bucket);
if (currentConfig.get() != null && currentConfig.get().hasBucket(bucket)) {
LOGGER.debug("Bucket {} already opened.", bucket);
return Observable.just(currentConfig.get());
}
if (seedHosts.get() == null || seedHosts.get().isEmpty()) {
return Observable.error(new ConfigurationException("Seed node list not provided or empty."));
}
Observable> observable = loaderChain.get(0).loadConfig(seedHosts.get(),
bucket, password);
for (int i = 1; i < loaderChain.size(); i++) {
observable = observable.onErrorResumeNext(
loaderChain.get(i).loadConfig(seedHosts.get(), bucket, password)
);
}
return
observable
.doOnNext(new Action1>() {
@Override
public void call(final Tuple2 tuple) {
registerBucketForRefresh(tuple.value1(), tuple.value2());
}
})
.map(new Func1, ClusterConfig>() {
@Override
public ClusterConfig call(final Tuple2 tuple) {
upsertBucketConfig(tuple.value2());
return currentConfig.get();
}
})
.doOnNext(new Action1() {
@Override
public void call(ClusterConfig clusterConfig) {
LOGGER.info("Opened bucket " + bucket);
if (eventBus != null) {
eventBus.publish(new BucketOpenedEvent(bucket));
}
}
})
.onErrorResumeNext(new Func1>() {
@Override
public Observable call(final Throwable throwable) {
return Observable.error(new ConfigurationException("Could not open bucket.", throwable));
}
});
}
@Override
public Observable closeBucket(String name) {
LOGGER.debug("Closing bucket {}", name);
return Observable.just(name).map(new Func1() {
@Override
public ClusterConfig call(String bucket) {
removeBucketConfig(bucket);
LOGGER.info("Closed bucket " + bucket);
if (eventBus != null) {
eventBus.publish(new BucketClosedEvent(bucket));
}
return currentConfig.get();
}
});
}
@Override
public Observable closeBuckets() {
LOGGER.debug("Closing all open buckets");
if (currentConfig.get() == null || currentConfig.get().bucketConfigs().isEmpty()) {
return Observable.just(true);
}
Set configs = new HashSet(currentConfig.get().bucketConfigs().keySet());
return Observable
.from(configs)
.observeOn(environment.scheduler())
.flatMap(new Func1>() {
@Override
public Observable call(String bucketName) {
return closeBucket(bucketName);
}
})
.last()
.map(new Func1() {
@Override
public Boolean call(ClusterConfig clusterConfig) {
return true;
}
});
}
@Override
public void proposeBucketConfig(String bucket, String rawConfig) {
LOGGER.debug("New Bucket {} config proposed.", bucket);
if (LOGGER.isTraceEnabled()) {
LOGGER.trace("Proposed raw config is {}", rawConfig);
}
BucketConfig config = BucketConfigParser.parse(rawConfig);
upsertBucketConfig(config);
}
@Override
public void signalOutdated() {
LOGGER.debug("Received signal for outdated configuration.");
for (Refresher refresher : refreshers.values()) {
refresher.refresh(currentConfig.get());
}
}
/**
* Helper method which registers (after a {@link #openBucket(String, String)} call) the bucket for config
* refreshes.
*
* @param loaderType the type of the lader used to determine the proper refresher.
* @param bucketConfig the config itself.
*/
private void registerBucketForRefresh(final LoaderType loaderType, final BucketConfig bucketConfig) {
LOGGER.debug("Registering Bucket {} to refresh at Loader {}", bucketConfig.name(), loaderType);
Refresher refresher = refreshers.get(loaderType);
if (refresher == null) {
throw new IllegalStateException("Could not find refresher for loader type: " + loaderType);
}
refresher.registerBucket(bucketConfig.name(), bucketConfig.password()).subscribe();
}
/**
* Helper method which takes the given bucket config and applies it to the cluster config.
*
* This method also sends out an update to the subject afterwards, so that observers are notified.
*
* @param newConfig the configuration of the bucket.
*/
private void upsertBucketConfig(final BucketConfig newConfig) {
ClusterConfig cluster = currentConfig.get();
BucketConfig oldConfig = cluster.bucketConfig(newConfig.name());
if (newConfig.rev() > 0 && oldConfig != null && newConfig.rev() <= oldConfig.rev()) {
LOGGER.trace("Not applying new configuration, older rev ID.");
return;
}
// If the current password of the config is empty and an old config exists
// make sure to transfer the password over to the new config. Otherwise it
// is possible that authentication errors because of a null password arise.
// See JVMCBC-185
if (newConfig.password() == null && oldConfig != null) {
newConfig.password(oldConfig.password());
}
cluster.setBucketConfig(newConfig.name(), newConfig);
LOGGER.debug("Applying new configuration {}", newConfig);
currentConfig.set(cluster);
boolean tainted = newConfig.tainted();
for (Refresher refresher : refreshers.values()) {
if (tainted) {
refresher.markTainted(newConfig);
} else {
refresher.markUntainted(newConfig);
}
}
configObservable.onNext(currentConfig.get());
}
/**
* Remove a bucket config (closing it).
*
* @param name the name of the bucket.
*/
private void removeBucketConfig(final String name) {
LOGGER.debug("Removing bucket {} configuration from known configs.", name);
ClusterConfig cluster = currentConfig.get();
cluster.deleteBucketConfig(name);
currentConfig.set(cluster);
configObservable.onNext(currentConfig.get());
}
}