com.github.adejanovski.cassandra.jdbc

Class Utils

java.lang.Object

com.github.adejanovski.cassandra.jdbc.Utils

public class Utils
extends Object

A set of static utility methods used by the JDBC Suite, and various default values and error message strings that can be shared across classes.

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	ALWAYS_AUTOCOMMIT
protected static String	BAD_AUTO_GEN
protected static String	BAD_CONCUR_RSET
protected static String	BAD_FETCH_DIR
protected static String	BAD_FETCH_SIZE
protected static String	BAD_HOLD_RSET
protected static String	BAD_KEEP_RSET
protected static String	BAD_KEYSPACE
protected static String	BAD_TIMEOUT
protected static String	BAD_TYPE_RSET
static com.datastax.driver.core.ConsistencyLevel	DEFAULT_CONSISTENCY
static String	DEFAULT_HOST
static int	DEFAULT_PORT
protected static String	FORWARD_ONLY
protected static String	HOST_IN_URL
protected static String	HOST_REQUIRED
static String	KEY_BACKUP_DC
static String	KEY_CONNECTION_RETRIES
static String	KEY_CONSISTENCY
static String	KEY_DEBUG
static String	KEY_LOADBALANCING_POLICY
static String	KEY_PRIMARY_DC
static String	KEY_RECONNECT_POLICY
static String	KEY_RETRY_POLICY
static String	KEY_VERSION
protected static org.slf4j.Logger	logger
protected static String	MUST_BE_POSITIVE
protected static String	NO_BATCH
protected static String	NO_CF
protected static String	NO_COMPARATOR
protected static String	NO_GEN_KEYS
protected static String	NO_INTERFACE
protected static String	NO_MULTIPLE
protected static String	NO_RESULTSET
protected static String	NO_SERVER
protected static String	NO_TRANSACTIONS
protected static String	NO_UPDATE_COUNT
protected static String	NO_VALIDATOR
protected static String	NOT_BOOLEAN
protected static String	NOT_OPTION
static String	NOT_SUPPORTED
protected static String	NOT_TRANSLATABLE
static String	PROTOCOL
protected static String	SCHEMA_MISMATCH
static String	TAG_ACTIVE_CQL_VERSION
static String	TAG_BACKUP_DC
static String	TAG_BUILD_VERSION
static String	TAG_CONNECTION_RETRIES
static String	TAG_CONSISTENCY_LEVEL
static String	TAG_CQL_VERSION
static String	TAG_DATABASE_NAME
static String	TAG_DEBUG
static String	TAG_DESCRIPTION
static String	TAG_LOADBALANCING_POLICY
static String	TAG_PASSWORD
static String	TAG_PORT_NUMBER
static String	TAG_PRIMARY_DC
static String	TAG_RECONNECT_POLICY
static String	TAG_RETRY_POLICY
static String	TAG_SERVER_NAME
static String	TAG_THRIFT_VERSION
static String	TAG_USER
protected static String	URI_IS_SIMPLE
protected static String	VALID_LABELS
protected static String	WAS_CLOSED_CON
protected static String	WAS_CLOSED_RSLT
protected static String	WAS_CLOSED_STMT

Constructor Summary

Constructors

Constructor and Description
Utils()

Method Summary

Modifier and Type	Method and Description
static String	createSubName(Properties props) Create a "Subname" portion of a JDBC URL from properties.
static String	determineCurrentColumnFamily(String cql) Determine the current column family by inspecting the CQL to find a CF reference.
static String	determineCurrentKeyspace(String cql, String current) Determine the current keyspace by inspecting the CQL string to see if a USE statement is provided; which would change the keyspace.
static com.datastax.driver.core.policies.LoadBalancingPolicy	getLbPolicy(String lbString, String parameters)
static com.datastax.driver.core.policies.ReconnectionPolicy	getReconnectionPolicy(String rcString, String parameters)
protected static String	makeQueryString(Properties props)
protected static ByteBuffer	pack(List<ByteBuffer> buffers, int elements, int size) Utility method to pack bytes into a byte buffer from a list of ByteBuffers
static com.datastax.driver.core.policies.LoadBalancingPolicy	parseLbPolicy(String loadBalancingPolicyString)
static ArrayList<?>	parseList(String itemType, String value)
static HashMap<?,?>	parseMap(String kType, String vType, String value)
protected static Map<String,String>	parseQueryPart(String query)
static com.datastax.driver.core.policies.ReconnectionPolicy	parseReconnectionPolicy(String reconnectionPolicyString)
static com.datastax.driver.core.policies.RetryPolicy	parseRetryPolicy(String retryPolicyString)
static LinkedHashSet<?>	parseSet(String itemType, String value)
static Properties	parseURL(String url) Parse a URL for the Cassandra JDBC Driver The URL must start with the Protocol: "jdbc:cassandra:" The URI part(the "Subname") must contain a host and an optional port and optional keyspace name ie.

