com.mysql.cj

Class ServerPreparedQuery

java.lang.Object

com.mysql.cj.AbstractQuery

com.mysql.cj.ClientPreparedQuery

com.mysql.cj.ServerPreparedQuery

All Implemented Interfaces:

PreparedQuery, Query

Direct Known Subclasses:

ServerPreparedQueryTestcaseGenerator

public class ServerPreparedQuery
extends ClientPreparedQuery

Nested Class Summary

Nested classes/interfaces inherited from interface com.mysql.cj.Query

Query.CancelStatus

Field Summary

Fields

Modifier and Type	Field and Description
static int	BLOB_STREAM_READ_BUF_SIZE
protected NativeMessageBuilder	commandBuilder
protected RuntimeProperty<java.lang.Boolean>	explainSlowQueries
protected boolean	gatherPerfMetrics The "gatherPerfMetrics" connection property value
protected boolean	logSlowQueries The "logSlowQueries" connection property value
static byte	OPEN_CURSOR_FLAG
static byte	PARAMETER_COUNT_AVAILABLE
protected boolean	profileSQL The "profileSQL" connection property value
protected boolean	queryWasSlow
protected RuntimeProperty<java.lang.Integer>	slowQueryThresholdMillis
protected boolean	useCursorFetch

Fields inherited from class com.mysql.cj.ClientPreparedQuery

autoClosePStmtStreams, batchCommandIndex, originalSql, parameterCount, queryBindings, queryInfo, useStreamLengthsInPrepStmts

Fields inherited from class com.mysql.cj.AbstractQuery

batchedArgs, cancelTimeoutMutex, charEncoding, clearWarningsCalled, currentDb, fetchSize, maxAllowedPacket, queryAttributesBindings, resultSetType, session, statementExecuting, statementId, timeoutInMillis

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ServerPreparedQuery(NativeSession sess)

Method Summary

Modifier and Type	Method and Description
void	clearParameters(boolean clearServerParameters)
void	closeQuery()
protected long[]	computeMaxParameterSetSizeAndBatchSize(int numBatchedArgs) Computes the maximum parameter set size and the size of the entire batch given the number of arguments in the batch.
<M extends Message> M	fillSendPacket(QueryBindings bindings)
static ServerPreparedQuery	getInstance(NativeSession sess)
Field[]	getParameterFields()
ColumnDefinition	getResultFields()
long	getServerStatementId()
NativePacketPayload	prepareExecutePacket()
<T extends Resultset> T	readExecuteResult(NativePacketPayload resultPacket, int maxRowsToRetrieve, boolean createStreamingResultSet, ColumnDefinition metadata, ProtocolEntityFactory<T,NativePacketPayload> resultSetFactory, java.lang.String queryAsString)
NativePacketPayload	sendExecutePacket(NativePacketPayload packet, java.lang.String queryAsString)
<T extends Resultset> T	serverExecute(int maxRowsToRetrieve, boolean createStreamingResultSet, ColumnDefinition metadata, ProtocolEntityFactory<T,NativePacketPayload> resultSetFactory)
void	serverPrepare(java.lang.String sql)
void	serverResetStatement()
void	setParameterFields(Field[] parameterFields)
void	setResultFields(ColumnDefinition resultFields)
void	setServerStatementId(long serverStatementId)
void	statementBegins()

Methods inherited from class com.mysql.cj.ClientPreparedQuery

asSql, checkNullOrEmptyQuery, computeBatchSize, getBatchCommandIndex, getOriginalSql, getParameterCount, getQueryBindings, getQueryInfo, setBatchCommandIndex, setOriginalSql, setParameterCount, setQueryBindings, setQueryInfo

Methods inherited from class com.mysql.cj.AbstractQuery

addBatch, checkCancelTimeout, clearBatchedArgs, getBatchedArgs, getCancelTimeoutMutex, getCurrentDatabase, getExecuteTime, getId, getQueryAttributesBindings, getResultFetchSize, getResultSetFactory, getResultType, getSession, getStatementExecuting, getTimeoutInMillis, isClearWarningsCalled, resetCancelledState, setCancelStatus, setClearWarningsCalled, setCurrentDatabase, setExecuteTime, setResultFetchSize, setResultType, setTimeoutInMillis, startQueryTimer, stopQueryTimer

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.mysql.cj.Query

