io.picodata.jdbc

Class PicodataStatement

java.lang.Object

io.picodata.jdbc.PicodataStatement

All Implemented Interfaces:

AutoCloseable, Statement, Wrapper

Direct Known Subclasses:

PicodataPreparedStatement

public class PicodataStatement
extends Object
implements Statement

JDBC's base Statement implementation.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	PicodataStatement.StatementResultHandler Provides extension point for handling the statement execution results.

Field Summary

Fields

Modifier and Type	Field and Description
protected PicodataConnection	connection Picodata server connection.
protected org.postgresql.jdbc.ResultWrapper	firstUnclosedResult The first unclosed result.
protected org.postgresql.jdbc.ResultWrapper	generatedKeys Results returned by a statement that wants generated keys.
protected ReentrantReadWriteLock	lock Lock for concurent operations on this statement and last operation result.
protected Statement	pgStatement pgJDBC prepared statement.
protected org.postgresql.jdbc.ResultWrapper	result The current results.
protected boolean	wantsGeneratedKeysOnce Does the caller of execute/executeUpdate want generated keys for this execution?

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(String sql)
void	cancel()
protected void	checkClosed() Check that this statement is not closed
protected void	checkNoResultUpdate() Check that last operation didn't return any rows.
void	clearBatch()
void	clearWarnings()
void	close()
void	closeOnCompletion()
ResultSet	createDriverResultSet(org.postgresql.core.Field[] fields, List<org.postgresql.core.Tuple> tuples) Create a new partially initialized ResultSet from its parts.
ResultSet	createResultSet(org.postgresql.core.Query originalQuery, org.postgresql.core.Field[] fields, List<org.postgresql.core.Tuple> tuples, org.postgresql.core.ResultCursor cursor) Create a new ResultSet from its parts.
protected void	execute(org.postgresql.core.CachedQuery cachedQuery, org.postgresql.core.ParameterList queryParameters, int flags) Execute cached query with parameters in pgJDBC query executor.
boolean	execute(String sql)
boolean	execute(String sql, int autoGeneratedKeys)
boolean	execute(String sql, int[] columnIndexes)
boolean	execute(String sql, String[] columnNames)
int[]	executeBatch()
long[]	executeLargeBatch()
long	executeLargeUpdate(String sql)
long	executeLargeUpdate(String sql, int autoGeneratedKeys)
long	executeLargeUpdate(String sql, int[] columnIndexes)
long	executeLargeUpdate(String sql, String[] columnNames)
ResultSet	executeQuery(String sql)
int	executeUpdate(String sql)
int	executeUpdate(String sql, int autoGeneratedKeys)
int	executeUpdate(String sql, int[] columnIndexes)
int	executeUpdate(String sql, String[] columnNames)
protected boolean	executeWithFlags(org.postgresql.core.CachedQuery simpleQuery, int flags) Execute cached query in pgJDBC query executor.
protected boolean	executeWithFlags(String sql, int flags) Cache and execute query in pgJDBC query executor.
Connection	getConnection()
int	getFetchDirection()
int	getFetchSize()
ResultSet	getGeneratedKeys()
long	getLargeMaxRows()
int	getMaxFieldSize()
int	getMaxRows()
boolean	getMoreResults()
boolean	getMoreResults(int current)
int	getQueryTimeout()
ResultSet	getResultSet()
int	getResultSetConcurrency()
int	getResultSetHoldability()
int	getResultSetType()
protected ResultSet	getSingleResultSet() Check if the last query returned a single result set, and return it.
int	getUpdateCount()
SQLWarning	getWarnings()
boolean	isClosed()
boolean	isCloseOnCompletion()
protected boolean	isOneShotQuery(org.postgresql.core.CachedQuery cachedQuery) Returns true if query is unlikely to be reused.
boolean	isPoolable()
boolean	isWrapperFor(Class<?> iface)
void	setCursorName(String name)
void	setEscapeProcessing(boolean enable)
void	setFetchDirection(int direction)
void	setFetchSize(int rows)
void	setLargeMaxRows(long max)
void	setMaxFieldSize(int max)
void	setMaxRows(int max)
void	setPoolable(boolean poolable)
void	setQueryTimeout(int seconds)
<T> T	unwrap(Class<T> iface)

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.sql.Statement

getLargeUpdateCount

Field Detail

connection

protected final PicodataConnection connection

Picodata server connection.

pgStatement

protected final Statement pgStatement

pgJDBC prepared statement.

lock

protected final ReentrantReadWriteLock lock

Lock for concurent operations on this statement and last operation result. For all operations changing the statement parameters or result state, write lock must be acquired.

result

protected volatile org.postgresql.jdbc.ResultWrapper result

The current results.

firstUnclosedResult

protected volatile org.postgresql.jdbc.ResultWrapper firstUnclosedResult

The first unclosed result.

generatedKeys

protected volatile org.postgresql.jdbc.ResultWrapper generatedKeys

Results returned by a statement that wants generated keys.

wantsGeneratedKeysOnce

protected volatile boolean wantsGeneratedKeysOnce