Methods inherited from class java.lang.Object

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

Field Detail

PROTOCOL

public static final String PROTOCOL

See Also:

Constant Field Values

DEFAULT_HOST

public static final String DEFAULT_HOST

See Also:

Constant Field Values

DEFAULT_PORT

public static final int DEFAULT_PORT

See Also:

Constant Field Values

DEFAULT_CONSISTENCY

public static final com.datastax.driver.core.ConsistencyLevel DEFAULT_CONSISTENCY

KEY_VERSION

public static final String KEY_VERSION

See Also:

Constant Field Values

KEY_CONSISTENCY

public static final String KEY_CONSISTENCY

See Also:

Constant Field Values

KEY_PRIMARY_DC

public static final String KEY_PRIMARY_DC

See Also:

Constant Field Values

KEY_BACKUP_DC

public static final String KEY_BACKUP_DC

See Also:

Constant Field Values

KEY_CONNECTION_RETRIES

public static final String KEY_CONNECTION_RETRIES

See Also:

Constant Field Values

KEY_LOADBALANCING_POLICY

public static final String KEY_LOADBALANCING_POLICY

See Also:

Constant Field Values

KEY_RETRY_POLICY

public static final String KEY_RETRY_POLICY

See Also:

Constant Field Values

KEY_RECONNECT_POLICY

public static final String KEY_RECONNECT_POLICY

See Also:

Constant Field Values

KEY_DEBUG

public static final String KEY_DEBUG

See Also:

Constant Field Values

TAG_DESCRIPTION

public static final String TAG_DESCRIPTION

See Also:

Constant Field Values

TAG_USER

public static final String TAG_USER

See Also:

Constant Field Values

TAG_PASSWORD

public static final String TAG_PASSWORD

See Also:

Constant Field Values

TAG_DATABASE_NAME

public static final String TAG_DATABASE_NAME

See Also:

Constant Field Values

TAG_SERVER_NAME

public static final String TAG_SERVER_NAME

See Also:

Constant Field Values

TAG_PORT_NUMBER

public static final String TAG_PORT_NUMBER

See Also:

Constant Field Values

TAG_ACTIVE_CQL_VERSION

public static final String TAG_ACTIVE_CQL_VERSION

See Also:

Constant Field Values

TAG_CQL_VERSION

public static final String TAG_CQL_VERSION

See Also:

Constant Field Values

TAG_BUILD_VERSION

public static final String TAG_BUILD_VERSION

See Also:

Constant Field Values

TAG_THRIFT_VERSION

public static final String TAG_THRIFT_VERSION

See Also:

Constant Field Values

TAG_CONSISTENCY_LEVEL

public static final String TAG_CONSISTENCY_LEVEL

See Also:

Constant Field Values

TAG_LOADBALANCING_POLICY

public static final String TAG_LOADBALANCING_POLICY

See Also:

Constant Field Values

TAG_RETRY_POLICY

public static final String TAG_RETRY_POLICY

See Also:

Constant Field Values

TAG_RECONNECT_POLICY

public static final String TAG_RECONNECT_POLICY

See Also:

Constant Field Values

TAG_DEBUG

public static final String TAG_DEBUG

See Also:

Constant Field Values

TAG_PRIMARY_DC

public static final String TAG_PRIMARY_DC

See Also:

Constant Field Values

TAG_BACKUP_DC

public static final String TAG_BACKUP_DC

See Also:

Constant Field Values

TAG_CONNECTION_RETRIES

public static final String TAG_CONNECTION_RETRIES

See Also:

Constant Field Values

WAS_CLOSED_CON

protected static final String WAS_CLOSED_CON

See Also:

Constant Field Values

WAS_CLOSED_STMT

protected static final String WAS_CLOSED_STMT

See Also:

Constant Field Values

WAS_CLOSED_RSLT