addBatch, checkCancelTimeout, clearBatchedArgs, getBatchedArgs, getCancelTimeoutMutex, getCurrentDatabase, getExecuteTime, getId, getQueryAttributesBindings, getResultFetchSize, getResultSetFactory, getResultType, getSession, getStatementExecuting, getTimeoutInMillis, isClearWarningsCalled, resetCancelledState, setCancelStatus, setClearWarningsCalled, setCurrentDatabase, setExecuteTime, setResultFetchSize, setResultType, setTimeoutInMillis, startQueryTimer, stopQueryTimer

Field Detail

BLOB_STREAM_READ_BUF_SIZE

public static final int BLOB_STREAM_READ_BUF_SIZE

See Also:

Constant Field Values

OPEN_CURSOR_FLAG

public static final byte OPEN_CURSOR_FLAG

See Also:

Constant Field Values

PARAMETER_COUNT_AVAILABLE

public static final byte PARAMETER_COUNT_AVAILABLE

See Also:

Constant Field Values

profileSQL

protected boolean profileSQL

The "profileSQL" connection property value

gatherPerfMetrics

protected boolean gatherPerfMetrics

The "gatherPerfMetrics" connection property value

logSlowQueries

protected boolean logSlowQueries

The "logSlowQueries" connection property value

slowQueryThresholdMillis

protected RuntimeProperty<java.lang.Integer> slowQueryThresholdMillis

explainSlowQueries

protected RuntimeProperty<java.lang.Boolean> explainSlowQueries

useCursorFetch

protected boolean useCursorFetch

queryWasSlow

protected boolean queryWasSlow

commandBuilder

protected NativeMessageBuilder commandBuilder

Constructor Detail

ServerPreparedQuery

protected ServerPreparedQuery(NativeSession sess)

Method Detail

getInstance

public static ServerPreparedQuery getInstance(NativeSession sess)

serverPrepare

public void serverPrepare(java.lang.String sql)
                   throws java.io.IOException

Parameters:

sql - query string

Throws:

java.io.IOException - if an i/o error occurs

statementBegins

public void statementBegins()

Specified by:

statementBegins in interface Query

Overrides:

statementBegins in class AbstractQuery

serverExecute

public <T extends Resultset> T serverExecute(int maxRowsToRetrieve,
                                             boolean createStreamingResultSet,
                                             ColumnDefinition metadata,
                                             ProtocolEntityFactory<T,NativePacketPayload> resultSetFactory)

Type Parameters:

T - extends Resultset

Parameters:

maxRowsToRetrieve - rows limit

createStreamingResultSet - should c/J create a streaming result?

metadata - use this metadata instead of the one provided on wire

resultSetFactory - ProtocolEntityFactory

Returns:

T instance

prepareExecutePacket

public NativePacketPayload prepareExecutePacket()

sendExecutePacket

public NativePacketPayload sendExecutePacket(NativePacketPayload packet,
                                             java.lang.String queryAsString)

readExecuteResult

public <T extends Resultset> T readExecuteResult(NativePacketPayload resultPacket,
                                                 int maxRowsToRetrieve,
                                                 boolean createStreamingResultSet,
                                                 ColumnDefinition metadata,
                                                 ProtocolEntityFactory<T,NativePacketPayload> resultSetFactory,
                                                 java.lang.String queryAsString)

closeQuery

public void closeQuery()

Specified by:

closeQuery in interface Query

Overrides:

closeQuery in class ClientPreparedQuery

getServerStatementId

public long getServerStatementId()

setServerStatementId

public void setServerStatementId(long serverStatementId)

getParameterFields

public Field[] getParameterFields()

setParameterFields

public void setParameterFields(Field[] parameterFields)

getResultFields

public ColumnDefinition getResultFields()

setResultFields

public void setResultFields(ColumnDefinition resultFields)

clearParameters

public void clearParameters(boolean clearServerParameters)

Parameters:

clearServerParameters - flag indicating whether we need an additional clean up

serverResetStatement

public void serverResetStatement()

computeMaxParameterSetSizeAndBatchSize

protected long[] computeMaxParameterSetSizeAndBatchSize(int numBatchedArgs)

Computes the maximum parameter set size and the size of the entire batch given the number of arguments in the batch.

Overrides:

computeMaxParameterSetSizeAndBatchSize in class ClientPreparedQuery

Parameters:

numBatchedArgs - number of batched arguments

Returns:

new long[] { maxSizeOfParameterSet, sizeOfEntireBatch }

fillSendPacket

public <M extends Message> M fillSendPacket(QueryBindings bindings)

Specified by:

fillSendPacket in interface PreparedQuery

Overrides:

fillSendPacket in class ClientPreparedQuery