Does the caller of execute/executeUpdate want generated keys for this execution? This is set by Statement methods that have generated keys arguments and cleared after execution is complete.

Method Detail

addBatch

public void addBatch(String sql)
              throws SQLException

Specified by:

addBatch in interface Statement

Throws:

SQLException

clearBatch

public void clearBatch()
                throws SQLException

Specified by:

clearBatch in interface Statement

Throws:

SQLException

executeBatch

public int[] executeBatch()
                   throws SQLException

Specified by:

executeBatch in interface Statement

Throws:

SQLException

cancel

public void cancel()
            throws SQLException

Specified by:

cancel in interface Statement

Throws:

SQLException

getWarnings

public SQLWarning getWarnings()
                       throws SQLException

Specified by:

getWarnings in interface Statement

Throws:

SQLException

clearWarnings

public void clearWarnings()
                   throws SQLException

Specified by:

clearWarnings in interface Statement

Throws:

SQLException

closeOnCompletion

public void closeOnCompletion()
                       throws SQLException

Specified by:

closeOnCompletion in interface Statement

Throws:

SQLException

isCloseOnCompletion

public boolean isCloseOnCompletion()
                            throws SQLException

Specified by:

isCloseOnCompletion in interface Statement

Throws:

SQLException

close

public final void close()
                 throws SQLException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Statement

Throws:

SQLException

isClosed

public boolean isClosed()
                 throws SQLException

Specified by:

isClosed in interface Statement

Throws:

SQLException

checkClosed

protected void checkClosed()
                    throws SQLException

Check that this statement is not closed

Throws:

SQLException - if the statement is closed

isOneShotQuery

protected boolean isOneShotQuery(org.postgresql.core.CachedQuery cachedQuery)

Returns true if query is unlikely to be reused.

Parameters:

cachedQuery - to check (null if current query)

Returns:

true if query is unlikely to be reused

execute

protected final void execute(org.postgresql.core.CachedQuery cachedQuery,
                             org.postgresql.core.ParameterList queryParameters,
                             int flags)
                      throws SQLException

Execute cached query with parameters in pgJDBC query executor.

Parameters:

cachedQuery - cached query

queryParameters - prepared parameters for substitution in the query

flags - internal execution flags

Throws:

SQLException - if the connection to Picodata server is closed or other error occured

executeWithFlags

protected boolean executeWithFlags(String sql,
                                   int flags)
                            throws SQLException

Cache and execute query in pgJDBC query executor.

Parameters:

sql - SQL query

flags - internal execution flags

Returns:

true, if execution result was not null

Throws:

SQLException - if the connection to Picodata server is closed or other error occured

executeWithFlags

protected boolean executeWithFlags(org.postgresql.core.CachedQuery simpleQuery,
                                   int flags)
                            throws SQLException

Execute cached query in pgJDBC query executor.

Parameters:

simpleQuery - cached query

flags - internal execution flags

Returns:

true, if execution result was not null

Throws:

SQLException - if the connection to Picodata server is closed or other error occured

checkNoResultUpdate

protected final void checkNoResultUpdate()
                                  throws SQLException

Check that last operation didn't return any rows.

Throws:

SQLException - if rows were returned or the connection to Picodata server is closed or other error occured

execute

public boolean execute(String sql)
                throws SQLException

Specified by:

execute in interface Statement

Throws:

SQLException

execute

public boolean execute(String sql,
                       int autoGeneratedKeys)
                throws SQLException

Specified by:

execute in interface Statement

Throws:

SQLException

execute

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

Specified by:

execute in interface Statement

Throws:

SQLException

execute

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

Specified by:

execute in interface Statement

Throws:

SQLException

executeUpdate

public int executeUpdate(String sql)
                  throws SQLException

Specified by:

executeUpdate in interface Statement

Throws:

SQLException

executeUpdate

public int executeUpdate(String sql,
                         int autoGeneratedKeys)
                  throws SQLException

Specified by:

executeUpdate in interface Statement

Throws:

SQLException

executeUpdate

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

Specified by:

executeUpdate in interface Statement

Throws:

SQLException

executeUpdate

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

Specified by:

executeUpdate in interface Statement

Throws:

SQLException

executeLargeBatch

public long[] executeLargeBatch()
                         throws SQLException

Specified by:

executeLargeBatch in interface Statement

Throws:

SQLException

executeLargeUpdate

public long executeLargeUpdate(String sql)
                        throws SQLException

Specified by:

executeLargeUpdate in interface Statement

Throws:

SQLException

executeLargeUpdate

public long executeLargeUpdate(String sql,
                               int autoGeneratedKeys)
                        throws SQLException

Specified by:

executeLargeUpdate in interface Statement

Throws:

SQLException

executeLargeUpdate

public long executeLargeUpdate(String sql,
                               int[] columnIndexes)
                        throws SQLException

Specified by:

executeLargeUpdate in interface Statement

Throws:

SQLException

executeLargeUpdate

public long executeLargeUpdate(String sql,
                               String[] columnNames)
                        throws SQLException

Specified by:

executeLargeUpdate in interface Statement

Throws:

SQLException

getSingleResultSet