protected static final String WAS_CLOSED_RSLT

See Also:

Constant Field Values

NO_INTERFACE

protected static final String NO_INTERFACE

See Also:

Constant Field Values

NO_TRANSACTIONS

protected static final String NO_TRANSACTIONS

See Also:

Constant Field Values

NO_SERVER

protected static final String NO_SERVER

See Also:

Constant Field Values

ALWAYS_AUTOCOMMIT

protected static final String ALWAYS_AUTOCOMMIT

See Also:

Constant Field Values

BAD_TIMEOUT

protected static final String BAD_TIMEOUT

See Also:

Constant Field Values

SCHEMA_MISMATCH

protected static final String SCHEMA_MISMATCH

See Also:

Constant Field Values

NOT_SUPPORTED

public static final String NOT_SUPPORTED

See Also:

Constant Field Values

NO_GEN_KEYS

protected static final String NO_GEN_KEYS

See Also:

Constant Field Values

NO_BATCH

protected static final String NO_BATCH

See Also:

Constant Field Values

NO_MULTIPLE

protected static final String NO_MULTIPLE

See Also:

Constant Field Values

NO_VALIDATOR

protected static final String NO_VALIDATOR

See Also:

Constant Field Values

NO_COMPARATOR

protected static final String NO_COMPARATOR

See Also:

Constant Field Values

NO_RESULTSET

protected static final String NO_RESULTSET

See Also:

Constant Field Values

NO_UPDATE_COUNT

protected static final String NO_UPDATE_COUNT

See Also:

Constant Field Values

NO_CF

protected static final String NO_CF

See Also:

Constant Field Values

BAD_KEEP_RSET

protected static final String BAD_KEEP_RSET

See Also:

Constant Field Values

BAD_TYPE_RSET

protected static final String BAD_TYPE_RSET

See Also:

Constant Field Values

BAD_CONCUR_RSET

protected static final String BAD_CONCUR_RSET

See Also:

Constant Field Values

BAD_HOLD_RSET

protected static final String BAD_HOLD_RSET

See Also:

Constant Field Values

BAD_FETCH_DIR

protected static final String BAD_FETCH_DIR

See Also:

Constant Field Values

BAD_AUTO_GEN

protected static final String BAD_AUTO_GEN

See Also:

Constant Field Values

BAD_FETCH_SIZE

protected static final String BAD_FETCH_SIZE

See Also:

Constant Field Values

MUST_BE_POSITIVE

protected static final String MUST_BE_POSITIVE

See Also:

Constant Field Values

VALID_LABELS

protected static final String VALID_LABELS

See Also:

Constant Field Values

NOT_TRANSLATABLE

protected static final String NOT_TRANSLATABLE

See Also:

Constant Field Values

NOT_BOOLEAN

protected static final String NOT_BOOLEAN

See Also:

Constant Field Values

HOST_IN_URL

protected static final String HOST_IN_URL

See Also:

Constant Field Values

HOST_REQUIRED

protected static final String HOST_REQUIRED

See Also:

Constant Field Values

BAD_KEYSPACE

protected static final String BAD_KEYSPACE

See Also:

Constant Field Values

URI_IS_SIMPLE

protected static final String URI_IS_SIMPLE

See Also:

Constant Field Values

NOT_OPTION

protected static final String NOT_OPTION

See Also:

Constant Field Values

FORWARD_ONLY

protected static final String FORWARD_ONLY

See Also:

Constant Field Values

logger

protected static final org.slf4j.Logger logger

Constructor Detail

Utils

public Utils()

Method Detail

parseURL

public static final Properties parseURL(String url)
                                 throws SQLException

Parse a URL for the Cassandra JDBC Driver

The URL must start with the Protocol: "jdbc:cassandra:" The URI part(the "Subname") must contain a host and an optional port and optional keyspace name ie. "//localhost:9160/Test1"

Parameters:

url - The full JDBC URL to be parsed

Returns:

A list of properties that were parsed from the Subname

Throws:

SQLException

createSubName

public static final String createSubName(Properties props)
                                  throws SQLException

Create a "Subname" portion of a JDBC URL from properties.

Parameters:

props - A Properties file containing all the properties to be considered.

Returns:

