Class EmbedCallableStatement
java.lang.Object
org.apache.derby.impl.jdbc.ConnectionChild
org.apache.derby.impl.jdbc.EmbedStatement
org.apache.derby.impl.jdbc.EmbedPreparedStatement
org.apache.derby.impl.jdbc.EmbedCallableStatement
- All Implemented Interfaces:
AutoCloseable, CallableStatement, PreparedStatement, Statement, Wrapper, EngineCallableStatement, EnginePreparedStatement, EngineStatement
- Direct Known Subclasses:
EmbedCallableStatement42
public class EmbedCallableStatement
extends EmbedPreparedStatement
implements EngineCallableStatement
Local implementation.
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate booleanprotected booleanFields inherited from class EmbedPreparedStatement
preparedStatement, rMetaDataFields inherited from class EmbedStatement
applicationStatement, batchStatements, isPoolable, lcc, MaxFieldSize, maxRows, results, resultSetConcurrency, resultSetType, SQLText, timeoutMillis, updateCountFields inherited from class ConnectionChild
factory, localConnFields inherited from interface Statement
CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO -
Constructor Summary
ConstructorsConstructorDescriptionEmbedCallableStatement(EmbedConnection conn, String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) -
Method Summary
Modifier and TypeMethodDescriptionvoidaddBatch()JDBC 2.0 Add a set of parameters to the batch.protected voidcheckRequiresCallableStatement(Activation activation) Check to see if a statement requires to be executed via a callable statement.protected final booleanexecuteStatement(Activation a, boolean executeQuery, boolean executeUpdate) Execute the current statement.final ArraygetArray(int i) JDBC 2.0 Get an Array OUT parameter.final ArrayJDBC 3.0 Retrieves the value of a JDBC ARRAY parameter as an Array object in the Java programming language.final BigDecimalgetBigDecimal(int parameterIndex) JDBC 2.0 Get the value of a NUMERIC parameter as a java.math.BigDecimal object.final BigDecimalgetBigDecimal(int parameterIndex, int scale) Deprecated.final BigDecimalgetBigDecimal(String parameterName) JDBC 3.0 Retrieves the value of a JDBC NUMERIC parameter as a java.math.BigDecimal object with as many digits to the right of the decimal point as the value containsprivate InputStreamgetBinaryStream(int parameterIndex) Get binary stream for a parameter.getBlob(int parameterIndex) JDBC 2.0 Get a BLOB OUT parameter.final BlobJDBC 3.0 Retrieves the value of a JDBC BLOB parameter as a Blob object in the Java programming language.booleangetBoolean(int parameterIndex) final booleangetBoolean(String parameterName) JDBC 3.0 Retrieves the value of a JDBC BIT parameter as a boolean in the Java programming language.bytegetByte(int parameterIndex) final byteJDBC 3.0 Retrieves the value of a JDBC TINYINT parameter as a byte in the Java programming language.byte[]getBytes(int parameterIndex) final byte[]JDBC 3.0 Retrieves the value of a JDBC BINARY or VARBINARY parameter as an array of byte values in the Java programming language.final ReadergetCharacterStream(int parameterIndex) Retrieves the value of the designated parameter as ajava.io.Readerobject in the Java programming language.final ReadergetCharacterStream(String parameterName) getClob(int parameterIndex) JDBC 2.0 Get a CLOB OUT parameter.final ClobJDBC 3.0 Retrieves the value of a JDBC CLOB parameter as a Clob object in the Java programming language.getDate(int parameterIndex) Get the value of a SQL DATE parameter as a java.sql.Date objectfinal DateJDBC 3.0 Retrieves the value of a JDBC DATE parameter as a java.sql.Date objectfinal DateJDBC 3.0 Retrieves the value of a JDBC DATE parameter as a java.sql.Date object, using the given Calendar object to construct the date object.doublegetDouble(int parameterIndex) final doubleJDBC 3.0 Retrieves the value of a JDBC DOUBLE parameter as a double in the Java programming language.floatgetFloat(int parameterIndex) final floatJDBC 3.0 Retrieves the value of a JDBC FLOAT parameter as a float in the Java programming language.intgetInt(int parameterIndex) final intJDBC 3.0 Retrieves the value of a JDBC INTEGER parameter as a int in the Java programming language.longgetLong(int parameterIndex) final longJDBC 3.0 Retrieves the value of a JDBC BIGINT parameter as a long in the Java programming language.final ReadergetNCharacterStream(int parameterIndex) final ReadergetNCharacterStream(String parameterName) final NClobgetNClob(int i) final NClobfinal StringgetNString(int parameterIndex) final StringgetNString(String parameterName) final ObjectgetObject(int parameterIndex) final <T> T/////////////////////////////////////////////////////////////////final ObjectJDBC 2.0 Returns an object representing the value of OUT parameteri.final ObjectJDBC 3.0 Retrieves the value of a parameter as an Object in the java programming language.final <T> Tfinal ObjectJDBC 3.0 Returns an object representing the value of OUT parameter i and uses map for the custom mapping of the parameter value.final RefgetRef(int i) JDBC 2.0 Get a REF(<structured-type>) OUT parameter.final RefJDBC 3.0 Retrieves the value of a JDBC REF (structured-type) parameter as a Ref object in the Java programming language.final RowIdgetRowId(int parameterIndex) final RowIdshortgetShort(int parameterIndex) final shortJDBC 3.0 Retrieves the value of a JDBC SMALLINT parameter as a short in the Java programming language.final SQLXMLgetSQLXML(int parameterIndex) final SQLXMLgetString(int parameterIndex) final StringJDBC 3.0 Retrieves the value of a JDBC CHAR, VARCHAR, or LONGVARCHAR parameter as a String in the Java programming language.getTime(int parameterIndex) Get the value of a SQL TIME parameter as a java.sql.Time object.final TimeJDBC 3.0 Retrieves the value of a JDBC TIME parameter as ajava.sql.Time objectfinal TimeJDBC 3.0 Retrieves the value of a JDBC TIME parameter as a java.sql.Time object, using the given Calendar object to construct the time object.getTimestamp(int parameterIndex) Get the value of a SQL TIMESTAMP parameter as a java.sql.Timestamp object.getTimestamp(int parameterIndex, Calendar cal) final TimestampgetTimestamp(String parameterName) JDBC 3.0 Retrieves the value of a JDBC TIMESTAMP parameter as a java.sql.Timestamp objectfinal TimestampgetTimestamp(String parameterName, Calendar cal) JDBC 3.0 Retrieves the value of a JDBC TIMESTAMP parameter as a java.sql.Timestamp object, using the given Calendar object to construct the Timestamp object.getURL(int parameterIndex) JDBC 3.0 Retrieve the value of the designated JDBC DATALINK parameter as a java.net.URL objectJDBC 3.0 Retrieves the value of a JDBC DATALINK parameter as a java.net.URL objectprivate SQLExceptionmismatchException(String targetTypeName, int parameterIndex) final voidregisterOutParameter(int parameterIndex, int sqlType) final voidregisterOutParameter(int parameterIndex, int sqlType, int scale) voidregisterOutParameter(int parameterIndex, int sqlType, String typeName) JDBC 2.0 Derby ignores the typeName argument because UDTs don't need it.final voidregisterOutParameter(String parameterName, int sqlType) JDBC 3.0 Registers the OUT parameter named parameterName to the JDBC type sqlType.final voidregisterOutParameter(String parameterName, int sqlType, int scale) JDBC 3.0 Registers the parameter named parameterName to the JDBC type sqlType.final voidregisterOutParameter(String parameterName, int sqlType, String typeName) JDBC 3.0 Registers the designated output parameter.final voidsetAsciiStream(String parameterName, InputStream x) final voidsetAsciiStream(String parameterName, InputStream x, int length) JDBC 3.0 Sets the designated parameter to the given input stream, which will have the specified number of bytes.final voidsetAsciiStream(String parameterName, InputStream x, long length) Sets the designated parameter to the given input stream, which will have the specified number of bytes.final voidsetBigDecimal(String parameterName, BigDecimal x) JDBC 3.0 Sets the designated parameter to the given java.math.BigDecimal value.final voidsetBinaryStream(String parameterName, InputStream x) final voidsetBinaryStream(String parameterName, InputStream x, int length) JDBC 3.0 Sets the designated parameter to the given input stream, which will have the specified number of bytes.final voidsetBinaryStream(String parameterName, InputStream x, long length) Sets the designated parameter to the given input stream, which will have the specified number of bytes.final voidsetBlob(String parameterName, InputStream inputStream) final voidsetBlob(String parameterName, InputStream inputStream, long length) final voidfinal voidsetBoolean(String parameterName, boolean x) JDBC 3.0 Sets the designated parameter to the given Java boolean value.final voidJDBC 3.0 Sets the designated parameter to the given Java byte value.final voidJDBC 3.0 Sets the designated parameter to the given Java array of bytes.final voidsetCharacterStream(String parameterName, Reader reader) final voidsetCharacterStream(String parameterName, Reader reader, int length) JDBC 3.0 Sets the designated parameter to the given Reader object, which is the given number of characters long.final voidsetCharacterStream(String parameterName, Reader x, long length) Sets the designated parameter to the given Reader, which will have the specified number of bytes.final voidfinal voidfinal voidfinal voidJDBC 3.0 Sets the designated parameter to the given java.sql.Date value.final voidJDBC 3.0 Sets the designated parameter to the given java.sql.Date value, using the given Calendar object.final voidJDBC 3.0 Sets the designated parameter to the given Java double value.final voidJDBC 3.0 Sets the designated parameter to the given Java float value.final voidJDBC 3.0 Sets the designated parameter to the given Java int value.final voidJDBC 3.0 Sets the designated parameter to the given Java long value.final voidsetNCharacterStream(String parameterName, Reader value) final voidsetNCharacterStream(String parameterName, Reader value, long length) final voidfinal voidfinal voidfinal voidsetNString(String parameterName, String value) final voidJDBC 3.0 Sets the designated parameter to SQL NULL.final voidJDBC 3.0 Sets the designated parameter to SQL NULL.final voidJDBC 3.0 Sets the value of the designated parameter with the given object.final voidJDBC 3.0 Sets the value of the designated parameter with the given object.final voidJDBC 3.0 Sets the value of the designated parameter with the given object.final voidfinal voidJDBC 3.0 Sets the designated parameter to the given Java short value.final voidfinal voidJDBC 3.0 Sets the designated parameter to the given Java String value.final voidJDBC 3.0 Sets the designated parameter to the given java.sql.Time value.final voidJDBC 3.0 Sets the designated parameter to the given java.sql.Time value using the Calendar objectfinal voidsetTimestamp(String parameterName, Timestamp x) JDBC 3.0 Sets the designated parameter to the given java.sql.Timestamp value.final voidsetTimestamp(String parameterName, Timestamp x, Calendar cal) JDBC 3.0 Sets the designated parameter to the given java.sql.Timestamp value, using the given Calendar objectvoidJDBC 3.0 Sets the designated parameter to the given java.net.URL object.booleanwasNull()Methods inherited from class EmbedPreparedStatement
addBatch, clearParameters, closeActions, dataTypeConversion, execute, execute, execute, execute, execute, executeBatchElement, executeLargeUpdate, executeQuery, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, executeUpdate, finalize, getMetaData, getParameterJDBCType, getParameterMetaData, getParameterSQLType, getParms, getVersionCounter, newEmbedResultSetMetaData, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setBigDecimal, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setBlob, setBlob, setBoolean, setBrokeredConnectionControl, setByte, setBytes, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setDate, setDate, setDouble, setFloat, setInt, setLong, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNString, setNull, setNull, setObject, setObject, setObject, setRef, setRowId, setShort, setSQLXML, setString, setTime, setTime, setTimestamp, setTimestamp, setUnicodeStream, setURL, toString, transferParametersMethods inherited from class EmbedStatement
addWarning, cancel, checkExecStatus, checkIfInMiddleOfBatch, checkStatus, clearBatch, clearResultSets, clearWarnings, close, closeMeOnCompletion, closeOnCompletion, executeBatch, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getLargeMaxRows, getLargeUpdateCount, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getParameterValueSet, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getSQLText, getUpdateCount, getWarnings, isClosed, isCloseOnCompletion, isPoolable, isWrapperFor, processDynamicResult, resultSetClosing, setApplicationStatement, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeout, transferBatch, unwrapMethods inherited from class ConnectionChild
commitIfAutoCommit, commitIfNeeded, getCal, getConnectionSynchronization, getEmbedConnection, getLanguageConnectionContext, getLCC, handleException, needCommit, newSQLException, restoreContextStack, restoreIntrFlagIfSeen, setupContextStackMethods inherited from class Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, waitMethods inherited from interface CallableStatement
registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, setObject, setObjectMethods inherited from interface EngineStatement
closeOnCompletion, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, getLargeMaxRows, getLargeUpdateCount, isCloseOnCompletion, setLargeMaxRowsMethods inherited from interface PreparedStatement
clearParameters, execute, executeQuery, executeUpdate, getMetaData, getParameterMetaData, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setBigDecimal, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setBlob, setBlob, setBoolean, setByte, setBytes, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setDate, setDate, setDouble, setFloat, setInt, setLong, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNString, setNull, setNull, setObject, setObject, setObject, setObject, setObject, setRef, setRowId, setShort, setSQLXML, setString, setTime, setTime, setTimestamp, setTimestamp, setUnicodeStream, setURLMethods inherited from interface Statement
addBatch, cancel, clearBatch, clearWarnings, close, enquoteIdentifier, enquoteLiteral, enquoteNCharLiteral, execute, execute, execute, execute, executeBatch, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isClosed, isPoolable, isSimpleIdentifier, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeoutMethods inherited from interface Wrapper
isWrapperFor, unwrap
-
Field Details
-
hasReturnOutputParameter
private boolean hasReturnOutputParameter -
wasNull
protected boolean wasNull
-
-
Constructor Details
-
EmbedCallableStatement
public EmbedCallableStatement(EmbedConnection conn, String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException - Throws:
SQLException- thrown on failure
-
-
Method Details
-
checkRequiresCallableStatement
Description copied from class:EmbedStatementCheck to see if a statement requires to be executed via a callable statement.- Overrides:
checkRequiresCallableStatementin classEmbedStatement
-
executeStatement
protected final boolean executeStatement(Activation a, boolean executeQuery, boolean executeUpdate) throws SQLException Description copied from class:EmbedStatementExecute the current statement.- Overrides:
executeStatementin classEmbedPreparedStatement- Throws:
SQLException- thrown on failure.
-
registerOutParameter
- Specified by:
registerOutParameterin interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
registerOutParameter
public final void registerOutParameter(int parameterIndex, int sqlType, int scale) throws SQLException - Specified by:
registerOutParameterin interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
registerOutParameter
public void registerOutParameter(int parameterIndex, int sqlType, String typeName) throws SQLException JDBC 2.0 Derby ignores the typeName argument because UDTs don't need it.- Specified by:
registerOutParameterin interfaceCallableStatement- Throws:
SQLException- if a database-access error occurs.
-
wasNull
- Specified by:
wasNullin interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
getString
- Specified by:
getStringin interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
getBoolean
- Specified by:
getBooleanin interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
getByte
- Specified by:
getBytein interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
getShort
- Specified by:
getShortin interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
getInt
- Specified by:
getIntin interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
getLong
- Specified by:
getLongin interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
getBigDecimal
JDBC 2.0 Get the value of a NUMERIC parameter as a java.math.BigDecimal object.- Specified by:
getBigDecimalin interfaceCallableStatement- Parameters:
parameterIndex- the first parameter is 1, the second is 2, ...- Returns:
- the parameter value (full precision); if the value is SQL NULL, the result is null
- Throws:
SQLException- if a database-access error occurs.
-
getBigDecimal
Deprecated.- Specified by:
getBigDecimalin interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
getFloat
- Specified by:
getFloatin interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
getDouble
- Specified by:
getDoublein interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
getBytes
- Specified by:
getBytesin interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
getDate
- Specified by:
getDatein interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
getTime
- Specified by:
getTimein interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
getTimestamp
- Specified by:
getTimestampin interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
getDate
Get the value of a SQL DATE parameter as a java.sql.Date object- Specified by:
getDatein interfaceCallableStatement- Parameters:
parameterIndex- the first parameter is 1, the second is 2, ...- Returns:
- the parameter value; if the value is SQL NULL, the result is null
- Throws:
SQLException- if a database-access error occurs.
-
getTime
Get the value of a SQL TIME parameter as a java.sql.Time object.- Specified by:
getTimein interfaceCallableStatement- Parameters:
parameterIndex- the first parameter is 1, the second is 2, ...- Returns:
- the parameter value; if the value is SQL NULL, the result is null
- Throws:
SQLException- if a database-access error occurs.
-
getTimestamp
Get the value of a SQL TIMESTAMP parameter as a java.sql.Timestamp object.- Specified by:
getTimestampin interfaceCallableStatement- Parameters:
parameterIndex- the first parameter is 1, the second is 2, ...- Returns:
- the parameter value; if the value is SQL NULL, the result is null
- Throws:
SQLException- if a database-access error occurs.
-
getObject
- Specified by:
getObjectin interfaceCallableStatement- Throws:
SQLException- NoOutputParameters thrown.- See Also:
-
getURL
JDBC 3.0 Retrieve the value of the designated JDBC DATALINK parameter as a java.net.URL object- Specified by:
getURLin interfaceCallableStatement- Parameters:
parameterIndex- - the first parameter is 1, the second is 2- Returns:
- a java.net.URL object that represents the JDBC DATALINK value used as the designated parameter
- Throws:
SQLException- Feature not implemented for now.
-
setURL
JDBC 3.0 Sets the designated parameter to the given java.net.URL object. The driver converts this to an SQL DATALINK value when it sends it to the database.- Specified by:
setURLin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterval- - the parameter value- Throws:
SQLException- Feature not implemented for now.
-
getURL
JDBC 3.0 Retrieves the value of a JDBC DATALINK parameter as a java.net.URL object- Specified by:
getURLin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value. If the value is SQL NULL, the result is null.
- Throws:
SQLException- Feature not implemented for now.
-
getBlob
JDBC 2.0 Get a BLOB OUT parameter.- Specified by:
getBlobin interfaceCallableStatement- Parameters:
parameterIndex- the first parameter is 1, the second is 2, ...- Returns:
- an object representing a BLOB
- Throws:
SQLException- if a database-access error occurs.
-
getClob
JDBC 2.0 Get a CLOB OUT parameter.- Specified by:
getClobin interfaceCallableStatement- Parameters:
parameterIndex- the first parameter is 1, the second is 2, ...- Returns:
- an object representing a CLOB
- Throws:
SQLException- if a database-access error occurs.
-
addBatch
Description copied from class:EmbedPreparedStatementJDBC 2.0 Add a set of parameters to the batch.- Specified by:
addBatchin interfacePreparedStatement- Overrides:
addBatchin classEmbedPreparedStatement- Throws:
SQLException- if a database-access error occurs.
-
getObject
JDBC 2.0 Returns an object representing the value of OUT parameteri. Use the map to determine the class from which to construct data of SQL structured and distinct types.- Specified by:
getObjectin interfaceCallableStatement- Parameters:
i- the first parameter is 1, the second is 2, ...map- the mapping from SQL type names to Java classes- Returns:
- a java.lang.Object holding the OUT parameter value.
- Throws:
SQLException- if a database-access error occurs.
-
getRef
JDBC 2.0 Get a REF(<structured-type>) OUT parameter.- Specified by:
getRefin interfaceCallableStatement- Parameters:
i- the first parameter is 1, the second is 2, ...- Returns:
- an object representing data of an SQL REF Type
- Throws:
SQLException- if a database-access error occurs.
-
getArray
JDBC 2.0 Get an Array OUT parameter.- Specified by:
getArrayin interfaceCallableStatement- Parameters:
i- the first parameter is 1, the second is 2, ...- Returns:
- an object representing an SQL array
- Throws:
SQLException- if a database-access error occurs.
-
registerOutParameter
JDBC 3.0 Registers the OUT parameter named parameterName to the JDBC type sqlType. All OUT parameters must be registered before a stored procedure is executed.- Specified by:
registerOutParameterin interfaceCallableStatement- Parameters:
parameterName- - the name of the parametersqlType- - the JDBC type code defined by java.sql.Types. If the parameter is of JDBC type NUMERIC or DECIMAL, the version of registerOutParameter that accepts a scale value should be used.- Throws:
SQLException- Feature not implemented for now.
-
registerOutParameter
public final void registerOutParameter(String parameterName, int sqlType, String typeName) throws SQLException JDBC 3.0 Registers the designated output parameter. This version of the method registerOutParameter should be used for a user-named or REF output parameter.- Specified by:
registerOutParameterin interfaceCallableStatement- Parameters:
parameterName- - the name of the parametersqlType- - the SQL type code defined by java.sql.Types.typeName- - the fully-qualified name of an SQL structure type- Throws:
SQLException- Feature not implemented for now.
-
registerOutParameter
public final void registerOutParameter(String parameterName, int sqlType, int scale) throws SQLException JDBC 3.0 Registers the parameter named parameterName to the JDBC type sqlType. This method must be called before a stored procedure is executed.- Specified by:
registerOutParameterin interfaceCallableStatement- Parameters:
parameterName- - the name of the parametersqlType- - the SQL type code defined by java.sql.Types.scale- - the desired number of digits to the right of the decimal point. It must be greater than or equal to zero.- Throws:
SQLException- Feature not implemented for now.
-
getRef
JDBC 3.0 Retrieves the value of a JDBC REF (structured-type) parameter as a Ref object in the Java programming language.- Specified by:
getRefin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value as a Ref object in the Java Programming language. If the value is SQL NULL, the result is null.
- Throws:
SQLException- Feature not implemented for now.
-
getBlob
JDBC 3.0 Retrieves the value of a JDBC BLOB parameter as a Blob object in the Java programming language.- Specified by:
getBlobin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value as a Blob object in the Java Programming language. If the value is SQL NULL, the result is null.
- Throws:
SQLException- Feature not implemented for now.
-
getClob
JDBC 3.0 Retrieves the value of a JDBC CLOB parameter as a Clob object in the Java programming language.- Specified by:
getClobin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value as a Clob object in the Java Programming language. If the value is SQL NULL, the result is null.
- Throws:
SQLException- Feature not implemented for now.
-
getArray
JDBC 3.0 Retrieves the value of a JDBC ARRAY parameter as an Array object in the Java programming language.- Specified by:
getArrayin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value as a Array object in the Java Programming language. If the value is SQL NULL, the result is null.
- Throws:
SQLException- Feature not implemented for now.
-
setNull
JDBC 3.0 Sets the designated parameter to SQL NULL.- Specified by:
setNullin interfaceCallableStatement- Parameters:
parameterName- - the name of the parametersqlType- - the SQL type code defined in java.sql.Types- Throws:
SQLException- Feature not implemented for now.
-
setNull
JDBC 3.0 Sets the designated parameter to SQL NULL.- Specified by:
setNullin interfaceCallableStatement- Parameters:
parameterName- - the name of the parametersqlType- - the SQL type code defined in java.sql.TypestypeName- - the fully-qualified name of an SQL user-defined type- Throws:
SQLException- Feature not implemented for now.
-
setBoolean
JDBC 3.0 Sets the designated parameter to the given Java boolean value. The driver converts this to an SQL BIT value when it sends it to the database.- Specified by:
setBooleanin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter value- Throws:
SQLException- Feature not implemented for now.
-
getBoolean
JDBC 3.0 Retrieves the value of a JDBC BIT parameter as a boolean in the Java programming language.- Specified by:
getBooleanin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value. If the value is SQL NULL, the result is false.
- Throws:
SQLException- Feature not implemented for now.
-
setByte
JDBC 3.0 Sets the designated parameter to the given Java byte value. The driver converts this to an SQL TINYINT value when it sends it to the database.- Specified by:
setBytein interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter value- Throws:
SQLException- Feature not implemented for now.
-
getByte
JDBC 3.0 Retrieves the value of a JDBC TINYINT parameter as a byte in the Java programming language.- Specified by:
getBytein interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value. If the value is SQL NULL, the result is 0.
- Throws:
SQLException- Feature not implemented for now.
-
setShort
JDBC 3.0 Sets the designated parameter to the given Java short value. The driver converts this to an SQL SMALLINT value when it sends it to the database.- Specified by:
setShortin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter value- Throws:
SQLException- Feature not implemented for now.
-
getShort
JDBC 3.0 Retrieves the value of a JDBC SMALLINT parameter as a short in the Java programming language.- Specified by:
getShortin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value. If the value is SQL NULL, the result is 0.
- Throws:
SQLException- Feature not implemented for now.
-
setInt
JDBC 3.0 Sets the designated parameter to the given Java int value. The driver converts this to an SQL INTEGER value when it sends it to the database.- Specified by:
setIntin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter value- Throws:
SQLException- Feature not implemented for now.
-
getInt
JDBC 3.0 Retrieves the value of a JDBC INTEGER parameter as a int in the Java programming language.- Specified by:
getIntin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value. If the value is SQL NULL, the result is 0.
- Throws:
SQLException- Feature not implemented for now.
-
setLong
JDBC 3.0 Sets the designated parameter to the given Java long value. The driver converts this to an SQL BIGINT value when it sends it to the database.- Specified by:
setLongin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter value- Throws:
SQLException- Feature not implemented for now.
-
getLong
JDBC 3.0 Retrieves the value of a JDBC BIGINT parameter as a long in the Java programming language.- Specified by:
getLongin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value. If the value is SQL NULL, the result is 0.
- Throws:
SQLException- Feature not implemented for now.
-
setFloat
JDBC 3.0 Sets the designated parameter to the given Java float value. The driver converts this to an SQL FLOAT value when it sends it to the database.- Specified by:
setFloatin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter value- Throws:
SQLException- Feature not implemented for now.
-
getFloat
JDBC 3.0 Retrieves the value of a JDBC FLOAT parameter as a float in the Java programming language.- Specified by:
getFloatin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value. If the value is SQL NULL, the result is 0.
- Throws:
SQLException- Feature not implemented for now.
-
setDouble
JDBC 3.0 Sets the designated parameter to the given Java double value. The driver converts this to an SQL DOUBLE value when it sends it to the database.- Specified by:
setDoublein interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter value- Throws:
SQLException- Feature not implemented for now.
-
getDouble
JDBC 3.0 Retrieves the value of a JDBC DOUBLE parameter as a double in the Java programming language.- Specified by:
getDoublein interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value. If the value is SQL NULL, the result is 0.
- Throws:
SQLException- Feature not implemented for now.
-
setBigDecimal
JDBC 3.0 Sets the designated parameter to the given java.math.BigDecimal value. The driver converts this to an SQL NUMERIC value when it sends it to the database.- Specified by:
setBigDecimalin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter value- Throws:
SQLException- Feature not implemented for now.
-
getBigDecimal
JDBC 3.0 Retrieves the value of a JDBC NUMERIC parameter as a java.math.BigDecimal object with as many digits to the right of the decimal point as the value contains- Specified by:
getBigDecimalin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value. If the value is SQL NULL, the result is 0.
- Throws:
SQLException- Feature not implemented for now.
-
setString
JDBC 3.0 Sets the designated parameter to the given Java String value. The driver converts this to an SQL VARCHAR OR LONGVARCHAR value (depending on the argument's size relative the driver's limits on VARCHAR values) when it sends it to the database.- Specified by:
setStringin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter value- Throws:
SQLException- Feature not implemented for now.
-
getString
JDBC 3.0 Retrieves the value of a JDBC CHAR, VARCHAR, or LONGVARCHAR parameter as a String in the Java programming language.- Specified by:
getStringin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value. If the value is SQL NULL, the result is null.
- Throws:
SQLException- Feature not implemented for now.
-
setBytes
JDBC 3.0 Sets the designated parameter to the given Java array of bytes. The driver converts this to an SQL VARBINARY OR LONGVARBINARY (depending on the argument's size relative to the driver's limits on VARBINARY values)when it sends it to the database.- Specified by:
setBytesin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter value- Throws:
SQLException- Feature not implemented for now.
-
getBytes
JDBC 3.0 Retrieves the value of a JDBC BINARY or VARBINARY parameter as an array of byte values in the Java programming language.- Specified by:
getBytesin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value. If the value is SQL NULL, the result is null.
- Throws:
SQLException- Feature not implemented for now.
-
setDate
JDBC 3.0 Sets the designated parameter to the given java.sql.Date value. The driver converts this to an SQL DATE value when it sends it to the database.- Specified by:
setDatein interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter value- Throws:
SQLException- Feature not implemented for now.
-
setDate
JDBC 3.0 Sets the designated parameter to the given java.sql.Date value, using the given Calendar object.- Specified by:
setDatein interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter valuecal- - the Calendar object the driver will use to construct the date- Throws:
SQLException- Feature not implemented for now.
-
getDate
JDBC 3.0 Retrieves the value of a JDBC DATE parameter as a java.sql.Date object- Specified by:
getDatein interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value. If the value is SQL NULL, the result is null.
- Throws:
SQLException- Feature not implemented for now.
-
getDate
JDBC 3.0 Retrieves the value of a JDBC DATE parameter as a java.sql.Date object, using the given Calendar object to construct the date object.- Specified by:
getDatein interfaceCallableStatement- Parameters:
parameterName- - the name of the parametercal- - the Calendar object the driver will use to construct the date- Returns:
- the parameter value. If the value is SQL NULL, the result is null.
- Throws:
SQLException- Feature not implemented for now.
-
setTime
JDBC 3.0 Sets the designated parameter to the given java.sql.Time value. The driver converts this to an SQL TIME value when it sends it to the database.- Specified by:
setTimein interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter value- Throws:
SQLException- Feature not implemented for now.
-
getTime
JDBC 3.0 Retrieves the value of a JDBC TIME parameter as ajava.sql.Time object- Specified by:
getTimein interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value. If the value is SQL NULL, the result is null.
- Throws:
SQLException- Feature not implemented for now.
-
getTime
JDBC 3.0 Retrieves the value of a JDBC TIME parameter as a java.sql.Time object, using the given Calendar object to construct the time object.- Specified by:
getTimein interfaceCallableStatement- Parameters:
parameterName- - the name of the parametercal- - the Calendar object the driver will use to construct the time- Returns:
- the parameter value. If the value is SQL NULL, the result is null.
- Throws:
SQLException- Feature not implemented for now.
-
setTime
JDBC 3.0 Sets the designated parameter to the given java.sql.Time value using the Calendar object- Specified by:
setTimein interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter valuecal- - the Calendar object the driver will use to construct the time- Throws:
SQLException- Feature not implemented for now.
-
setTimestamp
JDBC 3.0 Sets the designated parameter to the given java.sql.Timestamp value. The driver converts this to an SQL TIMESTAMP value when it sends it to the database.- Specified by:
setTimestampin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter value- Throws:
SQLException- Feature not implemented for now.
-
setTimestamp
JDBC 3.0 Sets the designated parameter to the given java.sql.Timestamp value, using the given Calendar object- Specified by:
setTimestampin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the parameter valuecal- - the Calendar object the driver will use to construct the timestamp.- Throws:
SQLException- Feature not implemented for now.
-
getTimestamp
JDBC 3.0 Retrieves the value of a JDBC TIMESTAMP parameter as a java.sql.Timestamp object- Specified by:
getTimestampin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- the parameter value. If the value is SQL NULL, the result is null.
- Throws:
SQLException- Feature not implemented for now.
-
getTimestamp
JDBC 3.0 Retrieves the value of a JDBC TIMESTAMP parameter as a java.sql.Timestamp object, using the given Calendar object to construct the Timestamp object.- Specified by:
getTimestampin interfaceCallableStatement- Parameters:
parameterName- - the name of the parametercal- - the Calendar object the driver will use to construct the Timestamp- Returns:
- the parameter value. If the value is SQL NULL, the result is null.
- Throws:
SQLException- Feature not implemented for now.
-
setAsciiStream
public final void setAsciiStream(String parameterName, InputStream x, int length) throws SQLException JDBC 3.0 Sets the designated parameter to the given input stream, which will have the specified number of bytes.- Specified by:
setAsciiStreamin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the Java input stream that contains the ASCII parameter valuelength- - the number of bytes in the stream- Throws:
SQLException- Feature not implemented for now.
-
setBinaryStream
public final void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException JDBC 3.0 Sets the designated parameter to the given input stream, which will have the specified number of bytes.- Specified by:
setBinaryStreamin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the Java input stream that contains the binary parameter valuelength- - the number of bytes in the stream- Throws:
SQLException- Feature not implemented for now.
-
setCharacterStream
public final void setCharacterStream(String parameterName, Reader reader, int length) throws SQLException JDBC 3.0 Sets the designated parameter to the given Reader object, which is the given number of characters long.- Specified by:
setCharacterStreamin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterreader- - the java.io.Reader object that contains the UNICODE datalength- - the number of characters in the stream- Throws:
SQLException- Feature not implemented for now.
-
setObject
public final void setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException JDBC 3.0 Sets the value of the designated parameter with the given object. The second argument must be an object type; for integral values, the java.lang equivalent objects should be used.- Specified by:
setObjectin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the object containing the input parameter valuetargetSqlType- - the SQL type (as defined in java.sql.Types) to be sent to the database. The scale argument may further qualify this type.scale- - for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, this is the number of digits after the decimal point. For all other types, this value will be ignored.- Throws:
SQLException- Feature not implemented for now.
-
getObject
JDBC 3.0 Retrieves the value of a parameter as an Object in the java programming language.- Specified by:
getObjectin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameter- Returns:
- a java.lang.Object holding the OUT parameter value
- Throws:
SQLException- Feature not implemented for now.
-
getObject
JDBC 3.0 Returns an object representing the value of OUT parameter i and uses map for the custom mapping of the parameter value.- Specified by:
getObjectin interfaceCallableStatement- Parameters:
parameterName- - the name of the parametermap- - the mapping from SQL type names to Java classes- Returns:
- a java.lang.Object holding the OUT parameter value
- Throws:
SQLException- Feature not implemented for now.
-
setObject
JDBC 3.0 Sets the value of the designated parameter with the given object. This method is like the method setObject above, except that it assumes a scale of zero.- Specified by:
setObjectin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the object containing the input parameter valuetargetSqlType- - the SQL type (as defined in java.sql.Types) to be sent to the database.- Throws:
SQLException- Feature not implemented for now.
-
setObject
JDBC 3.0 Sets the value of the designated parameter with the given object. The second parameter must be of type Object; therefore, the java.lang equivalent objects should be used for built-in types.- Specified by:
setObjectin interfaceCallableStatement- Parameters:
parameterName- - the name of the parameterx- - the object containing the input parameter value- Throws:
SQLException- Feature not implemented for now.
-
getCharacterStream
Retrieves the value of the designated parameter as ajava.io.Readerobject in the Java programming language. Introduced in JDBC 4.0.- Specified by:
getCharacterStreamin interfaceCallableStatement- Parameters:
parameterIndex- the first parameter is 1, the second is 2, ...- Returns:
- a
java.io.Readerobject that contains the parameter value; if the value is SQLNULL, the value returned isnullin the Java programming language. - Throws:
SQLException- if a database access error occurs or this method is called on a closedCallableStatement
-
getBinaryStream
Get binary stream for a parameter.- Parameters:
parameterIndex- first parameter is 1, second is 2 etc.- Returns:
- a stream for the binary parameter, or
null. - Throws:
SQLException- if a database access error occurs.
-
getCharacterStream
- Specified by:
getCharacterStreamin interfaceCallableStatement- Throws:
SQLException
-
getNCharacterStream
- Specified by:
getNCharacterStreamin interfaceCallableStatement- Throws:
SQLException
-
getNCharacterStream
- Specified by:
getNCharacterStreamin interfaceCallableStatement- Throws:
SQLException
-
getNString
- Specified by:
getNStringin interfaceCallableStatement- Throws:
SQLException
-
getNString
- Specified by:
getNStringin interfaceCallableStatement- Throws:
SQLException
-
setBlob
- Specified by:
setBlobin interfaceCallableStatement- Throws:
SQLException
-
setClob
- Specified by:
setClobin interfaceCallableStatement- Throws:
SQLException
-
getRowId
- Specified by:
getRowIdin interfaceCallableStatement- Throws:
SQLException
-
getRowId
- Specified by:
getRowIdin interfaceCallableStatement- Throws:
SQLException
-
setRowId
- Specified by:
setRowIdin interfaceCallableStatement- Throws:
SQLException
-
setNString
- Specified by:
setNStringin interfaceCallableStatement- Throws:
SQLException
-
setNCharacterStream
public final void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException - Specified by:
setNCharacterStreamin interfaceCallableStatement- Throws:
SQLException
-
setNClob
- Specified by:
setNClobin interfaceCallableStatement- Throws:
SQLException
-
setClob
- Specified by:
setClobin interfaceCallableStatement- Throws:
SQLException
-
setBlob
public final void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException - Specified by:
setBlobin interfaceCallableStatement- Throws:
SQLException
-
setNClob
- Specified by:
setNClobin interfaceCallableStatement- Throws:
SQLException
-
getNClob
- Specified by:
getNClobin interfaceCallableStatement- Throws:
SQLException
-
getNClob
- Specified by:
getNClobin interfaceCallableStatement- Throws:
SQLException
-
setSQLXML
- Specified by:
setSQLXMLin interfaceCallableStatement- Throws:
SQLException
-
getSQLXML
- Specified by:
getSQLXMLin interfaceCallableStatement- Throws:
SQLException
-
getSQLXML
- Specified by:
getSQLXMLin interfaceCallableStatement- Throws:
SQLException
-
setAsciiStream
- Specified by:
setAsciiStreamin interfaceCallableStatement- Throws:
SQLException
-
setBinaryStream
- Specified by:
setBinaryStreamin interfaceCallableStatement- Throws:
SQLException
-
setBlob
- Specified by:
setBlobin interfaceCallableStatement- Throws:
SQLException
-
setCharacterStream
- Specified by:
setCharacterStreamin interfaceCallableStatement- Throws:
SQLException
-
setClob
- Specified by:
setClobin interfaceCallableStatement- Throws:
SQLException
-
setNCharacterStream
- Specified by:
setNCharacterStreamin interfaceCallableStatement- Throws:
SQLException
-
setNClob
- Specified by:
setNClobin interfaceCallableStatement- Throws:
SQLException
-
setAsciiStream
public final void setAsciiStream(String parameterName, InputStream x, long length) throws SQLException Sets the designated parameter to the given input stream, which will have the specified number of bytes.- Specified by:
setAsciiStreamin interfaceCallableStatement- Parameters:
parameterName- the name of the first parameterx- the java input stream which contains the ASCII parameter valuelength- the number of bytes in the stream- Throws:
SQLException- thrown on failure.
-
setBinaryStream
public final void setBinaryStream(String parameterName, InputStream x, long length) throws SQLException Sets the designated parameter to the given input stream, which will have the specified number of bytes.- Specified by:
setBinaryStreamin interfaceCallableStatement- Parameters:
parameterName- the name of the first parameterx- the java input stream which contains the binary parameter valuelength- the number of bytes in the stream- Throws:
SQLException- thrown on failure.
-
setCharacterStream
public final void setCharacterStream(String parameterName, Reader x, long length) throws SQLException Sets the designated parameter to the given Reader, which will have the specified number of bytes.- Specified by:
setCharacterStreamin interfaceCallableStatement- Parameters:
parameterName- the name of the first parameterx- the java Reader which contains the UNICODE valuelength- the number of bytes in the stream- Throws:
SQLException- thrown on failure.
-
getObject
/////////////////////////////////////////////////////////////////- Specified by:
getObjectin interfaceCallableStatement- Specified by:
getObjectin interfaceEngineCallableStatement- Throws:
SQLException
-
mismatchException
private SQLException mismatchException(String targetTypeName, int parameterIndex) throws SQLException - Throws:
SQLException
-
getObject
- Specified by:
getObjectin interfaceCallableStatement- Specified by:
getObjectin interfaceEngineCallableStatement- Throws:
SQLException
-