Class CallableStatementWrapper40
- java.lang.Object
-
- com.sun.gjc.spi.base.StatementWrapper
-
- com.sun.gjc.spi.base.PreparedStatementWrapper
-
- com.sun.gjc.spi.base.CallableStatementWrapper
-
- com.sun.gjc.spi.jdbc40.CallableStatementWrapper40
-
- All Implemented Interfaces:
ResultSetClosedEventListener,StatementLeakListener,AutoCloseable,CallableStatement,PreparedStatement,Statement,Wrapper
public class CallableStatementWrapper40 extends CallableStatementWrapper
Wrapper for JDBC 4.0 CallableStatement
-
-
Field Summary
-
Fields inherited from class com.sun.gjc.spi.base.CallableStatementWrapper
callableStatement
-
Fields inherited from class com.sun.gjc.spi.base.PreparedStatementWrapper
preparedStatement
-
Fields inherited from class com.sun.gjc.spi.base.StatementWrapper
_logger, connection, executor, jdbcStatement, leakDetector, resultSetCount
-
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
-
-
Constructor Summary
Constructors Constructor Description CallableStatementWrapper40(Connection con, CallableStatement statement, boolean cachingEnabled)Creates a new instance of CallableStatement wrapper for JDBC 3.0
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description ResultSetexecuteQuery()Executes the SQL query in thisPreparedStatementobject and returns theResultSetobject generated by the query.ResultSetexecuteQuery(String sql)Executes the given SQL statement, which returns a singleResultSetobject.ReadergetCharacterStream(int parameterIndex)Retrieves the value of the designated parameter as ajava.io.Readerobject in the Java programming language.ReadergetCharacterStream(String parameterName)Retrieves the value of the designated parameter as ajava.io.Readerobject in the Java programming language.ResultSetgetGeneratedKeys()Retrieves any auto-generated keys created as a result of executing thisStatementobject.ReadergetNCharacterStream(int parameterIndex)Retrieves the value of the designated parameter as ajava.io.Readerobject in the Java programming language.ReadergetNCharacterStream(String parameterName)Retrieves the value of the designated parameter as ajava.io.Readerobject in the Java programming language.NClobgetNClob(int parameterIndex)Retrieves the value of the designated JDBCNCLOBparameter as ajava.sql.NClobobject in the Java programming language.NClobgetNClob(String parameterName)Retrieves the value of a JDBCNCLOBparameter as ajava.sql.NClobobject in the Java programming language.StringgetNString(int parameterIndex)Retrieves the value of the designatedNCHAR,NVARCHARorLONGNVARCHARparameter as aStringin the Java programming language.StringgetNString(String parameterName)Retrieves the value of the designatedNCHAR,NVARCHARorLONGNVARCHARparameter as aStringin the Java programming language.<T> TgetObject(int parameterIndex, Class<T> type)<T> TgetObject(String parameterName, Class<T> type)ResultSetgetResultSet()Retrieves the current result as aResultSetobject.RowIdgetRowId(int parameterIndex)Retrieves the value of the designated JDBCROWIDparameter as ajava.sql.RowIdobject.RowIdgetRowId(String parameterName)Retrieves the value of the designated JDBCROWIDparameter as ajava.sql.RowIdobject.SQLXMLgetSQLXML(int parameterIndex)Retrieves the value of the designatedSQL XMLparameter as ajava.sql.SQLXMLobject in the Java programming language.SQLXMLgetSQLXML(String parameterName)Retrieves the value of the designatedSQL XMLparameter as ajava.sql.SQLXMLobject in the Java programming language.booleanisClosed()Retrieves whether thisStatementobject has been closed.booleanisPoolable()Returns a value indicating whether theStatementis poolable or not.booleanisWrapperFor(Class<?> iface)Returns true if this either implements the interface argument or is directly or indirectly a wrapper for an object that does.voidregisterOutParameter(int parameterIndex, SQLType sqlType)Registers the OUT parameter in ordinal positionparameterIndexto the JDBC typesqlType.voidregisterOutParameter(int parameterIndex, SQLType sqlType, int scale)Registers the parameter in ordinal positionparameterIndexto be of JDBC typesqlType.voidregisterOutParameter(int parameterIndex, SQLType sqlType, String typeName)Registers the designated output parameter.voidregisterOutParameter(String parameterName, SQLType sqlType)Registers the OUT parameter namedparameterNameto the JDBC typesqlType.voidregisterOutParameter(String parameterName, SQLType sqlType, int scale)Registers the parameter namedparameterNameto be of JDBC typesqlType.voidregisterOutParameter(String parameterName, SQLType sqlType, String typeName)Registers the designated output parameter.voidsetAsciiStream(int parameterIndex, InputStream x)Sets the designated parameter to the given input stream.voidsetAsciiStream(int parameterIndex, InputStream x, long length)Sets the designated parameter to the given input stream, which will have the specified number of bytes.voidsetAsciiStream(String parameterName, InputStream x)Sets the designated parameter to the given input stream.voidsetAsciiStream(String parameterName, InputStream x, long length)Sets the designated parameter to the given input stream, which will have the specified number of bytes.voidsetBinaryStream(int parameterIndex, InputStream x)Sets the designated parameter to the given input stream.voidsetBinaryStream(int parameterIndex, InputStream x, long length)Sets the designated parameter to the given input stream, which will have the specified number of bytes.voidsetBinaryStream(String parameterName, InputStream x)Sets the designated parameter to the given input stream.voidsetBinaryStream(String parameterName, InputStream x, long length)Sets the designated parameter to the given input stream, which will have the specified number of bytes.voidsetBlob(int parameterIndex, InputStream inputStream)Sets the designated parameter to aInputStreamobject.voidsetBlob(int parameterIndex, InputStream inputStream, long length)Sets the designated parameter to aInputStreamobject.voidsetBlob(String parameterName, InputStream inputStream)Sets the designated parameter to aInputStreamobject.voidsetBlob(String parameterName, InputStream inputStream, long length)Sets the designated parameter to aInputStreamobject.voidsetBlob(String parameterName, Blob x)Sets the designated parameter to the givenjava.sql.Blobobject.voidsetCharacterStream(int parameterIndex, Reader reader)Sets the designated parameter to the givenReaderobject.voidsetCharacterStream(int parameterIndex, Reader reader, long length)Sets the designated parameter to the givenReaderobject, which is the given number of characters long.voidsetCharacterStream(String parameterName, Reader reader)Sets the designated parameter to the givenReaderobject.voidsetCharacterStream(String parameterName, Reader reader, long length)Sets the designated parameter to the givenReaderobject, which is the given number of characters long.voidsetClob(int parameterIndex, Reader reader)Sets the designated parameter to aReaderobject.voidsetClob(int parameterIndex, Reader reader, long length)Sets the designated parameter to aReaderobject.voidsetClob(String parameterName, Reader reader)Sets the designated parameter to aReaderobject.voidsetClob(String parameterName, Reader reader, long length)Sets the designated parameter to aReaderobject.voidsetClob(String parameterName, Clob x)Sets the designated parameter to the givenjava.sql.Clobobject.voidsetNCharacterStream(int parameterIndex, Reader value)Sets the designated parameter to aReaderobject.voidsetNCharacterStream(int parameterIndex, Reader value, long length)Sets the designated parameter to aReaderobject.voidsetNCharacterStream(String parameterName, Reader value)Sets the designated parameter to aReaderobject.voidsetNCharacterStream(String parameterName, Reader value, long length)Sets the designated parameter to aReaderobject.voidsetNClob(int parameterIndex, Reader reader)Sets the designated parameter to aReaderobject.voidsetNClob(int parameterIndex, Reader reader, long length)Sets the designated parameter to aReaderobject.voidsetNClob(int parameterIndex, NClob value)Sets the designated parameter to ajava.sql.NClobobject.voidsetNClob(String parameterName, Reader reader)Sets the designated parameter to aReaderobject.voidsetNClob(String parameterName, Reader reader, long length)Sets the designated parameter to aReaderobject.voidsetNClob(String parameterName, NClob reader)Sets the designated parameter to aReaderobject.voidsetNString(int parameterIndex, String value)Sets the designated parameter to the givenStringobject.voidsetNString(String parameterName, String value)Sets the designated parameter to the givenStringobject.voidsetObject(String parameterName, Object parameterValue, SQLType targetSqlType)Sets the value of the designated parameter with the given object.voidsetObject(String parameterName, Object parameterValue, SQLType targetSqlType, int scaleOrLength)Sets the value of the designated parameter with the given object.voidsetPoolable(boolean poolable)Requests that aStatementbe pooled or not pooled.voidsetRowId(int parameterIndex, RowId x)Sets the designated parameter to the givenjava.sql.RowIdobject.voidsetRowId(String parameterName, RowId x)Sets the designated parameter to the givenjava.sql.RowIdobject.voidsetSQLXML(int parameterIndex, SQLXML xmlObject)Sets the designated parameter to the givenjava.sql.SQLXMLobject.voidsetSQLXML(String parameterName, SQLXML xmlObject)Sets the designated parameter to the givenjava.sql.SQLXMLobject.<T> Tunwrap(Class<T> iface)Returns an object that implements the given interface to allow access to non-standard methods, or standard methods not exposed by the proxy.-
Methods inherited from class com.sun.gjc.spi.base.CallableStatementWrapper
getArray, getArray, getBigDecimal, getBigDecimal, getBigDecimal, getBlob, getBlob, getBoolean, getBoolean, getByte, getByte, getBytes, getBytes, getClob, getClob, getDate, getDate, getDate, getDate, getDouble, getDouble, getFloat, getFloat, getInt, getInt, getLong, getLong, getObject, getObject, getObject, getObject, getRef, getRef, getShort, getShort, getString, getString, getTime, getTime, getTime, getTime, getTimestamp, getTimestamp, getTimestamp, getTimestamp, getURL, getURL, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, setAsciiStream, setBigDecimal, setBinaryStream, setBoolean, setByte, setBytes, setCharacterStream, setDate, setDate, setDouble, setFloat, setInt, setLong, setNull, setNull, setObject, setObject, setObject, setShort, setString, setTime, setTime, setTimestamp, setTimestamp, setURL, wasNull
-
Methods inherited from class com.sun.gjc.spi.base.PreparedStatementWrapper
addBatch, clearParameters, close, closeOnCompletion, execute, executeUpdate, getCached, getMetaData, getParameterMetaData, incrementResultSetReferenceCount, isBusy, isCloseOnCompletion, isValid, resultSetClosed, setArray, setAsciiStream, setBigDecimal, setBinaryStream, setBlob, setBoolean, setBusy, setByte, setBytes, setCached, setCharacterStream, setClob, setDate, setDate, setDouble, setFetchDirection, setFetchSize, setFloat, setInt, setLong, setMaxFieldSize, setMaxRows, setNull, setNull, setObject, setObject, setObject, setQueryTimeout, setRef, setShort, setString, setTime, setTime, setTimestamp, setTimestamp, setUnicodeStream, setURL, setValid
-
Methods inherited from class com.sun.gjc.spi.base.StatementWrapper
actualCloseOnCompletion, addBatch, cancel, clearBatch, clearWarnings, decrementResultSetCount, execute, execute, execute, execute, executeBatch, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getActualConnection, getCloseOnCompletion, getConnection, getFetchDirection, getFetchSize, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSetConcurrency, getResultSetCount, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, incrementResultSetCount, isMarkedForReclaim, markForReclaim, reclaimStatement, setCursorName, setEscapeProcessing
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface java.sql.PreparedStatement
addBatch, clearParameters, execute, executeLargeUpdate, executeUpdate, getMetaData, getParameterMetaData, setArray, setAsciiStream, setBigDecimal, setBinaryStream, setBlob, setBoolean, setByte, setBytes, setCharacterStream, setClob, setDate, setDate, setDouble, setFloat, setInt, setLong, setNull, setNull, setObject, setObject, setObject, setObject, setObject, setRef, setShort, setString, setTime, setTime, setTimestamp, setTimestamp, setUnicodeStream, setURL
-
Methods inherited from interface java.sql.Statement
addBatch, cancel, clearBatch, clearWarnings, close, closeOnCompletion, enquoteIdentifier, enquoteLiteral, enquoteNCharLiteral, execute, execute, execute, execute, executeBatch, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getLargeMaxRows, getLargeUpdateCount, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isCloseOnCompletion, isSimpleIdentifier, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setQueryTimeout
-
-
-
-
Constructor Detail
-
CallableStatementWrapper40
public CallableStatementWrapper40(Connection con, CallableStatement statement, boolean cachingEnabled) throws SQLException
Creates a new instance of CallableStatement wrapper for JDBC 3.0- Parameters:
con- ConnectionWrapperstatement- CallableStatement that is wrappedcachingEnabled- Boolean that enabled/ disables caching- Throws:
SQLException- Exception thrown from underlying statement
-
-
Method Detail
-
getCharacterStream
public Reader getCharacterStream(int parameterIndex) throws SQLException
Retrieves the value of the designated parameter as ajava.io.Readerobject in the Java programming language.- 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 the parameterIndex is not valid; if a database access error occurs or this method is called on a closedCallableStatement- Since:
- 1.6
-
getCharacterStream
public Reader getCharacterStream(String parameterName) throws SQLException
Retrieves the value of the designated parameter as ajava.io.Readerobject in the Java programming language.- Parameters:
parameterName- the name of the parameter- 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 parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
getNCharacterStream
public Reader getNCharacterStream(int parameterIndex) throws SQLException
Retrieves the value of the designated parameter as ajava.io.Readerobject in the Java programming language. It is intended for use when accessingNCHAR,NVARCHARandLONGNVARCHARparameters.- 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 the parameterIndex is not valid; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
getNCharacterStream
public Reader getNCharacterStream(String parameterName) throws SQLException
Retrieves the value of the designated parameter as ajava.io.Readerobject in the Java programming language. It is intended for use when accessingNCHAR,NVARCHARandLONGNVARCHARparameters.- Parameters:
parameterName- the name of the parameter- 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 parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
getNClob
public NClob getNClob(int parameterIndex) throws SQLException
Retrieves the value of the designated JDBCNCLOBparameter as ajava.sql.NClobobject in the Java programming language.- Parameters:
parameterIndex- the first parameter is 1, the second is 2, and so on- Returns:
- the parameter value as a
NClobobject in the Java programming language. If the value was SQLNULL, the valuenullis returned. - Throws:
SQLException- if the parameterIndex is not valid; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
getNClob
public NClob getNClob(String parameterName) throws SQLException
Retrieves the value of a JDBCNCLOBparameter as ajava.sql.NClobobject in the Java programming language.- Parameters:
parameterName- the name of the parameter- Returns:
- the parameter value as a
NClobobject in the Java programming language. If the value was SQLNULL, the valuenullis returned. - Throws:
SQLException- if parameterName does not correspond to a named parameter; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
getNString
public String getNString(int parameterIndex) throws SQLException
Retrieves the value of the designatedNCHAR,NVARCHARorLONGNVARCHARparameter as aStringin the Java programming language. For the fixed-length type JDBCNCHAR, theStringobject returned has exactly the same value the SQLNCHARvalue had in the database, including any padding added by the database.- Parameters:
parameterIndex- index of the first parameter is 1, the second is 2, ...- Returns:
- a
Stringobject that maps anNCHAR,NVARCHARorLONGNVARCHARvalue - Throws:
SQLException- if the parameterIndex is not valid; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
- See Also:
setNString(java.lang.String, java.lang.String)
-
getNString
public String getNString(String parameterName) throws SQLException
Retrieves the value of the designatedNCHAR,NVARCHARorLONGNVARCHARparameter as aStringin the Java programming language. For the fixed-length type JDBCNCHAR, theStringobject returned has exactly the same value the SQLNCHARvalue had in the database, including any padding added by the database.- Parameters:
parameterName- the name of the parameter- Returns:
- a
Stringobject that maps anNCHAR,NVARCHARorLONGNVARCHARvalue - Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
- See Also:
setNString(java.lang.String, java.lang.String)
-
getRowId
public RowId getRowId(int parameterIndex) throws SQLException
Retrieves the value of the designated JDBCROWIDparameter as ajava.sql.RowIdobject.- Parameters:
parameterIndex- the first parameter is 1, the second is 2,...- Returns:
- a
RowIdobject that represents the JDBCROWIDvalue is used as the designated parameter. If the parameter contains a SQLNULL, then anullvalue is returned. - Throws:
SQLException- if the parameterIndex is not valid; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
getRowId
public RowId getRowId(String parameterName) throws SQLException
Retrieves the value of the designated JDBCROWIDparameter as ajava.sql.RowIdobject.- Parameters:
parameterName- the name of the parameter- Returns:
- a
RowIdobject that represents the JDBCROWIDvalue is used as the designated parameter. If the parameter contains a SQLNULL, then anullvalue is returned. - Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
getSQLXML
public SQLXML getSQLXML(int parameterIndex) throws SQLException
Retrieves the value of the designatedSQL XMLparameter as ajava.sql.SQLXMLobject in the Java programming language.- Parameters:
parameterIndex- index of the first parameter is 1, the second is 2, ...- Returns:
- a
SQLXMLobject that maps anSQL XMLvalue - Throws:
SQLException- if the parameterIndex is not valid; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
getSQLXML
public SQLXML getSQLXML(String parameterName) throws SQLException
Retrieves the value of the designatedSQL XMLparameter as ajava.sql.SQLXMLobject in the Java programming language.- Parameters:
parameterName- the name of the parameter- Returns:
- a
SQLXMLobject that maps anSQL XMLvalue - Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setAsciiStream
public void setAsciiStream(String parameterName, InputStream x) throws SQLException
Sets the designated parameter to the given input stream. When a very large ASCII value is input to aLONGVARCHARparameter, it may be more practical to send it via ajava.io.InputStream. Data will be read from the stream as needed until end-of-file is reached. The JDBC driver will do any necessary conversion from ASCII to the database char format.Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setAsciiStreamwhich takes a length parameter.- Parameters:
parameterName- the name of the parameterx- the Java input stream that contains the ASCII parameter value- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setAsciiStream
public 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. When a very large ASCII value is input to aLONGVARCHARparameter, it may be more practical to send it via ajava.io.InputStream. Data will be read from the stream as needed until end-of-file is reached. The JDBC driver will do any necessary conversion from ASCII to the database char format.Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
- 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- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setBinaryStream
public void setBinaryStream(String parameterName, InputStream x) throws SQLException
Sets the designated parameter to the given input stream. When a very large binary value is input to aLONGVARBINARYparameter, it may be more practical to send it via ajava.io.InputStreamobject. The data will be read from the stream as needed until end-of-file is reached.Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setBinaryStreamwhich takes a length parameter.- Parameters:
parameterName- the name of the parameterx- the java input stream which contains the binary parameter value- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setBinaryStream
public 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. When a very large binary value is input to aLONGVARBINARYparameter, it may be more practical to send it via ajava.io.InputStreamobject. The data will be read from the stream as needed until end-of-file is reached.Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
- Parameters:
parameterName- the name of the parameterx- the java input stream which contains the binary parameter valuelength- the number of bytes in the stream- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setBlob
public void setBlob(String parameterName, Blob x) throws SQLException
Sets the designated parameter to the givenjava.sql.Blobobject. The driver converts this to an SQLBLOBvalue when it sends it to the database.- Parameters:
parameterName- the name of the parameterx- aBlobobject that maps an SQLBLOBvalue- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setBlob
public void setBlob(String parameterName, InputStream inputStream) throws SQLException
Sets the designated parameter to aInputStreamobject. This method differs from thesetBinaryStream (int, InputStream)method because it informs the driver that the parameter value should be sent to the server as aBLOB. When thesetBinaryStreammethod is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as aLONGVARBINARYor aBLOBNote: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setBlobwhich takes a length parameter.- Parameters:
parameterName- the name of the parameterinputStream- An object that contains the data to set the parameter value to.- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setBlob
public void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException
Sets the designated parameter to aInputStreamobject. Theinputstreammust contain the number of characters specified by length, otherwise aSQLExceptionwill be generated when theCallableStatementis executed. This method differs from thesetBinaryStream (int, InputStream, int)method because it informs the driver that the parameter value should be sent to the server as aBLOB. When thesetBinaryStreammethod is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as aLONGVARBINARYor aBLOB- Parameters:
parameterName- the name of the parameter to be set the second is 2, ...inputStream- An object that contains the data to set the parameter value to.length- the number of bytes in the parameter data.- Throws:
SQLException- if parameterName does not correspond to a named parameter; if the length specified is less than zero; if the number of bytes in the inputstream does not match the specified length; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setCharacterStream
public void setCharacterStream(String parameterName, Reader reader) throws SQLException
Sets the designated parameter to the givenReaderobject. When a very large UNICODE value is input to aLONGVARCHARparameter, it may be more practical to send it via ajava.io.Readerobject. The data will be read from the stream as needed until end-of-file is reached. The JDBC driver will do any necessary conversion from UNICODE to the database char format.Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setCharacterStreamwhich takes a length parameter.- Parameters:
parameterName- the name of the parameterreader- thejava.io.Readerobject that contains the Unicode data- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setCharacterStream
public void setCharacterStream(String parameterName, Reader reader, long length) throws SQLException
Sets the designated parameter to the givenReaderobject, which is the given number of characters long. When a very large UNICODE value is input to aLONGVARCHARparameter, it may be more practical to send it via ajava.io.Readerobject. The data will be read from the stream as needed until end-of-file is reached. The JDBC driver will do any necessary conversion from UNICODE to the database char format.Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
- Parameters:
parameterName- the name of the parameterreader- thejava.io.Readerobject that contains the UNICODE data used as the designated parameterlength- the number of characters in the stream- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setClob
public void setClob(String parameterName, Clob x) throws SQLException
Sets the designated parameter to the givenjava.sql.Clobobject. The driver converts this to an SQLCLOBvalue when it sends it to the database.- Parameters:
parameterName- the name of the parameterx- aClobobject that maps an SQLCLOBvalue- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setClob
public void setClob(String parameterName, Reader reader) throws SQLException
Sets the designated parameter to aReaderobject. This method differs from thesetCharacterStream (int, Reader)method because it informs the driver that the parameter value should be sent to the server as aCLOB. When thesetCharacterStreammethod is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as aLONGVARCHARor aCLOBNote: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setClobwhich takes a length parameter.- Parameters:
parameterName- the name of the parameterreader- An object that contains the data to set the parameter value to.- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setNCharacterStream
public void setNCharacterStream(String parameterName, Reader value) throws SQLException
Sets the designated parameter to aReaderobject. TheReaderreads the data till end-of-file is reached. The driver does the necessary conversion from Java character format to the national character set in the database.Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setNCharacterStreamwhich takes a length parameter.- Parameters:
parameterName- the name of the parametervalue- the parameter value- Throws:
SQLException- if parameterName does not correspond to a named parameter; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs; or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setNCharacterStream
public void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException
Sets the designated parameter to aReaderobject. TheReaderreads the data till end-of-file is reached. The driver does the necessary conversion from Java character format to the national character set in the database.- Parameters:
parameterName- the name of the parameter to be setvalue- the parameter valuelength- the number of characters in the parameter data.- Throws:
SQLException- if parameterName does not correspond to a named parameter; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setNClob
public void setNClob(String parameterName, NClob reader) throws SQLException
Sets the designated parameter to aReaderobject. This method differs from thesetCharacterStream (int, Reader)method because it informs the driver that the parameter value should be sent to the server as aNCLOB. When thesetCharacterStreammethod is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as aLONGNVARCHARor aNCLOBNote: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setNClobwhich takes a length parameter.- Parameters:
parameterName- the name of the parameterreader- An object that contains the data to set the parameter value to.- Throws:
SQLException- if parameterName does not correspond to a named parameter; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setClob
public void setClob(String parameterName, Reader reader, long length) throws SQLException
Sets the designated parameter to aReaderobject. Thereadermust contain the number of characters specified by length otherwise aSQLExceptionwill be generated when theCallableStatementis executed. This method differs from thesetCharacterStream (int, Reader, int)method because it informs the driver that the parameter value should be sent to the server as aCLOB. When thesetCharacterStreammethod is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as aLONGVARCHARor aCLOB- Parameters:
parameterName- the name of the parameter to be setreader- An object that contains the data to set the parameter value to.length- the number of characters in the parameter data.- Throws:
SQLException- if parameterName does not correspond to a named parameter; if the length specified is less than zero; a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setNClob
public void setNClob(String parameterName, Reader reader) throws SQLException
Sets the designated parameter to aReaderobject. This method differs from thesetCharacterStream (int, Reader)method because it informs the driver that the parameter value should be sent to the server as aNCLOB. When thesetCharacterStreammethod is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as aLONGNVARCHARor aNCLOBNote: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setNClobwhich takes a length parameter.- Parameters:
parameterName- the name of the parameterreader- An object that contains the data to set the parameter value to.- Throws:
SQLException- if parameterName does not correspond to a named parameter; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setNClob
public void setNClob(String parameterName, Reader reader, long length) throws SQLException
Sets the designated parameter to aReaderobject. Thereadermust contain the number of characters specified by length otherwise aSQLExceptionwill be generated when theCallableStatementis executed. This method differs from thesetCharacterStream (int, Reader, int)method because it informs the driver that the parameter value should be sent to the server as aNCLOB. When thesetCharacterStreammethod is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as aLONGNVARCHARor aNCLOB- Parameters:
parameterName- the name of the parameter to be setreader- An object that contains the data to set the parameter value to.length- the number of characters in the parameter data.- Throws:
SQLException- if parameterName does not correspond to a named parameter; if the length specified is less than zero; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setNString
public void setNString(String parameterName, String value) throws SQLException
Sets the designated parameter to the givenStringobject. The driver converts this to a SQLNCHARorNVARCHARorLONGNVARCHAR- Parameters:
parameterName- the name of the parameter to be setvalue- the parameter value- Throws:
SQLException- if parameterName does not correspond to a named parameter; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setRowId
public void setRowId(String parameterName, RowId x) throws SQLException
Sets the designated parameter to the givenjava.sql.RowIdobject. The driver converts this to a SQLROWIDwhen it sends it to the database.- Parameters:
parameterName- the name of the parameterx- the parameter value- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setSQLXML
public void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException
Sets the designated parameter to the givenjava.sql.SQLXMLobject. The driver converts this to anSQL XMLvalue when it sends it to the database.- Parameters:
parameterName- the name of the parameterxmlObject- aSQLXMLobject that maps anSQL XMLvalue- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs; this method is called on a closedCallableStatementor thejava.xml.transform.Result,WriterorOutputStreamhas not been closed for theSQLXMLobjectSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setAsciiStream
public void setAsciiStream(int parameterIndex, InputStream x) throws SQLExceptionSets the designated parameter to the given input stream. When a very large ASCII value is input to aLONGVARCHARparameter, it may be more practical to send it via ajava.io.InputStream. Data will be read from the stream as needed until end-of-file is reached. The JDBC driver will do any necessary conversion from ASCII to the database char format.Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setAsciiStreamwhich takes a length parameter.- Parameters:
parameterIndex- the first parameter is 1, the second is 2, ...x- the Java input stream that contains the ASCII parameter value- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if a database access error occurs or this method is called on a closedPreparedStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setAsciiStream
public void setAsciiStream(int parameterIndex, InputStream x, long length) throws SQLExceptionSets the designated parameter to the given input stream, which will have the specified number of bytes. When a very large ASCII value is input to aLONGVARCHARparameter, it may be more practical to send it via ajava.io.InputStream. Data will be read from the stream as needed until end-of-file is reached. The JDBC driver will do any necessary conversion from ASCII to the database char format.Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
- Parameters:
parameterIndex- the first parameter is 1, the second is 2, ...x- the Java input stream that contains the ASCII parameter valuelength- the number of bytes in the stream- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if a database access error occurs or this method is called on a closedPreparedStatement- Since:
- 1.6
-
setBinaryStream
public void setBinaryStream(int parameterIndex, InputStream x) throws SQLExceptionSets the designated parameter to the given input stream. When a very large binary value is input to aLONGVARBINARYparameter, it may be more practical to send it via ajava.io.InputStreamobject. The data will be read from the stream as needed until end-of-file is reached.Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setBinaryStreamwhich takes a length parameter.- Parameters:
parameterIndex- the first parameter is 1, the second is 2, ...x- the java input stream which contains the binary parameter value- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if a database access error occurs or this method is called on a closedPreparedStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setBinaryStream
public void setBinaryStream(int parameterIndex, InputStream x, long length) throws SQLExceptionSets the designated parameter to the given input stream, which will have the specified number of bytes. When a very large binary value is input to aLONGVARBINARYparameter, it may be more practical to send it via ajava.io.InputStreamobject. The data will be read from the stream as needed until end-of-file is reached.Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
- Parameters:
parameterIndex- the first parameter is 1, the second is 2, ...x- the java input stream which contains the binary parameter valuelength- the number of bytes in the stream- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if a database access error occurs or this method is called on a closedPreparedStatement- Since:
- 1.6
-
setBlob
public void setBlob(int parameterIndex, InputStream inputStream) throws SQLExceptionSets the designated parameter to aInputStreamobject. This method differs from thesetBinaryStream (int, InputStream)method because it informs the driver that the parameter value should be sent to the server as aBLOB. When thesetBinaryStreammethod is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as aLONGVARBINARYor aBLOBNote: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setBlobwhich takes a length parameter.- Parameters:
parameterIndex- index of the first parameter is 1, the second is 2, ...inputStream- An object that contains the data to set the parameter value to.- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if a database access error occurs; this method is called on a closedPreparedStatementor if parameterIndex does not correspond to a parameter marker in the SQL statement,SQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setBlob
public void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLExceptionSets the designated parameter to aInputStreamobject. The inputstream must contain the number of characters specified by length otherwise aSQLExceptionwill be generated when thePreparedStatementis executed. This method differs from thesetBinaryStream (int, InputStream, int)method because it informs the driver that the parameter value should be sent to the server as aBLOB. When thesetBinaryStreammethod is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as aLONGVARBINARYor aBLOB- Parameters:
parameterIndex- index of the first parameter is 1, the second is 2, ...inputStream- An object that contains the data to set the parameter value to.length- the number of bytes in the parameter data.- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if a database access error occurs; this method is called on a closedPreparedStatement; if the length specified is less than zero or if the number of bytes in the inputstream does not match the specfied length.SQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setCharacterStream
public void setCharacterStream(int parameterIndex, Reader reader) throws SQLExceptionSets the designated parameter to the givenReaderobject. When a very large UNICODE value is input to aLONGVARCHARparameter, it may be more practical to send it via ajava.io.Readerobject. The data will be read from the stream as needed until end-of-file is reached. The JDBC driver will do any necessary conversion from UNICODE to the database char format.Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setCharacterStreamwhich takes a length parameter.- Parameters:
parameterIndex- the first parameter is 1, the second is 2, ...reader- thejava.io.Readerobject that contains the Unicode data- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if a database access error occurs or this method is called on a closedPreparedStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setCharacterStream
public void setCharacterStream(int parameterIndex, Reader reader, long length) throws SQLExceptionSets the designated parameter to the givenReaderobject, which is the given number of characters long. When a very large UNICODE value is input to aLONGVARCHARparameter, it may be more practical to send it via ajava.io.Readerobject. The data will be read from the stream as needed until end-of-file is reached. The JDBC driver will do any necessary conversion from UNICODE to the database char format.Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
- Parameters:
parameterIndex- the first parameter is 1, the second is 2, ...reader- thejava.io.Readerobject that contains the Unicode datalength- the number of characters in the stream- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if a database access error occurs or this method is called on a closedPreparedStatement- Since:
- 1.6
-
setClob
public void setClob(int parameterIndex, Reader reader) throws SQLExceptionSets the designated parameter to aReaderobject. This method differs from thesetCharacterStream (int, Reader)method because it informs the driver that the parameter value should be sent to the server as aCLOB. When thesetCharacterStreammethod is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as aLONGVARCHARor aCLOBNote: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setClobwhich takes a length parameter.- Parameters:
parameterIndex- index of the first parameter is 1, the second is 2, ...reader- An object that contains the data to set the parameter value to.- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if a database access error occurs; this method is called on a closedPreparedStatementor if parameterIndex does not correspond to a parameter marker in the SQL statementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setClob
public void setClob(int parameterIndex, Reader reader, long length) throws SQLExceptionSets the designated parameter to aReaderobject. The reader must contain the number of characters specified by length otherwise aSQLExceptionwill be generated when thePreparedStatementis executed. This method differs from thesetCharacterStream (int, Reader, int)method because it informs the driver that the parameter value should be sent to the server as aCLOB. When thesetCharacterStreammethod is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as aLONGVARCHARor aCLOB- Parameters:
parameterIndex- index of the first parameter is 1, the second is 2, ...reader- An object that contains the data to set the parameter value to.length- the number of characters in the parameter data.- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if a database access error occurs; this method is called on a closedPreparedStatementor if the length specified is less than zero.SQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setNCharacterStream
public void setNCharacterStream(int parameterIndex, Reader value) throws SQLExceptionSets the designated parameter to aReaderobject. TheReaderreads the data till end-of-file is reached. The driver does the necessary conversion from Java character format to the national character set in the database.Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setNCharacterStreamwhich takes a length parameter.- Parameters:
parameterIndex- of the first parameter is 1, the second is 2, ...value- the parameter value- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs; or this method is called on a closedPreparedStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setNCharacterStream
public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLExceptionSets the designated parameter to aReaderobject. TheReaderreads the data till end-of-file is reached. The driver does the necessary conversion from Java character format to the national character set in the database.- Parameters:
parameterIndex- of the first parameter is 1, the second is 2, ...value- the parameter valuelength- the number of characters in the parameter data.- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs; or this method is called on a closedPreparedStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setNClob
public void setNClob(int parameterIndex, NClob value) throws SQLExceptionSets the designated parameter to ajava.sql.NClobobject. The driver converts this to a SQLNCLOBvalue when it sends it to the database.- Parameters:
parameterIndex- of the first parameter is 1, the second is 2, ...value- the parameter value- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs; or this method is called on a closedPreparedStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setNClob
public void setNClob(int parameterIndex, Reader reader) throws SQLExceptionSets the designated parameter to aReaderobject. This method differs from thesetCharacterStream (int, Reader)method because it informs the driver that the parameter value should be sent to the server as aNCLOB. When thesetCharacterStreammethod is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as aLONGNVARCHARor aNCLOBNote: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setNClobwhich takes a length parameter.- Parameters:
parameterIndex- index of the first parameter is 1, the second is 2, ...reader- An object that contains the data to set the parameter value to.- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs or this method is called on a closedPreparedStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setNClob
public void setNClob(int parameterIndex, Reader reader, long length) throws SQLExceptionSets the designated parameter to aReaderobject. The reader must contain the number of characters specified by length otherwise aSQLExceptionwill be generated when thePreparedStatementis executed. This method differs from thesetCharacterStream (int, Reader, int)method because it informs the driver that the parameter value should be sent to the server as aNCLOB. When thesetCharacterStreammethod is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as aLONGNVARCHARor aNCLOB- Parameters:
parameterIndex- index of the first parameter is 1, the second is 2, ...reader- An object that contains the data to set the parameter value to.length- the number of characters in the parameter data.- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if the length specified is less than zero; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs or this method is called on a closedPreparedStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setNString
public void setNString(int parameterIndex, String value) throws SQLExceptionSets the designated parameter to the givenStringobject. The driver converts this to a SQLNCHARorNVARCHARorLONGNVARCHARvalue (depending on the argument's size relative to the driver's limits onNVARCHARvalues) when it sends it to the database.- Parameters:
parameterIndex- of the first parameter is 1, the second is 2, ...value- the parameter value- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs; or this method is called on a closedPreparedStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setRowId
public void setRowId(int parameterIndex, RowId x) throws SQLExceptionSets the designated parameter to the givenjava.sql.RowIdobject. The driver converts this to a SQLROWIDvalue when it sends it to the database- Parameters:
parameterIndex- the first parameter is 1, the second is 2, ...x- the parameter value- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if a database access error occurs or this method is called on a closedPreparedStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
setSQLXML
public void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLExceptionSets the designated parameter to the givenjava.sql.SQLXMLobject. The driver converts this to an SQLXMLvalue when it sends it to the database.- Parameters:
parameterIndex- index of the first parameter is 1, the second is 2, ...xmlObject- aSQLXMLobject that maps an SQLXMLvalue- Throws:
SQLException- if parameterIndex does not correspond to a parameter marker in the SQL statement; if a database access error occurs; this method is called on a closedPreparedStatementor thejava.xml.transform.Result,WriterorOutputStreamhas not been closed for theSQLXMLobjectSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.6
-
isClosed
public boolean isClosed() throws SQLExceptionRetrieves whether thisStatementobject has been closed. AStatementis closed if the method close has been called on it, or if it is automatically closed.- Returns:
- true if this
Statementobject is closed; false if it is still open - Throws:
SQLException- if a database access error occurs- Since:
- 1.6
-
isPoolable
public boolean isPoolable() throws SQLExceptionReturns a value indicating whether theStatementis poolable or not.- Returns:
trueif theStatementis poolable;falseotherwise- Throws:
SQLException- if this method is called on a closedStatement- Since:
- 1.6
- See Also:
Statement.setPoolable(boolean)
-
setPoolable
public void setPoolable(boolean poolable) throws SQLExceptionRequests that aStatementbe pooled or not pooled. The value specified is a hint to the statement pool implementation indicating whether the application wants the statement to be pooled. It is up to the statement pool manager as to whether the hint is used.The poolable value of a statement is applicable to both internal statement caches implemented by the driver and external statement caches implemented by application servers and other applications.
By default, aStatementis not poolable when created, and aPreparedStatementandCallableStatementare poolable when created.- Parameters:
poolable- requests that the statement be pooled if true and that the statement not be pooled if false- Throws:
SQLException- if this method is called on a closedStatement- Since:
- 1.6
-
isWrapperFor
public boolean isWrapperFor(Class<?> iface) throws SQLException
Returns true if this either implements the interface argument or is directly or indirectly a wrapper for an object that does. Returns false otherwise. If this implements the interface then return true, else if this is a wrapper then return the result of recursively callingisWrapperForon the wrapped object. If this does not implement the interface and is not a wrapper, return false. This method should be implemented as a low-cost operation compared tounwrapso that callers can use this method to avoid expensiveunwrapcalls that may fail. If this method returns true then callingunwrapwith the same argument should succeed.- Parameters:
iface- a Class defining an interface.- Returns:
- true if this implements the interface or directly or indirectly wraps an object that does.
- Throws:
SQLException- if an error occurs while determining whether this is a wrapper for an object with the given interface.- Since:
- 1.6
-
unwrap
public <T> T unwrap(Class<T> iface) throws SQLException
Returns an object that implements the given interface to allow access to non-standard methods, or standard methods not exposed by the proxy.If the receiver implements the interface then the result is the receiver or a proxy for the receiver. If the receiver is a wrapper and the wrapped object implements the interface then the result is the wrapped object or a proxy for the wrapped object. Otherwise return the the result of calling
unwraprecursively on the wrapped object or a proxy for that result. If the receiver is not a wrapper and does not implement the interface, then anSQLExceptionis thrown.- Parameters:
iface- A Class defining an interface that the result must implement.- Returns:
- an object that implements the interface. May be a proxy for the actual implementing object.
- Throws:
SQLException- If no object found that implements the interface- Since:
- 1.6
-
executeQuery
public ResultSet executeQuery() throws SQLException
Executes the SQL query in thisPreparedStatementobject and returns theResultSetobject generated by the query.- Returns:
- a
ResultSetobject that contains the data produced by the query; nevernull - Throws:
SQLException- if a database access error occurs; this method is called on a closedPreparedStatementor the SQL statement does not return aResultSetobject
-
executeQuery
public ResultSet executeQuery(String sql) throws SQLException
Executes the given SQL statement, which returns a singleResultSetobject.- Parameters:
sql- an SQL statement to be sent to the database, typically a static SQLSELECTstatement- Returns:
- a
ResultSetobject that contains the data produced by the given query; nevernull - Throws:
SQLException- if a database access error occurs, this method is called on a closedStatementor the given SQL statement produces anything other than a singleResultSetobject
-
getGeneratedKeys
public ResultSet getGeneratedKeys() throws SQLException
Retrieves any auto-generated keys created as a result of executing thisStatementobject. If thisStatementobject did not generate any keys, an emptyResultSetobject is returned.Note:If the columns which represent the auto-generated keys were not specified, the JDBC driver implementation will determine the columns which best represent the auto-generated keys.
- Returns:
- a
ResultSetobject containing the auto-generated key(s) generated by the execution of thisStatementobject - Throws:
SQLException- if a database access error occurs or this method is called on a closedStatementSQLFeatureNotSupportedException- if the JDBC driver does not support this method- Since:
- 1.4
-
getResultSet
public ResultSet getResultSet() throws SQLException
Retrieves the current result as aResultSetobject. This method should be called only once per result.- Returns:
- the current result as a
ResultSetobject ornullif the result is an update count or there are no more results - Throws:
SQLException- if a database access error occurs or this method is called on a closedStatement- See Also:
PreparedStatementWrapper.execute()
-
getObject
public <T> T getObject(int parameterIndex, Class<T> type) throws SQLException- Throws:
SQLException
-
getObject
public <T> T getObject(String parameterName, Class<T> type) throws SQLException
- Throws:
SQLException
-
setObject
public void setObject(String parameterName, Object parameterValue, SQLType targetSqlType, int scaleOrLength) throws SQLException
Sets the value of the designated parameter with the given object. The given Java object will be converted to the given targetSqlType before being sent to the database.
- Parameters:
parameterName- the name of the parameterparameterValue- the object containing the input parameter valuetargetSqlType- the SQL type to be sent to the database. The scale argument may further qualify this type.scaleOrLength- forjava.sql.JDBCType.DECIMALorjava.sql.JDBCType.NUMERIC types, this is the number of digits after the decimal point. For Java Object typesInputStreamandReader, this is the length of the data in the stream or reader. For all other types, this value will be ignored.- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementor if the Java Object specified by x is an InputStream or Reader object and the value of the scale parameter is less than zeroSQLFeatureNotSupportedException- if the JDBC driver does not support the specified targetSqlType
-
setObject
public void setObject(String parameterName, Object parameterValue, SQLType targetSqlType) throws SQLException
Sets the value of the designated parameter with the given object. This method is similar tosetObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength), except that it assumes a scale of zero.- Parameters:
parameterName- the name of the parameterparameterValue- the object containing the input parameter valuetargetSqlType- the SQL type to be sent to the database- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support the specified targetSqlType
-
registerOutParameter
public void registerOutParameter(int parameterIndex, SQLType sqlType) throws SQLExceptionRegisters the OUT parameter in ordinal positionparameterIndexto the JDBC typesqlType.- Parameters:
parameterIndex- the first parameter is 1, the second is 2, and so onsqlType- the JDBC type code defined bySQLTypeto use to register the OUT Parameter. If the parameter is of JDBC typeJDBCType.NUMERICorJDBCType.DECIMAL, the version ofregisterOutParameterthat accepts a scale value should be used.- Throws:
SQLException- if the parameterIndex is not valid; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support the specified sqlType
-
registerOutParameter
public void registerOutParameter(int parameterIndex, SQLType sqlType, int scale) throws SQLExceptionRegisters the parameter in ordinal positionparameterIndexto be of JDBC typesqlType. This version ofregisterOutParametershould be used when the parameter is of JDBC typeJDBCType.NUMERICorJDBCType.DECIMAL.- Parameters:
parameterIndex- the first parameter is 1, the second is 2, and so onsqlType- the JDBC type code defined bySQLTypeto use to register the OUT Parameter.scale- the desired number of digits to the right of the decimal point. It must be greater than or equal to zero.- Throws:
SQLException- if the parameterIndex is not valid; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support the specified sqlType
-
registerOutParameter
public void registerOutParameter(int parameterIndex, SQLType sqlType, String typeName) throws SQLExceptionRegisters the designated output parameter. This version of the methodregisterOutParametershould be used for a user-defined orREFoutput parameter.- Parameters:
parameterIndex- the first parameter is 1, the second is 2,...sqlType- the JDBC type code defined bySQLTypeto use to register the OUT Parameter.typeName- the fully-qualified name of an SQL structured type- Throws:
SQLException- if the parameterIndex is not valid; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support the specified sqlType
-
registerOutParameter
public void registerOutParameter(String parameterName, SQLType sqlType) throws SQLException
Registers the OUT parameter namedparameterNameto the JDBC typesqlType.- Parameters:
parameterName- the name of the parametersqlType- the JDBC type code defined bySQLTypeto use to register the OUT Parameter. If the parameter is of JDBC typeJDBCType.NUMERICorJDBCType.DECIMAL, the version ofregisterOutParameterthat accepts a scale value should be used.- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support the specified sqlType or if the JDBC driver does not support this method
-
registerOutParameter
public void registerOutParameter(String parameterName, SQLType sqlType, int scale) throws SQLException
Registers the parameter namedparameterNameto be of JDBC typesqlType. This version ofregisterOutParametershould be used when the parameter is of JDBC typeJDBCType.NUMERICorJDBCType.DECIMAL.- Parameters:
parameterName- the name of the parametersqlType- the JDBC type code defined bySQLTypeto use to register the OUT Parameter.scale- the desired number of digits to the right of the decimal point. It must be greater than or equal to zero.- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support the specified sqlType or if the JDBC driver does not support this method
-
registerOutParameter
public void registerOutParameter(String parameterName, SQLType sqlType, String typeName) throws SQLException
Registers the designated output parameter. This version of the methodregisterOutParametershould be used for a user-named or REF output parameter.- Parameters:
parameterName- the name of the parametersqlType- the JDBC type code defined bySQLTypeto use to register the OUT Parameter.typeName- the fully-qualified name of an SQL structured type- Throws:
SQLException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatementSQLFeatureNotSupportedException- if the JDBC driver does not support the specified sqlType or if the JDBC driver does not support this method
-
-