程序包 com.mysql.cj.jdbc

类 ServerPreparedStatement

java.lang.Object

com.mysql.cj.jdbc.StatementImpl

com.mysql.cj.jdbc.ClientPreparedStatement

com.mysql.cj.jdbc.ServerPreparedStatement

所有已实现的接口:

JdbcPreparedStatement, JdbcStatement, Query, AutoCloseable, PreparedStatement, Statement, Wrapper

public class ServerPreparedStatement
extends ClientPreparedStatement

JDBC Interface for MySQL-4.1 and newer server-side PreparedStatements.

嵌套类概要

从接口继承的嵌套类/接口 com.mysql.cj.Query

Query.CancelStatus

字段概要

字段

修饰符和类型	字段	说明
protected boolean	isCacheable
protected boolean	isCached

从类继承的字段 com.mysql.cj.jdbc.ClientPreparedStatement

batchedValuesClause, batchHasPlainStatements, parameterMetaData, rewrittenBatchSize

从类继承的字段 com.mysql.cj.jdbc.StatementImpl

batchedGeneratedKeys, charEncoding, commandBuilder, connection, continueBatchOnError, doEscapeProcessing, dontCheckOnDuplicateKeyUpdateInSQL, dontTrackOpenResources, dumpQueriesOnException, exceptionInterceptor, generatedKeysResults, holdResultsOpenOverClose, isClosed, lastInsertId, lastQueryIsOnDupKeyUpdate, logSlowQueries, maxAllowedPacket, maxFieldSize, maxRows, openResults, pedantic, PING_MARKER, pingTarget, profileSQL, query, results, resultSetConcurrency, resultSetFactory, retrieveGeneratedKeys, rewriteBatchedStatements, session, updateCount, USES_VARIABLES_FALSE, USES_VARIABLES_TRUE, USES_VARIABLES_UNKNOWN, useUsageAdvisor, warningChain

从接口继承的字段 com.mysql.cj.jdbc.JdbcStatement

MAX_ROWS

从接口继承的字段 java.sql.Statement

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

构造器概要

构造器

限定符	构造器	说明
protected	ServerPreparedStatement(JdbcConnection conn, String sql, String db, int resultSetType, int resultSetConcurrency)	Creates a new ServerPreparedStatement object.

方法概要

修饰符和类型	方法	说明
void	addBatch()
protected void	checkBounds(int parameterIndex, int parameterIndexOffset)
protected JdbcConnection	checkClosed()	Checks if closed() has been called, and throws an exception if so
void	clearParameters()
void	close()	In many cases, it is desirable to immediately release a Statement's database and JDBC resources instead of waiting for this to happen when it is automatically closed.
protected boolean	containsOnDuplicateKeyUpdate()
protected long[]	executeBatchSerially(int batchTimeout)	Executes the current batch of statements by executing them one-by-one.
protected <M extends Message> ResultSetInternalMethods	executeInternal(int maxRowsToRetrieve, M sendPacket, boolean createStreamingResultSet, boolean queryIsSelectOnly, ColumnDefinition metadata, boolean isBatch)	Actually execute the prepared statement.
protected BindValue	getBinding(int parameterIndex, boolean forLongData)	Returns the structure representing the value that (can be)/(is) bound at the given parameter index.
protected static ServerPreparedStatement	getInstance(JdbcConnection conn, String sql, String db, int resultSetType, int resultSetConcurrency)	Creates a prepared statement instance
ResultSetMetaData	getMetaData()
ParameterMetaData	getParameterMetaData()
long	getServerStatementId()
protected void	initQuery()
boolean	isNull(int paramIndex)
protected ClientPreparedStatement	prepareBatchedInsertSQL(JdbcConnection localConn, int numBatches)	Returns a prepared statement for the number of batched parameters, used when re-writing batch INSERTs.
void	realClose(boolean calledExplicitly, boolean closeOpenResults)	Closes this statement, and frees resources.
protected void	rePrepare()	Used by Connection when auto-reconnecting to retrieve 'lost' prepared statements.
protected ResultSetInternalMethods	serverExecute(int maxRowsToRetrieve, boolean createStreamingResultSet, ColumnDefinition metadata)	Tells the server to execute this prepared statement with the current parameter bindings.
protected void	serverPrepare(String sql)
protected void	setClosed(boolean flag)
void	setPoolable(boolean poolable)
void	setUnicodeStream(int parameterIndex, InputStream x, int length)	已过时。
void	setURL(int parameterIndex, URL x)
String	toString()	Returns this PreparedStatement represented as a string.