protected ResultSet getSingleResultSet()
                                throws SQLException

Check if the last query returned a single result set, and return it.

Returns:

result set from last operation

Throws:

SQLException - if last result is empty of contains many rows

executeQuery

public ResultSet executeQuery(String sql)
                       throws SQLException

Specified by:

executeQuery in interface Statement

Throws:

SQLException

getConnection

public Connection getConnection()
                         throws SQLException

Specified by:

getConnection in interface Statement

Throws:

SQLException

setEscapeProcessing

public void setEscapeProcessing(boolean enable)
                         throws SQLException

Specified by:

setEscapeProcessing in interface Statement

Throws:

SQLException

getFetchDirection

public int getFetchDirection()
                      throws SQLException

Specified by:

getFetchDirection in interface Statement

Throws:

SQLException

setFetchDirection

public void setFetchDirection(int direction)
                       throws SQLException

Specified by:

setFetchDirection in interface Statement

Throws:

SQLException

getFetchSize

public int getFetchSize()
                 throws SQLException

Specified by:

getFetchSize in interface Statement

Throws:

SQLException

setFetchSize

public void setFetchSize(int rows)
                  throws SQLException

Specified by:

setFetchSize in interface Statement

Throws:

SQLException

getGeneratedKeys

public ResultSet getGeneratedKeys()
                           throws SQLException

Specified by:

getGeneratedKeys in interface Statement

Throws:

SQLException

getMaxFieldSize

public int getMaxFieldSize()
                    throws SQLException

Specified by:

getMaxFieldSize in interface Statement

Throws:

SQLException

setMaxFieldSize

public void setMaxFieldSize(int max)
                     throws SQLException

Specified by:

setMaxFieldSize in interface Statement

Throws:

SQLException

getMaxRows

public int getMaxRows()
               throws SQLException

Specified by:

getMaxRows in interface Statement

Throws:

SQLException

setMaxRows

public void setMaxRows(int max)
                throws SQLException

Specified by:

setMaxRows in interface Statement

Throws:

SQLException

getMoreResults

public boolean getMoreResults()
                       throws SQLException

Specified by:

getMoreResults in interface Statement

Throws:

SQLException

getMoreResults

public boolean getMoreResults(int current)
                       throws SQLException

Specified by:

getMoreResults in interface Statement

Throws:

SQLException

getLargeMaxRows

public long getLargeMaxRows()
                     throws SQLException

Specified by:

getLargeMaxRows in interface Statement

Throws:

SQLException

setLargeMaxRows

public void setLargeMaxRows(long max)
                     throws SQLException

Specified by:

setLargeMaxRows in interface Statement

Throws:

SQLException

getResultSet

public ResultSet getResultSet()
                       throws SQLException

Specified by:

getResultSet in interface Statement

Throws:

SQLException

getResultSetConcurrency

public int getResultSetConcurrency()
                            throws SQLException

Specified by:

getResultSetConcurrency in interface Statement

Throws:

SQLException

getResultSetHoldability

public int getResultSetHoldability()
                            throws SQLException

Specified by:

getResultSetHoldability in interface Statement

Throws:

SQLException

getResultSetType

public int getResultSetType()
                     throws SQLException

Specified by:

getResultSetType in interface Statement

Throws:

SQLException

setPoolable

public void setPoolable(boolean poolable)
                 throws SQLException

Specified by:

setPoolable in interface Statement

Throws:

SQLException

isPoolable

public boolean isPoolable()
                   throws SQLException

Specified by:

isPoolable in interface Statement

Throws:

SQLException

getQueryTimeout

public int getQueryTimeout()
                    throws SQLException

Specified by:

getQueryTimeout in interface Statement

Throws:

SQLException

setQueryTimeout

public void setQueryTimeout(int seconds)
                     throws SQLException

Specified by:

setQueryTimeout in interface Statement

Throws:

SQLException

setCursorName

public void setCursorName(String name)
                   throws SQLException

Specified by:

setCursorName in interface Statement

Throws:

SQLException

getUpdateCount

public int getUpdateCount()
                   throws SQLException

Specified by:

getUpdateCount in interface Statement

Throws:

SQLException

createResultSet

public ResultSet createResultSet(org.postgresql.core.Query originalQuery,
                                 org.postgresql.core.Field[] fields,
                                 List<org.postgresql.core.Tuple> tuples,
                                 org.postgresql.core.ResultCursor cursor)
                          throws SQLException

Create a new ResultSet from its parts. Not a public API and can be removed in the future.

Parameters:

originalQuery - original parsed SQL query

fields - result set columns

tuples - result set rows

cursor - initial result set cursor state

Returns:

new result set

Throws:

SQLException - if the connection to Picodata server is closed or other error occured

createDriverResultSet

public ResultSet createDriverResultSet(org.postgresql.core.Field[] fields,
                                       List<org.postgresql.core.Tuple> tuples)
                                throws SQLException

Create a new partially initialized ResultSet from its parts. Not a public API and can be removed in the future.

Parameters:

fields - result set columns

tuples - result set rows

Returns:

new result set

Throws:

SQLException - if the connection to Picodata server is closed or other error occured

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