/*
* Copyright 2018 The Vert.x Community.
*
* 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 io.vertx.cassandra;
import com.datastax.driver.core.Cluster;
import io.vertx.codegen.annotations.DataObject;
import io.vertx.core.json.JsonObject;
import java.net.InetSocketAddress;
import java.util.List;
import java.util.stream.Collectors;
Eclipse Vert.x Cassandra client options.
Author: Pavel Drankou, Thomas Segismont
/**
* Eclipse Vert.x Cassandra client options.
*
* @author Pavel Drankou
* @author Thomas Segismont
*/
@DataObject(generateConverter = true)
public class CassandraClientOptions {
Default port for connecting with Cassandra service.
/**
* Default port for connecting with Cassandra service.
*/
public static final int DEFAULT_PORT = 9042;
Default host for connecting with Cassandra service.
/**
* Default host for connecting with Cassandra service.
*/
public static final String DEFAULT_HOST = "localhost";
private Cluster.Builder builder;
private String keyspace;
Default constructor.
/**
* Default constructor.
*/
public CassandraClientOptions() {
this(Cluster.builder());
setPort(DEFAULT_PORT);
}
Copy constructor.
/**
* Copy constructor.
*/
public CassandraClientOptions(CassandraClientOptions other) {
this(Cluster.builder());
setPort(DEFAULT_PORT);
setContactPoints(other.getContactPoints());
keyspace = other.keyspace;
}
Constructor using an existing Builder
instance. /**
* Constructor using an existing {@link Cluster.Builder} instance.
*/
public CassandraClientOptions(Cluster.Builder builder) {
this.builder = builder;
}
Constructor to create options from JSON.
Params: - json – the JSON
/**
* Constructor to create options from JSON.
*
* @param json the JSON
*/
public CassandraClientOptions(JsonObject json) {
this();
CassandraClientOptionsConverter.fromJson(json, this);
}
Returns: a JSON representation of these options
/**
* @return a JSON representation of these options
*/
public JsonObject toJson() {
JsonObject json = new JsonObject();
CassandraClientOptionsConverter.toJson(this, json);
return json;
}
Set a list of hosts, where some of cluster nodes is located.
Params: - contactPoints – the list of hosts
Returns: a reference to this, so the API can be used fluently
/**
* Set a list of hosts, where some of cluster nodes is located.
*
* @param contactPoints the list of hosts
* @return a reference to this, so the API can be used fluently
*/
public CassandraClientOptions setContactPoints(List<String> contactPoints) {
for (String contactPoint : contactPoints) {
builder.addContactPoint(contactPoint);
}
return this;
}
Set which port should be used for all the hosts to connect to a cassandra service.
Params: - port – the port
Returns: a reference to this, so the API can be used fluently
/**
* Set which port should be used for all the hosts to connect to a cassandra service.
*
* @param port the port
* @return a reference to this, so the API can be used fluently
*/
public CassandraClientOptions setPort(int port) {
builder.withPort(port);
return this;
}
Add a address, where a cluster node is located.
Params: - address – the address
Returns: a reference to this, so the API can be used fluently
/**
* Add a address, where a cluster node is located.
* @param address the address
* @return a reference to this, so the API can be used fluently
*/
public CassandraClientOptions addContactPoint(String address) {
builder.addContactPoint(address);
return this;
}
Returns: list of address used by the client for connecting with a cassandra service
/**
* @return list of address used by the client for connecting with a cassandra service
*/
public List<String> getContactPoints() {
return builder.getContactPoints().stream().map(InetSocketAddress::toString).collect(Collectors.toList());
}
Returns: a cluster builder, which will be used by the client
/**
* @return a cluster builder, which will be used by the client
*/
public Cluster.Builder dataStaxClusterBuilder() {
return builder;
}
Returns: the keyspace to use when creating the Cassandra session
/**
* @return the keyspace to use when creating the Cassandra session
*/
public String getKeyspace() {
return keyspace;
}
Set the keyspace to use when creating the Cassandra session. Defaults to null
. Params: - keyspace – the keyspace to use when creating the Cassandra session
Returns: a reference to this, so the API can be used fluently
/**
* Set the keyspace to use when creating the Cassandra session. Defaults to {@code null}.
*
* @param keyspace the keyspace to use when creating the Cassandra session
*
* @return a reference to this, so the API can be used fluently
*/
public CassandraClientOptions setKeyspace(String keyspace) {
this.keyspace = keyspace;
return this;
}
}