com.ing.data.cassandra.jdbc

Class CassandraPreparedStatement

java.lang.Object

com.ing.data.cassandra.jdbc.CassandraStatement

com.ing.data.cassandra.jdbc.CassandraPreparedStatement

All Implemented Interfaces:

CassandraStatementExtras, CassandraStatementJsonSupport, AutoCloseable, Comparable<Object>, PreparedStatement, Statement, Wrapper

public class CassandraPreparedStatement
extends CassandraStatement
implements PreparedStatement, CassandraStatementJsonSupport

Cassandra prepared statement: implementation class for PreparedStatement.

It extends CassandraStatement and thereby also implements CassandraStatementExtras and CassandraStatementJsonSupport interfaces providing extra methods not defined in JDBC API to manage some properties specific to the Cassandra statements (e.g. consistency level) and ease usage of JSON features INSERT INTO ... JSON and fromJson() provided by Cassandra.

Field Summary

Fields inherited from class com.ing.data.cassandra.jdbc.CassandraStatement

batchQueries, connection, consistencyLevel, cql, currentResultSet, DEFAULT_FETCH_SIZE, escapeProcessing, fetchDirection, fetchSize, MAX_ASYNC_QUERIES, maxFieldSize, maxRows, resultSetConcurrency, resultSetHoldability, resultSetType, statement, STATEMENTS_SEPARATOR_REGEX, updateCount

Fields inherited from interface java.sql.Statement

CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO

Method Summary

Modifier and Type	Method and Description
void	addBatch()
void	cancel()
void	clearParameters()
void	close()
void	closeOnCompletion()
boolean	execute()
boolean	execute(String cql, int[] columnIndexes)
boolean	execute(String cql, String[] columnNames)
int[]	executeBatch()
ResultSet	executeQuery()
int	executeUpdate() Executes the CQL statement in this PreparedStatement object, which must be a CQL Data Manipulation Language (DML) statement, such as INSERT, UPDATE or DELETE; or a CQL statement that returns nothing, such as a DDL statement.
int	executeUpdate(String cql, int[] columnIndexes)
int	executeUpdate(String cql, String[] columnNames)
ResultSet	getGeneratedKeys()
ResultSetMetaData	getMetaData()
ParameterMetaData	getParameterMetaData()
ResultSet	getResultSet()
boolean	isCloseOnCompletion()
boolean	isWrapperFor(Class<?> iface)
void	setArray(int parameterIndex, Array x)
void	setAsciiStream(int parameterIndex, InputStream x)
void	setAsciiStream(int parameterIndex, InputStream x, int length)
void	setAsciiStream(int parameterIndex, InputStream x, long length)
void	setBigDecimal(int parameterIndex, BigDecimal x)
void	setBinaryStream(int parameterIndex, InputStream x)
void	setBinaryStream(int parameterIndex, InputStream x, int length)
void	setBinaryStream(int parameterIndex, InputStream x, long length)
void	setBlob(int parameterIndex, Blob x)
void	setBlob(int parameterIndex, InputStream inputStream)
void	setBlob(int parameterIndex, InputStream inputStream, long length)
void	setBoolean(int parameterIndex, boolean x)
void	setByte(int parameterIndex, byte x)
void	setBytes(int parameterIndex, byte[] x)
void	setCharacterStream(int parameterIndex, Reader reader)
void	setCharacterStream(int parameterIndex, Reader reader, int length)
void	setCharacterStream(int parameterIndex, Reader reader, long length)
void	setClob(int parameterIndex, Clob x)
void	setClob(int parameterIndex, Reader reader)
void	setClob(int parameterIndex, Reader reader, long length)
void	setCursorName(String name)
void	setDate(int parameterIndex, Date x)
void	setDate(int parameterIndex, Date x, Calendar cal)
void	setDouble(int parameterIndex, double x)
void	setDuration(int parameterIndex, com.datastax.oss.driver.api.core.data.CqlDuration x) Sets the designated parameter to the given CqlDuration value.
void	setFloat(int parameterIndex, float x)
void	setInt(int parameterIndex, int x)
<T> void	setJson(int parameterIndex, T x) Sets the value of the designated parameter with the given object converted to a JSON string.
void	setLong(int parameterIndex, long x)
void	setNCharacterStream(int parameterIndex, Reader value)
void	setNCharacterStream(int parameterIndex, Reader value, long length)
void	setNClob(int parameterIndex, NClob value)
void	setNClob(int parameterIndex, Reader reader)
void	setNClob(int parameterIndex, Reader reader, long length)
void	setNString(int parameterIndex, String value)
void	setNull(int parameterIndex, int sqlType)
void	setNull(int parameterIndex, int sqlType, String typeName)
void	setObject(int parameterIndex, Object x)
void	setObject(int parameterIndex, Object x, int targetSqlType)
void	setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength)
void	setRef(int parameterIndex, Ref x)
void	setRowId(int parameterIndex, RowId x)
void	setShort(int parameterIndex, short x)
void	setSQLXML(int parameterIndex, SQLXML xmlObject)
void	setString(int parameterIndex, String x)
void	setTime(int parameterIndex, Time x)
void	setTime(int parameterIndex, Time x, Calendar cal)
void	setTimestamp(int parameterIndex, Timestamp x)
void	setTimestamp(int parameterIndex, Timestamp x, Calendar cal)
void	setUnicodeStream(int parameterIndex, InputStream x, int length)
void	setURL(int parameterIndex, URL value)
<T> T	unwrap(Class<T> iface)