从类继承的方法 com.mysql.cj.jdbc.ClientPreparedStatement

addBatch, checkReadOnlySafeStatement, clearBatch, execute, executeBatchedInserts, executeBatchInternal, executeLargeUpdate, executePreparedBatchAsMultiStatement, executeQuery, executeUpdate, executeUpdateInternal, executeUpdateInternal, getBytesRepresentation, getCoreParameterIndex, getInstance, getInstance, getParameterBindings, getParameterIndexOffset, getPreparedSql, getQueryBindings, getQueryInfo, getUpdateCount, isResultSetProducingQuery, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setBigDecimal, setBigInteger, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setBlob, setBlob, setBoolean, setByte, setBytes, setBytes, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setDate, setDate, setDouble, setFloat, setInt, setLong, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNString, setNull, setNull, setNull, setObject, setObject, setObject, setObject, setObject, setOneBatchedParameterSet, setRef, setRetrieveGeneratedKeys, setRowId, setShort, setSQLXML, setString, setTime, setTime, setTimestamp, setTimestamp

从类继承的方法 com.mysql.cj.jdbc.StatementImpl

addBatch, cancel, checkCancelTimeout, checkNullOrEmptyQuery, clearAttributes, clearBatchedArgs, clearWarnings, closeAllOpenResults, closeOnCompletion, closeQuery, containsOnDuplicateKeyInString, createStreamingResultSet, disableStreamingResults, doPingInstead, enableStreamingResults, execute, execute, execute, execute, executeBatch, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeQuery, executeSimpleNonQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, executeUpdateInternal, generatePingResultSet, getBatchedArgs, getBatchedGeneratedKeys, getBatchedGeneratedKeys, getCancelTimeoutMutex, getConnection, getCurrentDatabase, getExceptionInterceptor, getExecuteTime, getFetchDirection, getFetchSize, getGeneratedKeys, getGeneratedKeysInternal, getGeneratedKeysInternal, getId, getLargeMaxRows, getLargeUpdateCount, getLastInsertID, getLocalInfileInputStream, getLongUpdateCount, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getOpenResultSetCount, getQuery, getQueryAttributesBindings, getQueryTimeout, getResultFetchSize, getResultSet, getResultSetConcurrency, getResultSetFactory, getResultSetHoldability, getResultSetInternal, getResultSetType, getResultType, getSession, getStatementExecuting, getTimeoutInMillis, getWarnings, handleExceptionForBatch, hasDeadlockOrTimeoutRolledBackTx, implicitlyCloseAllOpenResults, isClearWarningsCalled, isClosed, isCloseOnCompletion, isNonResultSetProducingQuery, isPoolable, isResultSetProducingQuery, isWrapperFor, processMultiCountsAndKeys, removeOpenResultSet, resetCancelledState, setAttribute, setCancelStatus, setClearWarningsCalled, setCurrentDatabase, setCursorName, setEscapeProcessing, setExecuteTime, setFetchDirection, setFetchSize, setHoldResultsOpenOverClose, setLargeMaxRows, setLocalInfileInputStream, setMaxFieldSize, setMaxRows, setPingTarget, setQueryTimeout, setResultFetchSize, setResultType, setTimeoutInMillis, setupStreamingTimeout, startQueryTimer, statementBegins, stopQueryTimer, unwrap

从类继承的方法 java.lang.Object

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

从接口继承的方法 com.mysql.cj.jdbc.JdbcStatement

clearAttributes, disableStreamingResults, enableStreamingResults, getExceptionInterceptor, getLocalInfileInputStream, getOpenResultSetCount, getQuery, getResultSetInternal, removeOpenResultSet, setAttribute, setHoldResultsOpenOverClose, setLocalInfileInputStream, setPingTarget

从接口继承的方法 com.mysql.cj.Query

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

从接口继承的方法 java.sql.Statement

cancel, clearWarnings, closeOnCompletion, enquoteIdentifier, enquoteLiteral, enquoteNCharLiteral, execute, execute, execute, execute, executeBatch, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getLargeMaxRows, getLargeUpdateCount, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getWarnings, isClosed, isCloseOnCompletion, isPoolable, isSimpleIdentifier, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setQueryTimeout

