com.ing.data.cassandra.jdbc.utils

Class DriverUtil

java.lang.Object

com.ing.data.cassandra.jdbc.utils.DriverUtil

public final class DriverUtil
extends Object

A set of static utility methods and constants used by the JDBC driver.

Field Summary

Fields

Modifier and Type	Field and Description
static String	CASSANDRA_4 Cassandra version 4.0.
static String	CASSANDRA_5 Cassandra version 5.0.
static String	JDBC_DRIVER_PROPERTIES_FILE Properties file name containing some properties relative to this JDBC wrapper (such as JDBC driver version, name, etc.).
static String	JSSE_KEYSTORE_PASSWORD_PROPERTY The JSSE property used to retrieve the key store password when SSL is enabled on the database connection using JSSE properties.
static String	JSSE_KEYSTORE_PROPERTY The JSSE property used to retrieve the key store when SSL is enabled on the database connection using JSSE properties.
static String	JSSE_TRUSTSTORE_PASSWORD_PROPERTY The JSSE property used to retrieve the trust store password when SSL is enabled on the database connection using JSSE properties.
static String	JSSE_TRUSTSTORE_PROPERTY The JSSE property used to retrieve the trust store when SSL is enabled on the database connection using JSSE properties.
static String	NULL_KEYWORD NULL CQL keyword.

Method Summary

Modifier and Type	Method and Description
static String	buildMetadataList(List<VersionedMetadata> metadataList, String dbVersion) Builds an alphabetically sorted and comma-separated list of metadata (such as built-in functions or CQL keywords) existing in the specified Cassandra version.
static DriverPropertyInfo	buildPropertyInfo(String propertyName, Object value) Builds an instance of DriverPropertyInfo for the given driver property and value.
static boolean	existsInDatabaseVersion(String dbVersion, VersionedMetadata versionedMetadata) Checks whether the database metadata (CQL type or built-in function) exists in the current database version.
static String	getDriverProperty(String name) Gets a property value from the Cassandra JDBC driver properties file.
static org.semver4j.Semver	safeParseVersion(String version) Gets the Semver representation of a version string.

Methods inherited from class java.lang.Object

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

Field Detail

JDBC_DRIVER_PROPERTIES_FILE

public static final String JDBC_DRIVER_PROPERTIES_FILE

Properties file name containing some properties relative to this JDBC wrapper (such as JDBC driver version, name, etc.).

See Also:

Constant Field Values

JSSE_TRUSTSTORE_PROPERTY

public static final String JSSE_TRUSTSTORE_PROPERTY

The JSSE property used to retrieve the trust store when SSL is enabled on the database connection using JSSE properties.

See Also:

Constant Field Values

JSSE_TRUSTSTORE_PASSWORD_PROPERTY

public static final String JSSE_TRUSTSTORE_PASSWORD_PROPERTY

The JSSE property used to retrieve the trust store password when SSL is enabled on the database connection using JSSE properties.

See Also:

Constant Field Values

JSSE_KEYSTORE_PROPERTY

public static final String JSSE_KEYSTORE_PROPERTY

The JSSE property used to retrieve the key store when SSL is enabled on the database connection using JSSE properties.

See Also:

Constant Field Values

JSSE_KEYSTORE_PASSWORD_PROPERTY

public static final String JSSE_KEYSTORE_PASSWORD_PROPERTY

The JSSE property used to retrieve the key store password when SSL is enabled on the database connection using JSSE properties.

See Also:

Constant Field Values

NULL_KEYWORD

public static final String NULL_KEYWORD

NULL CQL keyword.

See Also:

Constant Field Values

CASSANDRA_5

public static final String CASSANDRA_5

Cassandra version 5.0. Used for types and built-in functions versioning.

See Also:

Constant Field Values

CASSANDRA_4

public static final String CASSANDRA_4

Cassandra version 4.0. Used for types and built-in functions versioning.

See Also:

Constant Field Values

Method Detail

getDriverProperty

public static String getDriverProperty(String name)

Gets a property value from the Cassandra JDBC driver properties file.

Parameters:

name - The name of the property.

Returns:

The property value or an empty string the value cannot be retrieved.

safeParseVersion

public static org.semver4j.Semver safeParseVersion(String version)

Gets the Semver representation of a version string.

It uses the dot character as separator to parse the different parts of a version (major, minor, patch).

Parameters:

version - The version string (for example X.Y.Z).

Returns:

The parsed version, or Semver.ZERO if the string cannot be parsed correctly.

existsInDatabaseVersion

public static boolean existsInDatabaseVersion(String dbVersion,
                                              VersionedMetadata versionedMetadata)

Checks whether the database metadata (CQL type or built-in function) exists in the current database version.

Parameters:

dbVersion - The version of the Cassandra database the driver is currently connected to.

versionedMetadata - The database metadata to check.

Returns:

true if the database metadata exists in the current database version, false otherwise.

buildMetadataList

public static String buildMetadataList(List<VersionedMetadata> metadataList,
                                       String dbVersion)

Builds an alphabetically sorted and comma-separated list of metadata (such as built-in functions or CQL keywords) existing in the specified Cassandra version.

Parameters:

metadataList - The list of possible metadata to format.

dbVersion - The version of the Cassandra database the driver is currently connected to.

Returns:

The formatted list of metadata.

buildPropertyInfo

public static DriverPropertyInfo buildPropertyInfo(String propertyName,
                                                   Object value)

Builds an instance of DriverPropertyInfo for the given driver property and value.

Parameters:

propertyName - The property name.

value - The current value of the property.

Returns:

The driver property info.