Methods inherited from class com.ing.data.cassandra.jdbc.CassandraStatement

addBatch, checkNotClosed, clearBatch, clearWarnings, compareTo, execute, execute, executeQuery, executeUpdate, executeUpdate, getCassandraConnection, getConnection, getConsistencyLevel, getFetchDirection, getFetchSize, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isClosed, isPoolable, resetResults, setConsistencyLevel, setEscapeProcessing, setFetchDirection, setFetchSize, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeout

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.sql.PreparedStatement

executeLargeUpdate, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setObject, setObject, setRef, setSQLXML, setUnicodeStream

Methods inherited from interface java.sql.Statement

addBatch, cancel, clearBatch, clearWarnings, closeOnCompletion, execute, execute, execute, execute, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getLargeMaxRows, getLargeUpdateCount, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isClosed, isCloseOnCompletion, isPoolable, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeout

Methods inherited from interface java.sql.Wrapper

isWrapperFor, unwrap

Method Detail

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Statement

Overrides:

close in class CassandraStatement

addBatch

public void addBatch()
              throws SQLException

Specified by:

addBatch in interface PreparedStatement

Throws:

SQLException

clearParameters

public void clearParameters()
                     throws SQLException

Specified by:

clearParameters in interface PreparedStatement

Throws:

SQLException

execute

public boolean execute()
                throws SQLException

Specified by:

execute in interface PreparedStatement

Throws:

SQLException

executeBatch

public int[] executeBatch()
                   throws SQLException

Specified by:

executeBatch in interface Statement

Overrides:

executeBatch in class CassandraStatement

Throws:

SQLException

executeQuery

public ResultSet executeQuery()
                       throws SQLException

Specified by:

executeQuery in interface PreparedStatement

Throws:

SQLException

executeUpdate

public int executeUpdate()
                  throws SQLException

Executes the CQL statement in this PreparedStatement object, which must be a CQL Data Manipulation Language (DML) statement, such as INSERT, UPDATE or DELETE; or a CQL statement that returns nothing, such as a DDL statement.

Specified by:

executeUpdate in interface PreparedStatement

Returns:

Always 0, for any statement. The rationale is that Java Driver for Apache Cassandra® does not provide update count.

Throws:

SQLException - when something went wrong during the execution of the statement.

getMetaData

public ResultSetMetaData getMetaData()
                              throws SQLException

Specified by:

getMetaData in interface PreparedStatement

Throws:

SQLException

getParameterMetaData

public ParameterMetaData getParameterMetaData()
                                       throws SQLException

Specified by:

getParameterMetaData in interface PreparedStatement

Throws:

SQLException

setBigDecimal

public void setBigDecimal(int parameterIndex,
                          BigDecimal x)
                   throws SQLException

Specified by:

setBigDecimal in interface PreparedStatement

Throws:

SQLException

setBlob

public void setBlob(int parameterIndex,
                    Blob x)
             throws SQLException

Specified by:

setBlob in interface PreparedStatement

Throws:

SQLException

setBlob

public void setBlob(int parameterIndex,
                    InputStream inputStream)
             throws SQLException

Specified by:

setBlob in interface PreparedStatement

Throws:

SQLException

setBoolean

public void setBoolean(int parameterIndex,
                       boolean x)
                throws SQLException

Specified by:

setBoolean in interface PreparedStatement

Throws:

SQLException

setByte

public void setByte(int parameterIndex,
                    byte x)
             throws SQLException

Specified by:

setByte in interface PreparedStatement

Throws:

SQLException

setBytes

public void setBytes(int parameterIndex,
                     byte[] x)
              throws SQLException

Specified by:

setBytes in interface PreparedStatement

Throws:

SQLException

setCharacterStream

public void setCharacterStream(int parameterIndex,
                               Reader reader,
                               int length)
                        throws SQLException

Specified by:

setCharacterStream in interface PreparedStatement

Throws:

SQLException

setDate

public void setDate(int parameterIndex,
                    Date x)
             throws SQLException

Specified by:

setDate in interface PreparedStatement

Throws:

SQLException

setDate

public void setDate(int parameterIndex,
                    Date x,
                    Calendar cal)
             throws SQLException

Specified by:

setDate in interface PreparedStatement

Throws:

SQLException

setDouble

public void setDouble(int parameterIndex,
                      double x)
               throws SQLException

Specified by:

setDouble in interface PreparedStatement

Throws:

SQLException

setDuration

public void setDuration(int parameterIndex,
                        com.datastax.oss.driver.api.core.data.CqlDuration x)
                 throws SQLException

Sets the designated parameter to the given CqlDuration value.

This method is not JDBC standard but it helps to set DURATION CQL values into a prepared statement.

Parameters:

parameterIndex - The first parameter is 1, the second is 2, ...

x - The parameter value.

Throws:

SQLException - if parameterIndex does not correspond to a parameter marker in the CQL statement; if a database access error occurs or this method is called on a closed PreparedStatement.

setFloat

public void setFloat(int parameterIndex,
                     float x)
              throws SQLException

Specified by:

setFloat in interface PreparedStatement

Throws:

SQLException

setInt

public void setInt(int parameterIndex,
                   int x)
            throws SQLException

Specified by:

setInt in interface PreparedStatement

Throws:

SQLException

setLong

public void setLong(int parameterIndex,
                    long x)
             throws SQLException

Specified by:

setLong in interface PreparedStatement

Throws:

SQLException

setNString

public void setNString(int parameterIndex,
                       String value)
                throws SQLException

Specified by:

setNString in interface PreparedStatement

Throws:

SQLException

setNull

public void setNull(int parameterIndex,
                    int sqlType)
             throws SQLException

Specified by:

setNull in interface PreparedStatement

Throws:

SQLException

setNull

public void setNull(int parameterIndex,
                    int sqlType,
                    String typeName)
             throws SQLException

Specified by:

setNull in interface PreparedStatement

Throws:

SQLException

setObject

public void setObject(int parameterIndex,
                      Object x)
               throws SQLException

Specified by:

setObject in interface PreparedStatement

Throws:

SQLException

setObject

public void setObject(int parameterIndex,
                      Object x,
                      int targetSqlType)
               throws SQLException

Specified by:

setObject in interface PreparedStatement

Throws:

SQLException

setObject

public final void setObject(int parameterIndex,
                            Object x,
                            int targetSqlType,
                            int scaleOrLength)
                     throws SQLException

Specified by:

setObject in interface PreparedStatement

Throws:

SQLException

setRowId

public void setRowId(int parameterIndex,
                     RowId x)
              throws SQLException

Specified by:

setRowId in interface PreparedStatement

Throws:

SQLException

setShort

public void setShort(int parameterIndex,
                     short x)
              throws SQLException

Specified by:

setShort in interface PreparedStatement

Throws:

SQLException

setString

public void setString(int parameterIndex,
                      String x)
               throws SQLException

Specified by:

setString in interface PreparedStatement

Throws:

SQLException

setTime

public void setTime(int parameterIndex,
                    Time x)
             throws SQLException

Specified by:

setTime in interface PreparedStatement

Throws:

SQLException

setTime

public void setTime(int parameterIndex,
                    Time x,
                    Calendar cal)
             throws SQLException

Specified by:

setTime in interface PreparedStatement

Throws:

SQLException

setTimestamp

public void setTimestamp(int parameterIndex,
                         Timestamp x)
                  throws SQLException

Specified by:

setTimestamp in interface PreparedStatement

Throws:

SQLException

setTimestamp

public void setTimestamp(int parameterIndex,
                         Timestamp x,
                         Calendar cal)
                  throws SQLException

Specified by:

setTimestamp in interface PreparedStatement

Throws:

SQLException

setURL

public void setURL(int parameterIndex,
                   URL value)
            throws SQLException

Specified by:

setURL in interface PreparedStatement

Throws:

SQLException

setJson

public <T> void setJson(int parameterIndex,
                        T x)
                 throws SQLException

Description copied from interface: CassandraStatementJsonSupport

Sets the value of the designated parameter with the given object converted to a JSON string.

Typically, this method can be called to bind a JSON parameter in a CQL query like:
INSERT INTO exampleTable JSON ?;
or on a specific column using with the function fromJson():
INSERT INTO exampleTable (item) VALUES (fromJson(?));

Specified by:

setJson in interface CassandraStatementJsonSupport

Type Parameters:

T - The type of the original object before conversion to a JSON string.

Parameters:

