systems.composable.dropwizard.cassandra.CassandraFactory Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of dropwizard-cassandra Show documentation
Show all versions of dropwizard-cassandra Show documentation
Cassandra library for Dropwizard
/*
* Copyright 2016 Composable Systems Limited
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package systems.composable.dropwizard.cassandra;
import com.codahale.metrics.MetricRegistry;
import com.codahale.metrics.health.HealthCheckRegistry;
import com.datastax.driver.core.*;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.google.common.base.Strings;
import io.dropwizard.setup.Environment;
import io.dropwizard.util.Duration;
import org.hibernate.validator.constraints.NotEmpty;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import systems.composable.dropwizard.cassandra.auth.AuthProviderFactory;
import systems.composable.dropwizard.cassandra.loadbalancing.LoadBalancingPolicyFactory;
import systems.composable.dropwizard.cassandra.pooling.PoolingOptionsFactory;
import systems.composable.dropwizard.cassandra.reconnection.ReconnectionPolicyFactory;
import systems.composable.dropwizard.cassandra.retry.RetryPolicyFactory;
import systems.composable.dropwizard.cassandra.speculativeexecution.SpeculativeExecutionPolicyFactory;
import systems.composable.dropwizard.cassandra.ssl.SSLOptionsFactory;
import javax.validation.Valid;
import javax.validation.constraints.Min;
import javax.validation.constraints.NotNull;
import static com.codahale.metrics.MetricRegistry.name;
/**
* A factory for configuring the Cassandra bundle.
*
* Configuration Parameters:
*
*
* Name
* Default
* Description
*
*
* clusterName
* Defaults to the cluster name provided by the Cassandra driver.
* The name of the cluster, as defined by the Cassandra driver; also used in metrics and health checks.
*
*
* keyspace
* No default. If provided, this will be included in the health check.
* The name of the keyspace to connect to.
*
*
* validationQuery
* SELECT * FROM system_schema.keyspaces
* The query to execute against the cluster to determine whether it is healthy.
*
*
* healthCheckTimeout
* 2 seconds.
* Sets the maximum time to wait for the validation query to respond.
*
*
* contactPoints
* No default. You must provide a list of contact points for the Cassandra driver.
* Each contact point can be a DNS record resolving to multiple hosts. In this case all of them will be added to the {@link Cluster}.
*
*
* port
* 9042
* The port to use to connect to the Cassandra host.
*
*
* protocolVersion
* -1
* The native protocol version to use.
*
*
* compression
* NONE
* Sets the compression to use for the transport. Must a value in the {@link ProtocolOptions.Compression compression enum}.
*
*
* maxSchemaAgreementWait
* No default.
* Sets the maximum time to wait for schema agreement before returning from a DDL query.
*
*
* reconnectionPolicy
* No default.
* The {@link ReconnectionPolicyFactory reconnection policy} to use.
*
*
* authProvider
* No default.
* The {@link AuthProviderFactory auth provider} to use.
*
*
* retryPolicy
* No default.
* The {@link RetryPolicyFactory retry policy} to use.
*
*
* loadBalancingPolicy
* No default.
* The {@link LoadBalancingPolicyFactory load balancing policy} to use.
*
*
* speculativeExecutionPolicy
* No default.
* The {@link SpeculativeExecutionPolicyFactory speculative execution policy} to use.
*
*
* queryOptions
* No default.
* The {@link QueryOptions} to use.
*
*
* socketOptions
* No default.
* The {@link SocketOptions} to use
*
*
* poolingOptions
* No default.
* The {@link PoolingOptionsFactory pooling options} to use.
*
*
* metricsEnabled
* true
* Whether or not to enable metrics reporting.
*
*
* jmxEnabled
* false
* Whether or not to enable JMX metrics reporting. This should ideally remain disabled in a Dropwizard app,
* as metrics reporters should be configured via the {@code metrics} configuration option.
*
*
* shutdownGracePeriod
* 30 seconds
* The time to wait while the cluster closes gracefully; after which, the cluster will be forcefully terminated.
*
*
*/
public class CassandraFactory {
private static final Logger LOG = LoggerFactory.getLogger(CassandraFactory.class);
private String clusterName;
private String keyspace;
@NotEmpty
private String validationQuery = "SELECT * FROM system_schema.keyspaces";
@NotEmpty
private String[] contactPoints;
@Min(1)
private int port = ProtocolOptions.DEFAULT_PORT;
private ProtocolVersion protocolVersion;
@Valid
private SSLOptionsFactory ssl;
@NotNull
private ProtocolOptions.Compression compression = ProtocolOptions.Compression.NONE;
private Duration maxSchemaAgreementWait;
@Valid
private ReconnectionPolicyFactory reconnectionPolicy;
@Valid
private AuthProviderFactory authProvider;
@Valid
private RetryPolicyFactory retryPolicy;
@Valid
private LoadBalancingPolicyFactory loadBalancingPolicy;
@Valid
private SpeculativeExecutionPolicyFactory speculativeExecutionPolicy;
private QueryOptions queryOptions;
private SocketOptions socketOptions;
@Valid
private PoolingOptionsFactory poolingOptions;
private boolean metricsEnabled = true;
private boolean jmxEnabled = false;
@NotNull
private Duration shutdownGracePeriod = Duration.seconds(30);
@NotNull
private Duration healthCheckTimeout = Duration.seconds(2);
@JsonProperty
public String getClusterName() {
return clusterName;
}
@JsonProperty
public void setClusterName(String clusterName) {
this.clusterName = clusterName;
}
@JsonProperty
public String getKeyspace() {
return keyspace;
}
@JsonProperty
public void setKeyspace(String keyspace) {
this.keyspace = keyspace;
}
@JsonProperty
public String getValidationQuery() {
return validationQuery;
}
@JsonProperty
public void setValidationQuery(String validationQuery) {
this.validationQuery = validationQuery;
}
@JsonProperty
public String[] getContactPoints() {
return contactPoints;
}
@JsonProperty
public void setContactPoints(String[] contactPoints) {
this.contactPoints = contactPoints;
}
@JsonProperty
public int getPort() {
return port;
}
@JsonProperty
public void setPort(int port) {
this.port = port;
}
@JsonProperty
public ProtocolVersion getProtocolVersion() {
return protocolVersion;
}
@JsonProperty
public void setProtocolVersion(ProtocolVersion protocolVersion) {
this.protocolVersion = protocolVersion;
}
@JsonProperty
public SSLOptionsFactory getSsl() {
return ssl;
}
@JsonProperty
public void setSsl(SSLOptionsFactory ssl) {
this.ssl = ssl;
}
@JsonProperty
public ProtocolOptions.Compression getCompression() {
return compression;
}
@JsonProperty
public void setCompression(ProtocolOptions.Compression compression) {
this.compression = compression;
}
@JsonProperty
public void setMaxSchemaAgreementWait(Duration maxSchemaAgreementWait) {
this.maxSchemaAgreementWait = maxSchemaAgreementWait;
}
@JsonProperty
public ReconnectionPolicyFactory getReconnectionPolicy() {
return reconnectionPolicy;
}
@JsonProperty
public void setReconnectionPolicy(ReconnectionPolicyFactory reconnectionPolicy) {
this.reconnectionPolicy = reconnectionPolicy;
}
@JsonProperty
public AuthProviderFactory getAuthProvider() {
return authProvider;
}
@JsonProperty
public void setAuthProvider(AuthProviderFactory authProvider) {
this.authProvider = authProvider;
}
@JsonProperty
public RetryPolicyFactory getRetryPolicy() {
return retryPolicy;
}
@JsonProperty
public void setRetryPolicy(RetryPolicyFactory retryPolicy) {
this.retryPolicy = retryPolicy;
}
@JsonProperty
public LoadBalancingPolicyFactory getLoadBalancingPolicy() {
return loadBalancingPolicy;
}
@JsonProperty
public void setLoadBalancingPolicy(LoadBalancingPolicyFactory loadBalancingPolicy) {
this.loadBalancingPolicy = loadBalancingPolicy;
}
@JsonProperty
public SpeculativeExecutionPolicyFactory getSpeculativeExecutionPolicy() {
return speculativeExecutionPolicy;
}
@JsonProperty
public void setSpeculativeExecutionPolicy(SpeculativeExecutionPolicyFactory speculativeExecutionPolicy) {
this.speculativeExecutionPolicy = speculativeExecutionPolicy;
}
@JsonProperty
public QueryOptions getQueryOptions() {
return queryOptions;
}
@JsonProperty
public void setQueryOptions(QueryOptions queryOptions) {
this.queryOptions = queryOptions;
}
@JsonProperty
public SocketOptions getSocketOptions() {
return socketOptions;
}
@JsonProperty
public void setSocketOptions(SocketOptions socketOptions) {
this.socketOptions = socketOptions;
}
@JsonProperty
public PoolingOptionsFactory getPoolingOptions() {
return poolingOptions;
}
@JsonProperty
public void setPoolingOptions(PoolingOptionsFactory poolingOptions) {
this.poolingOptions = poolingOptions;
}
@JsonProperty
public boolean isMetricsEnabled() {
return metricsEnabled;
}
@JsonProperty
public void setMetricsEnabled(boolean metricsEnabled) {
this.metricsEnabled = metricsEnabled;
}
@JsonProperty
public boolean isJmxEnabled() {
return jmxEnabled;
}
@JsonProperty
public void setJmxEnabled(boolean jmxEnabled) {
this.jmxEnabled = jmxEnabled;
}
@JsonProperty
public Duration getShutdownGracePeriod() {
return shutdownGracePeriod;
}
@JsonProperty
public void setShutdownGracePeriod(Duration shutdownGracePeriod) {
this.shutdownGracePeriod = shutdownGracePeriod;
}
@JsonProperty
public Duration getHealthCheckTimeout() {
return healthCheckTimeout;
}
@JsonProperty
public void setHealthCheckTimeout(Duration healthCheckTimeout) {
this.healthCheckTimeout = healthCheckTimeout;
}
/**
* Builds a {@link Cluster} instance for the given {@link Environment}.
*
* The {@code environment} will be used for lifecycle management, as well as metrics and
* health-checks.
*
* @param environment the environment to manage the lifecycle, metrics and health-checks.
* @return a fully configured and managed {@link Cluster}.
*/
public Cluster build(Environment environment) {
final Cluster cluster = build(environment.metrics(), environment.healthChecks());
LOG.debug("Registering {} Cassandra cluster for lifecycle management", cluster.getClusterName());
environment.lifecycle().manage(new CassandraManager(cluster, getShutdownGracePeriod()));
return cluster;
}
/**
* Builds a {@link Cluster} instance.
*
* The {@link MetricRegistry} will be used to register client metrics, and the {@link
* HealthCheckRegistry} to register client health-checks.
*
* @param metrics the registry to register client metrics.
* @param healthChecks the registry to register client health-checks.
* @return a fully configured {@link Cluster}.
*/
public Cluster build(MetricRegistry metrics, HealthCheckRegistry healthChecks) {
final Cluster.Builder builder = Cluster.builder();
for (String contactPoint : contactPoints) {
builder.addContactPoints(contactPoint);
}
builder.withPort(port);
builder.withCompression(compression);
builder.withProtocolVersion(protocolVersion);
if (ssl != null) {
builder.withSSL(ssl.build());
}
if (maxSchemaAgreementWait != null) {
builder.withMaxSchemaAgreementWaitSeconds((int) maxSchemaAgreementWait.toSeconds());
}
if (authProvider != null) {
builder.withAuthProvider(authProvider.build());
}
if (reconnectionPolicy != null) {
builder.withReconnectionPolicy(reconnectionPolicy.build());
}
if (retryPolicy != null) {
builder.withRetryPolicy(retryPolicy.build());
}
if (loadBalancingPolicy != null) {
builder.withLoadBalancingPolicy(loadBalancingPolicy.build());
}
if (speculativeExecutionPolicy != null) {
builder.withSpeculativeExecutionPolicy(speculativeExecutionPolicy.build());
}
if (queryOptions != null) {
builder.withQueryOptions(queryOptions);
}
if (socketOptions != null) {
builder.withSocketOptions(socketOptions);
}
if (poolingOptions != null) {
builder.withPoolingOptions(poolingOptions.build());
}
if (!metricsEnabled) {
builder.withoutMetrics();
}
if (!jmxEnabled) {
builder.withoutJMXReporting();
}
if (!Strings.isNullOrEmpty(clusterName)) {
builder.withClusterName(clusterName);
}
Cluster cluster = builder.build();
LOG.debug("Registering {} Cassandra health check", cluster.getClusterName());
CassandraHealthCheck healthCheck = new CassandraHealthCheck(cluster, validationQuery, healthCheckTimeout);
healthChecks.register(name("cassandra", cluster.getClusterName()), healthCheck);
if (isMetricsEnabled()) {
LOG.debug("Registering {} Cassandra metrics", cluster.getClusterName());
metrics.registerAll(new CassandraMetricSet(cluster));
}
return cluster;
}
}