com.mysql.cj.xdevapi

Class PreparableStatement<RES_T>

java.lang.Object

com.mysql.cj.xdevapi.PreparableStatement<RES_T>

Type Parameters:

RES_T - result interface

Direct Known Subclasses:

FilterableStatement

public abstract class PreparableStatement<RES_T>
extends java.lang.Object

Abstract class, common to all X DevAPI statement classes that can be prepared.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PreparableStatement.PreparableStatementFinalizer PhantomReference to track prepared statement ids.
protected static class	PreparableStatement.PreparedState

Field Summary

Fields

Modifier and Type	Field and Description
protected MysqlxSession	mysqlxSession
protected PreparableStatement.PreparedState	preparedState
protected int	preparedStatementId

Constructor Summary

Constructors

Constructor and Description
PreparableStatement()

Method Summary

Modifier and Type	Method and Description
protected void	deallocatePrepared() Deallocate this prepared statement from current MysqlxSession.
RES_T	execute() Executes synchronously this statement either directly or using prepared statements if: 1.
protected abstract RES_T	executePreparedStatement() Executes a previously server-prepared statement.
protected abstract RES_T	executeStatement() Executes the statement directly (non-prepared).
protected XMessageBuilder	getMessageBuilder() Helper method to return an XMessageBuilder instance from MysqlxSession in use.
protected abstract XMessage	getPrepareStatementXMessage() Returns the XMessage needed to prepare this statement.
private boolean	prepareStatement() Prepares a statement on the server to be later executed.
protected void	resetPrepareState() Mark this preparable statement to be deallocated on next execution, if it is currently prepared, or cancel the next prepare.
protected void	setReprepareState() Mark this preparable statement to be deallocated and re-prepared on next execution, if it is currently prepared.

Methods inherited from class java.lang.Object

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

Field Detail

preparedStatementId

protected int preparedStatementId

preparedState

protected PreparableStatement.PreparedState preparedState

mysqlxSession

protected MysqlxSession mysqlxSession

Constructor Detail

PreparableStatement

public PreparableStatement()

Method Detail

getMessageBuilder

protected XMessageBuilder getMessageBuilder()

Helper method to return an XMessageBuilder instance from MysqlxSession in use.

Returns:

the XMessageBuilder instance from current MysqlxSession

resetPrepareState

protected void resetPrepareState()

Mark this preparable statement to be deallocated on next execution, if it is currently prepared, or cancel the next prepare.

setReprepareState

protected void setReprepareState()

Mark this preparable statement to be deallocated and re-prepared on next execution, if it is currently prepared.

execute

public RES_T execute()

Executes synchronously this statement either directly or using prepared statements if: 1. Prepared statements are supported by the server. 2. The statement is executed repeatedly without changing its structure.

Returns:

the object returned from the low level statement execution

executeStatement

protected abstract RES_T executeStatement()

Executes the statement directly (non-prepared). Implementation is dependent on the statement type.

Returns:

the object returned from the lower level statement execution

getPrepareStatementXMessage

protected abstract XMessage getPrepareStatementXMessage()

Returns the XMessage needed to prepare this statement. Implementation is dependent on the statement type.

Returns:

the XMessage that prepares this statement

prepareStatement

private boolean prepareStatement()

Prepares a statement on the server to be later executed.

Returns:

true if the statement was successfully prepared, false otherwise

executePreparedStatement

protected abstract RES_T executePreparedStatement()

Executes a previously server-prepared statement. Implementation is dependent on the statement type.

Returns:

the object returned from the lower level statement execution

deallocatePrepared

protected void deallocatePrepared()

Deallocate this prepared statement from current MysqlxSession.