A constructed "Subname" portion of a JDBC URL in the form of a CLI (ie: //myhost:9160/Test1?version=3.0.0 )

Throws:

SQLException

determineCurrentKeyspace

public static String determineCurrentKeyspace(String cql,
                                              String current)

Determine the current keyspace by inspecting the CQL string to see if a USE statement is provided; which would change the keyspace.

Parameters:

cql - A CQL query string

current - The current keyspace stored as state in the connection

Returns:

the provided keyspace name or the keyspace from the contents of the CQL string

determineCurrentColumnFamily

public static String determineCurrentColumnFamily(String cql)

Determine the current column family by inspecting the CQL to find a CF reference.

Parameters:

cql - A CQL query string

Returns:

The column family name from the contents of the CQL string or null in none was found

pack

protected static ByteBuffer pack(List<ByteBuffer> buffers,
                                 int elements,
                                 int size)

Utility method to pack bytes into a byte buffer from a list of ByteBuffers

Parameters:

buffers - A list of ByteBuffers representing the elements to pack

elements - The count of the elements

size - The size in bytes of the result buffer

Returns:

The packed ByteBuffer

makeQueryString

protected static String makeQueryString(Properties props)

parseQueryPart

protected static Map<String,String> parseQueryPart(String query)
                                            throws SQLException

Throws:

SQLException

parseSet

public static LinkedHashSet<?> parseSet(String itemType,
                                        String value)

parseList

public static ArrayList<?> parseList(String itemType,
                                     String value)

parseMap

public static HashMap<?,?> parseMap(String kType,
                                    String vType,
                                    String value)

parseLbPolicy

public static com.datastax.driver.core.policies.LoadBalancingPolicy parseLbPolicy(String loadBalancingPolicyString)
                                                                           throws InstantiationException,
                                                                                  IllegalAccessException,
                                                                                  ClassNotFoundException,
                                                                                  NoSuchMethodException,
                                                                                  SecurityException,
                                                                                  IllegalArgumentException,
                                                                                  InvocationTargetException

Throws:

InstantiationException

IllegalAccessException

ClassNotFoundException

NoSuchMethodException

SecurityException

IllegalArgumentException

InvocationTargetException

getLbPolicy

public static com.datastax.driver.core.policies.LoadBalancingPolicy getLbPolicy(String lbString,
                                                                                String parameters)
                                                                         throws ClassNotFoundException,
                                                                                NoSuchMethodException,
                                                                                SecurityException,
                                                                                InstantiationException,
                                                                                IllegalAccessException,
                                                                                IllegalArgumentException,
                                                                                InvocationTargetException

Throws:

ClassNotFoundException

NoSuchMethodException

SecurityException

InstantiationException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

parseRetryPolicy

public static com.datastax.driver.core.policies.RetryPolicy parseRetryPolicy(String retryPolicyString)
                                                                      throws InstantiationException,
                                                                             IllegalAccessException,
                                                                             ClassNotFoundException,
                                                                             NoSuchMethodException,
                                                                             SecurityException,
                                                                             IllegalArgumentException,
                                                                             InvocationTargetException,
                                                                             NoSuchFieldException

Throws:

InstantiationException

IllegalAccessException

ClassNotFoundException

NoSuchMethodException

SecurityException

IllegalArgumentException

InvocationTargetException

NoSuchFieldException

parseReconnectionPolicy

public static com.datastax.driver.core.policies.ReconnectionPolicy parseReconnectionPolicy(String reconnectionPolicyString)
                                                                                    throws InstantiationException,
                                                                                           IllegalAccessException,
                                                                                           ClassNotFoundException,
                                                                                           NoSuchMethodException,
                                                                                           SecurityException,
                                                                                           IllegalArgumentException,
                                                                                           InvocationTargetException

Throws:

InstantiationException

IllegalAccessException

ClassNotFoundException

NoSuchMethodException

SecurityException

IllegalArgumentException

InvocationTargetException

getReconnectionPolicy

public static com.datastax.driver.core.policies.ReconnectionPolicy getReconnectionPolicy(String rcString,
                                                                                         String parameters)
                                                                                  throws ClassNotFoundException,
                                                                                         NoSuchMethodException,
                                                                                         SecurityException,
                                                                                         InstantiationException,
                                                                                         IllegalAccessException,
                                                                                         IllegalArgumentException,
                                                                                         InvocationTargetException

Throws:

ClassNotFoundException

NoSuchMethodException

SecurityException

InstantiationException

IllegalAccessException

IllegalArgumentException

InvocationTargetException