从接口继承的方法 java.sql.Wrapper

isWrapperFor, unwrap

字段详细资料

isCacheable

protected boolean isCacheable

isCached

protected boolean isCached

构造器详细资料

ServerPreparedStatement

protected ServerPreparedStatement(JdbcConnection conn,
                                  String sql,
                                  String db,
                                  int resultSetType,
                                  int resultSetConcurrency)
                           throws SQLException

Creates a new ServerPreparedStatement object.

参数:

conn - the connection creating us.

sql - the SQL containing the statement to prepare.

db - the database in use when we were created.

resultSetType - ResultSet type

resultSetConcurrency - ResultSet concurrency

抛出:

SQLException - If an error occurs

方法详细资料

getInstance

protected static ServerPreparedStatement getInstance(JdbcConnection conn,
                                                     String sql,
                                                     String db,
                                                     int resultSetType,
                                                     int resultSetConcurrency)
                                              throws SQLException

Creates a prepared statement instance

参数:

conn - the connection creating us.

sql - the SQL containing the statement to prepare.

db - the database in use when we were created.

resultSetType - ResultSet type

resultSetConcurrency - ResultSet concurrency

返回:

new ServerPreparedStatement

抛出:

SQLException - If an error occurs

initQuery

protected void initQuery()

覆盖:

initQuery 在类中 ClientPreparedStatement

toString

public String toString()

从类复制的说明: ClientPreparedStatement

Returns this PreparedStatement represented as a string.

覆盖:

toString 在类中 ClientPreparedStatement

返回:

this PreparedStatement represented as a string.

addBatch

public void addBatch()
              throws SQLException

指定者:

addBatch 在接口中 PreparedStatement

覆盖:

addBatch 在类中 ClientPreparedStatement

抛出:

SQLException

checkClosed

protected JdbcConnection checkClosed()

从类复制的说明: StatementImpl

Checks if closed() has been called, and throws an exception if so

覆盖:

checkClosed 在类中 StatementImpl

返回:

connection

clearParameters

public void clearParameters()

指定者:

clearParameters 在接口中 PreparedStatement

覆盖:

clearParameters 在类中 ClientPreparedStatement

setClosed

protected void setClosed(boolean flag)

close

public void close()
           throws SQLException

从类复制的说明: StatementImpl

In many cases, it is desirable to immediately release a Statement's database and JDBC resources instead of waiting for this to happen when it is automatically closed. The close method provides this immediate release.

Note: A Statement is automatically closed when it is garbage collected. When a Statement is closed, its current ResultSet, if one exists, is also closed.

指定者:

close 在接口中 AutoCloseable

指定者:

close 在接口中 Statement

覆盖:

close 在类中 StatementImpl

抛出:

SQLException - if a database access error occurs

executeBatchSerially

protected long[] executeBatchSerially(int batchTimeout)
                               throws SQLException

从类复制的说明: ClientPreparedStatement

Executes the current batch of statements by executing them one-by-one.

覆盖:

executeBatchSerially 在类中 ClientPreparedStatement

参数:

batchTimeout - timeout for the batch execution

返回:

a list of update counts

抛出:

SQLException - if an error occurs

executeInternal

protected <M extends Message> ResultSetInternalMethods executeInternal(int maxRowsToRetrieve,
                                                                       M sendPacket,
                                                                       boolean createStreamingResultSet,
                                                                       boolean queryIsSelectOnly,
                                                                       ColumnDefinition metadata,
                                                                       boolean isBatch)
                                                                throws SQLException

从类复制的说明: ClientPreparedStatement

Actually execute the prepared statement. This is here so server-side PreparedStatements can re-use most of the code from this class.

覆盖:

executeInternal 在类中 ClientPreparedStatement

类型参数:

M - extends Message

参数:

maxRowsToRetrieve - the max number of rows to return

sendPacket - the packet to send

createStreamingResultSet - should a 'streaming' result set be created?

queryIsSelectOnly - is this query doing a SELECT?

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

isBatch - is this a batch query?

返回:

the results as a ResultSet

抛出:

SQLException - if an error occurs.

getBinding

protected BindValue getBinding(int parameterIndex,
                               boolean forLongData)
                        throws SQLException