parameterIndex - The parameter index (the first parameter is 1).

x - The object containing the input parameter value.

Throws:

SQLException - if the parameter index does not correspond to a parameter marker in the SQL statement; if a database access error occurs; if this method is called on a closed PreparedStatement or if the object specified by x cannot be converted into a valid JSON string.

getResultSet

public ResultSet getResultSet()
                       throws SQLException

Specified by:

getResultSet in interface Statement

Overrides:

getResultSet in class CassandraStatement

Throws:

SQLException

cancel

public void cancel()
            throws SQLException

Throws:

SQLException

execute

public boolean execute(String cql,
                       int[] columnIndexes)
                throws SQLException

Throws:

SQLException

execute

public boolean execute(String cql,
                       String[] columnNames)
                throws SQLException

Throws:

SQLException

executeUpdate

public int executeUpdate(String cql,
                         int[] columnIndexes)
                  throws SQLException

Throws:

SQLException

executeUpdate

public int executeUpdate(String cql,
                         String[] columnNames)
                  throws SQLException

Throws:

SQLException

getGeneratedKeys

public ResultSet getGeneratedKeys()
                           throws SQLException

Throws:

SQLException

setCursorName

public void setCursorName(String name)
                   throws SQLException

Throws:

SQLException

closeOnCompletion

public void closeOnCompletion()
                       throws SQLException

Throws:

SQLException

isCloseOnCompletion

public boolean isCloseOnCompletion()
                            throws SQLException

Throws:

SQLException

setArray

public void setArray(int parameterIndex,
                     Array x)
              throws SQLException

Throws:

SQLException

setAsciiStream

public void setAsciiStream(int parameterIndex,
                           InputStream x)
                    throws SQLException

Throws:

SQLException

setAsciiStream

public void setAsciiStream(int parameterIndex,
                           InputStream x,
                           int length)
                    throws SQLException

Throws:

SQLException

setAsciiStream

public void setAsciiStream(int parameterIndex,
                           InputStream x,
                           long length)
                    throws SQLException

Throws:

SQLException

setBinaryStream

public void setBinaryStream(int parameterIndex,
                            InputStream x)
                     throws SQLException

Throws:

SQLException

setBinaryStream

public void setBinaryStream(int parameterIndex,
                            InputStream x,
                            int length)
                     throws SQLException

Throws:

SQLException

setBinaryStream

public void setBinaryStream(int parameterIndex,
                            InputStream x,
                            long length)
                     throws SQLException

Throws:

SQLException

setBlob

public void setBlob(int parameterIndex,
                    InputStream inputStream,
                    long length)
             throws SQLException

Throws:

SQLException

setCharacterStream

public void setCharacterStream(int parameterIndex,
                               Reader reader)
                        throws SQLException

Throws:

SQLException

setCharacterStream

public void setCharacterStream(int parameterIndex,
                               Reader reader,
                               long length)
                        throws SQLException

Throws:

SQLException

setClob

public void setClob(int parameterIndex,
                    Clob x)
             throws SQLException

Throws:

SQLException

setClob

public void setClob(int parameterIndex,
                    Reader reader)
             throws SQLException

Throws:

SQLException

setClob

public void setClob(int parameterIndex,
                    Reader reader,
                    long length)
             throws SQLException

Throws:

SQLException

setNCharacterStream

public void setNCharacterStream(int parameterIndex,
                                Reader value)
                         throws SQLException

Throws:

SQLException

setNCharacterStream

public void setNCharacterStream(int parameterIndex,
                                Reader value,
                                long length)
                         throws SQLException

Throws:

SQLException

setNClob

public void setNClob(int parameterIndex,
                     NClob value)
              throws SQLException

Throws:

SQLException

setNClob

public void setNClob(int parameterIndex,
                     Reader reader)
              throws SQLException

Throws:

SQLException

setNClob

public void setNClob(int parameterIndex,
                     Reader reader,
                     long length)
              throws SQLException

Throws:

SQLException

setRef

public void setRef(int parameterIndex,
                   Ref x)
            throws SQLException

Throws:

SQLException

setSQLXML

public void setSQLXML(int parameterIndex,
                      SQLXML xmlObject)
               throws SQLException

Throws:

SQLException

setUnicodeStream

public void setUnicodeStream(int parameterIndex,
                             InputStream x,
                             int length)
                      throws SQLException

Throws:

SQLException

isWrapperFor

public boolean isWrapperFor(Class<?> iface)
                     throws SQLException

Specified by:

isWrapperFor in interface Wrapper

Throws:

SQLException

unwrap

public <T> T unwrap(Class<T> iface)
             throws SQLException

Specified by:

unwrap in interface Wrapper

Throws:

SQLException