Returns the structure representing the value that (can be)/(is) bound at the given parameter index.

参数:

parameterIndex - 1-based

forLongData - is this for a stream?

返回:

BindValue

抛出:

SQLException - if a database access error occurs or this method is called on a closed PreparedStatement

getMetaData

public ResultSetMetaData getMetaData()
                              throws SQLException

指定者:

getMetaData 在接口中 PreparedStatement

覆盖:

getMetaData 在类中 ClientPreparedStatement

抛出:

SQLException

getParameterMetaData

public ParameterMetaData getParameterMetaData()
                                       throws SQLException

指定者:

getParameterMetaData 在接口中 PreparedStatement

覆盖:

getParameterMetaData 在类中 ClientPreparedStatement

抛出:

SQLException

isNull

public boolean isNull(int paramIndex)

指定者:

isNull 在接口中 JdbcPreparedStatement

覆盖:

isNull 在类中 ClientPreparedStatement

realClose

public void realClose(boolean calledExplicitly,
                      boolean closeOpenResults)
               throws SQLException

从类复制的说明: StatementImpl

Closes this statement, and frees resources.

指定者:

realClose 在接口中 JdbcPreparedStatement

覆盖:

realClose 在类中 ClientPreparedStatement

参数:

calledExplicitly - was this called from close()?

closeOpenResults - should open result sets be closed?

抛出:

SQLException - if an error occurs

rePrepare

protected void rePrepare()

Used by Connection when auto-reconnecting to retrieve 'lost' prepared statements.

抛出:

CJException - if an error occurs.

serverExecute

protected ResultSetInternalMethods serverExecute(int maxRowsToRetrieve,
                                                 boolean createStreamingResultSet,
                                                 ColumnDefinition metadata)
                                          throws SQLException

Tells the server to execute this prepared statement with the current parameter bindings.

    -   Server gets the command 'COM_EXECUTE' to execute the
        previously         prepared query. If there is any param markers;
  then client will send the data in the following format:
 
  [COM_EXECUTE:1]
  [STMT_ID:4]
  [NULL_BITS:(param_count+7)/8)]
  [TYPES_SUPPLIED_BY_CLIENT(0/1):1]
  [[length]data]
  [[length]data] .. [[length]data].
 
  (Note: Except for string/binary types; all other types will not be
  supplied with length field)
 

参数:

maxRowsToRetrieve - rows limit

createStreamingResultSet - should c/J create a streaming result?

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

返回:

result set

抛出:

SQLException - if a database access error occurs or this method is called on a closed PreparedStatement

serverPrepare

protected void serverPrepare(String sql)
                      throws SQLException

抛出:

SQLException

checkBounds

protected void checkBounds(int parameterIndex,
                           int parameterIndexOffset)
                    throws SQLException

覆盖:

checkBounds 在类中 ClientPreparedStatement

抛出:

SQLException

setUnicodeStream

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

已过时。

指定者:

setUnicodeStream 在接口中 PreparedStatement

覆盖:

setUnicodeStream 在类中 ClientPreparedStatement

抛出:

SQLException

setURL

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

指定者:

setURL 在接口中 PreparedStatement

覆盖:

setURL 在类中 ClientPreparedStatement

抛出:

SQLException

getServerStatementId

public long getServerStatementId()

覆盖:

getServerStatementId 在类中 StatementImpl

containsOnDuplicateKeyUpdate

protected boolean containsOnDuplicateKeyUpdate()

覆盖:

containsOnDuplicateKeyUpdate 在类中 ClientPreparedStatement

prepareBatchedInsertSQL

protected ClientPreparedStatement prepareBatchedInsertSQL(JdbcConnection localConn,
                                                          int numBatches)
                                                   throws SQLException

从类复制的说明: ClientPreparedStatement

Returns a prepared statement for the number of batched parameters, used when re-writing batch INSERTs.

覆盖:

prepareBatchedInsertSQL 在类中 ClientPreparedStatement

参数:

localConn - the connection creating this statement

numBatches - number of entries in a batch

返回:

new ClientPreparedStatement

抛出:

SQLException - if a database access error occurs or this method is called on a closed PreparedStatement

setPoolable

public void setPoolable(boolean poolable)
                 throws SQLException

指定者:

setPoolable 在接口中 Statement

覆盖:

setPoolable 在类中 StatementImpl

抛出:

SQLException