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 ResultSet
executeQuery()
Executes the SQL query in thisPreparedStatement
object and returns theResultSet
object generated by the query.ResultSet
executeQuery(String sql)
Executes the given SQL statement, which returns a singleResultSet
object.Reader
getCharacterStream(int parameterIndex)
Retrieves the value of the designated parameter as ajava.io.Reader
object in the Java programming language.Reader
getCharacterStream(String parameterName)
Retrieves the value of the designated parameter as ajava.io.Reader
object in the Java programming language.ResultSet
getGeneratedKeys()
Retrieves any auto-generated keys created as a result of executing thisStatement
object.Reader
getNCharacterStream(int parameterIndex)
Retrieves the value of the designated parameter as ajava.io.Reader
object in the Java programming language.Reader
getNCharacterStream(String parameterName)
Retrieves the value of the designated parameter as ajava.io.Reader
object in the Java programming language.NClob
getNClob(int parameterIndex)
Retrieves the value of the designated JDBCNCLOB
parameter as ajava.sql.NClob
object in the Java programming language.NClob
getNClob(String parameterName)
Retrieves the value of a JDBCNCLOB
parameter as ajava.sql.NClob
object in the Java programming language.String
getNString(int parameterIndex)
Retrieves the value of the designatedNCHAR
,NVARCHAR
orLONGNVARCHAR
parameter as aString
in the Java programming language.String
getNString(String parameterName)
Retrieves the value of the designatedNCHAR
,NVARCHAR
orLONGNVARCHAR
parameter as aString
in the Java programming language.<T> T
getObject(int parameterIndex, Class<T> type)
<T> T
getObject(String parameterName, Class<T> type)
ResultSet
getResultSet()
Retrieves the current result as aResultSet
object.RowId
getRowId(int parameterIndex)
Retrieves the value of the designated JDBCROWID
parameter as ajava.sql.RowId
object.RowId
getRowId(String parameterName)
Retrieves the value of the designated JDBCROWID
parameter as ajava.sql.RowId
object.SQLXML
getSQLXML(int parameterIndex)
Retrieves the value of the designatedSQL XML
parameter as ajava.sql.SQLXML
object in the Java programming language.SQLXML
getSQLXML(String parameterName)
Retrieves the value of the designatedSQL XML
parameter as ajava.sql.SQLXML
object in the Java programming language.boolean
isClosed()
Retrieves whether thisStatement
object has been closed.boolean
isPoolable()
Returns a value indicating whether theStatement
is poolable or not.boolean
isWrapperFor(Class<?> iface)
Returns true if this either implements the interface argument or is directly or indirectly a wrapper for an object that does.void
registerOutParameter(int parameterIndex, SQLType sqlType)
Registers the OUT parameter in ordinal positionparameterIndex
to the JDBC typesqlType
.void
registerOutParameter(int parameterIndex, SQLType sqlType, int scale)
Registers the parameter in ordinal positionparameterIndex
to be of JDBC typesqlType
.void
registerOutParameter(int parameterIndex, SQLType sqlType, String typeName)
Registers the designated output parameter.void
registerOutParameter(String parameterName, SQLType sqlType)
Registers the OUT parameter namedparameterName
to the JDBC typesqlType
.void
registerOutParameter(String parameterName, SQLType sqlType, int scale)
Registers the parameter namedparameterName
to be of JDBC typesqlType
.void
registerOutParameter(String parameterName, SQLType sqlType, String typeName)
Registers the designated output parameter.void
setAsciiStream(int parameterIndex, InputStream x)
Sets the designated parameter to the given input stream.void
setAsciiStream(int parameterIndex, InputStream x, long length)
Sets the designated parameter to the given input stream, which will have the specified number of bytes.void
setAsciiStream(String parameterName, InputStream x)
Sets the designated parameter to the given input stream.void
setAsciiStream(String parameterName, InputStream x, long length)
Sets the designated parameter to the given input stream, which will have the specified number of bytes.void
setBinaryStream(int parameterIndex, InputStream x)
Sets the designated parameter to the given input stream.void
setBinaryStream(int parameterIndex, InputStream x, long length)
Sets the designated parameter to the given input stream, which will have the specified number of bytes.void
setBinaryStream(String parameterName, InputStream x)
Sets the designated parameter to the given input stream.void
setBinaryStream(String parameterName, InputStream x, long length)
Sets the designated parameter to the given input stream, which will have the specified number of bytes.void
setBlob(int parameterIndex, InputStream inputStream)
Sets the designated parameter to aInputStream
object.void
setBlob(int parameterIndex, InputStream inputStream, long length)
Sets the designated parameter to aInputStream
object.void
setBlob(String parameterName, InputStream inputStream)
Sets the designated parameter to aInputStream
object.void
setBlob(String parameterName, InputStream inputStream, long length)
Sets the designated parameter to aInputStream
object.void
setBlob(String parameterName, Blob x)
Sets the designated parameter to the givenjava.sql.Blob
object.void
setCharacterStream(int parameterIndex, Reader reader)
Sets the designated parameter to the givenReader
object.void
setCharacterStream(int parameterIndex, Reader reader, long length)
Sets the designated parameter to the givenReader
object, which is the given number of characters long.void
setCharacterStream(String parameterName, Reader reader)
Sets the designated parameter to the givenReader
object.void
setCharacterStream(String parameterName, Reader reader, long length)
Sets the designated parameter to the givenReader
object, which is the given number of characters long.void
setClob(int parameterIndex, Reader reader)
Sets the designated parameter to aReader
object.void
setClob(int parameterIndex, Reader reader, long length)
Sets the designated parameter to aReader
object.void
setClob(String parameterName, Reader reader)
Sets the designated parameter to aReader
object.void
setClob(String parameterName, Reader reader, long length)
Sets the designated parameter to aReader
object.void
setClob(String parameterName, Clob x)
Sets the designated parameter to the givenjava.sql.Clob
object.void
setNCharacterStream(int parameterIndex, Reader value)
Sets the designated parameter to aReader
object.void
setNCharacterStream(int parameterIndex, Reader value, long length)
Sets the designated parameter to aReader
object.void
setNCharacterStream(String parameterName, Reader value)
Sets the designated parameter to aReader
object.void
setNCharacterStream(String parameterName, Reader value, long length)
Sets the designated parameter to aReader
object.void
setNClob(int parameterIndex, Reader reader)
Sets the designated parameter to aReader
object.void
setNClob(int parameterIndex, Reader reader, long length)
Sets the designated parameter to aReader
object.void
setNClob(int parameterIndex, NClob value)
Sets the designated parameter to ajava.sql.NClob
object.void
setNClob(String parameterName, Reader reader)
Sets the designated parameter to aReader
object.void
setNClob(String parameterName, Reader reader, long length)
Sets the designated parameter to aReader
object.void
setNClob(String parameterName, NClob reader)
Sets the designated parameter to aReader
object.void
setNString(int parameterIndex, String value)
Sets the designated parameter to the givenString
object.void
setNString(String parameterName, String value)
Sets the designated parameter to the givenString
object.void
setObject(String parameterName, Object parameterValue, SQLType targetSqlType)
Sets the value of the designated parameter with the given object.void
setObject(String parameterName, Object parameterValue, SQLType targetSqlType, int scaleOrLength)
Sets the value of the designated parameter with the given object.void
setPoolable(boolean poolable)
Requests that aStatement
be pooled or not pooled.void
setRowId(int parameterIndex, RowId x)
Sets the designated parameter to the givenjava.sql.RowId
object.void
setRowId(String parameterName, RowId x)
Sets the designated parameter to the givenjava.sql.RowId
object.void
setSQLXML(int parameterIndex, SQLXML xmlObject)
Sets the designated parameter to the givenjava.sql.SQLXML
object.void
setSQLXML(String parameterName, SQLXML xmlObject)
Sets the designated parameter to the givenjava.sql.SQLXML
object.<T> T
unwrap(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.Reader
object in the Java programming language.- Parameters:
parameterIndex
- the first parameter is 1, the second is 2, ...- Returns:
- a
java.io.Reader
object that contains the parameter value; if the value is SQLNULL
, the value returned isnull
in 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.Reader
object in the Java programming language.- Parameters:
parameterName
- the name of the parameter- Returns:
- a
java.io.Reader
object that contains the parameter value; if the value is SQLNULL
, the value returned isnull
in 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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.Reader
object in the Java programming language. It is intended for use when accessingNCHAR
,NVARCHAR
andLONGNVARCHAR
parameters.- Parameters:
parameterIndex
- the first parameter is 1, the second is 2, ...- Returns:
- a
java.io.Reader
object that contains the parameter value; if the value is SQLNULL
, the value returned isnull
in 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
SQLFeatureNotSupportedException
- 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.Reader
object in the Java programming language. It is intended for use when accessingNCHAR
,NVARCHAR
andLONGNVARCHAR
parameters.- Parameters:
parameterName
- the name of the parameter- Returns:
- a
java.io.Reader
object that contains the parameter value; if the value is SQLNULL
, the value returned isnull
in 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 JDBCNCLOB
parameter as ajava.sql.NClob
object 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
NClob
object in the Java programming language. If the value was SQLNULL
, the valuenull
is 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 JDBCNCLOB
parameter as ajava.sql.NClob
object in the Java programming language.- Parameters:
parameterName
- the name of the parameter- Returns:
- the parameter value as a
NClob
object in the Java programming language. If the value was SQLNULL
, the valuenull
is 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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
,NVARCHAR
orLONGNVARCHAR
parameter as aString
in the Java programming language. For the fixed-length type JDBCNCHAR
, theString
object returned has exactly the same value the SQLNCHAR
value 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
String
object that maps anNCHAR
,NVARCHAR
orLONGNVARCHAR
value - Throws:
SQLException
- if the parameterIndex is not valid; if a database access error occurs or this method is called on a closedCallableStatement
SQLFeatureNotSupportedException
- 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
,NVARCHAR
orLONGNVARCHAR
parameter as aString
in the Java programming language. For the fixed-length type JDBCNCHAR
, theString
object returned has exactly the same value the SQLNCHAR
value had in the database, including any padding added by the database.- Parameters:
parameterName
- the name of the parameter- Returns:
- a
String
object that maps anNCHAR
,NVARCHAR
orLONGNVARCHAR
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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 JDBCROWID
parameter as ajava.sql.RowId
object.- Parameters:
parameterIndex
- the first parameter is 1, the second is 2,...- Returns:
- a
RowId
object that represents the JDBCROWID
value is used as the designated parameter. If the parameter contains a SQLNULL
, then anull
value is returned. - Throws:
SQLException
- if the parameterIndex is not valid; if a database access error occurs or this method is called on a closedCallableStatement
SQLFeatureNotSupportedException
- 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 JDBCROWID
parameter as ajava.sql.RowId
object.- Parameters:
parameterName
- the name of the parameter- Returns:
- a
RowId
object that represents the JDBCROWID
value is used as the designated parameter. If the parameter contains a SQLNULL
, then anull
value 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 XML
parameter as ajava.sql.SQLXML
object in the Java programming language.- Parameters:
parameterIndex
- index of the first parameter is 1, the second is 2, ...- Returns:
- a
SQLXML
object that maps anSQL XML
value - Throws:
SQLException
- if the parameterIndex is not valid; if a database access error occurs or this method is called on a closedCallableStatement
SQLFeatureNotSupportedException
- 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 XML
parameter as ajava.sql.SQLXML
object in the Java programming language.- Parameters:
parameterName
- the name of the parameter- Returns:
- a
SQLXML
object that maps anSQL XML
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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 aLONGVARCHAR
parameter, 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
setAsciiStream
which 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 aLONGVARCHAR
parameter, 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 aLONGVARBINARY
parameter, it may be more practical to send it via ajava.io.InputStream
object. 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
setBinaryStream
which 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 aLONGVARBINARY
parameter, it may be more practical to send it via ajava.io.InputStream
object. 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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.Blob
object. The driver converts this to an SQLBLOB
value when it sends it to the database.- Parameters:
parameterName
- the name of the parameterx
- aBlob
object that maps an SQLBLOB
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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 aInputStream
object. 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 thesetBinaryStream
method is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as aLONGVARBINARY
or aBLOB
Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setBlob
which 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 aInputStream
object. Theinputstream
must contain the number of characters specified by length, otherwise aSQLException
will be generated when theCallableStatement
is 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 thesetBinaryStream
method is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as aLONGVARBINARY
or 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 givenReader
object. When a very large UNICODE value is input to aLONGVARCHAR
parameter, it may be more practical to send it via ajava.io.Reader
object. 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
setCharacterStream
which takes a length parameter.- Parameters:
parameterName
- the name of the parameterreader
- thejava.io.Reader
object 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 givenReader
object, which is the given number of characters long. When a very large UNICODE value is input to aLONGVARCHAR
parameter, it may be more practical to send it via ajava.io.Reader
object. 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.Reader
object 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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.Clob
object. The driver converts this to an SQLCLOB
value when it sends it to the database.- Parameters:
parameterName
- the name of the parameterx
- aClob
object that maps an SQLCLOB
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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 aReader
object. 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 thesetCharacterStream
method is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as aLONGVARCHAR
or aCLOB
Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setClob
which 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 aReader
object. TheReader
reads 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
setNCharacterStream
which 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 aReader
object. TheReader
reads 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 aReader
object. 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 thesetCharacterStream
method is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as aLONGNVARCHAR
or aNCLOB
Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setNClob
which 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 aReader
object. Thereader
must contain the number of characters specified by length otherwise aSQLException
will be generated when theCallableStatement
is 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 thesetCharacterStream
method is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as aLONGVARCHAR
or 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 aReader
object. 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 thesetCharacterStream
method is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as aLONGNVARCHAR
or aNCLOB
Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setNClob
which 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 aReader
object. Thereader
must contain the number of characters specified by length otherwise aSQLException
will be generated when theCallableStatement
is 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 thesetCharacterStream
method is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as aLONGNVARCHAR
or 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 givenString
object. The driver converts this to a SQLNCHAR
orNVARCHAR
orLONGNVARCHAR
- 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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.RowId
object. The driver converts this to a SQLROWID
when 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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.SQLXML
object. The driver converts this to anSQL XML
value when it sends it to the database.- Parameters:
parameterName
- the name of the parameterxmlObject
- aSQLXML
object that maps anSQL XML
value- Throws:
SQLException
- if parameterName does not correspond to a named parameter; if a database access error occurs; this method is called on a closedCallableStatement
or thejava.xml.transform.Result
,Writer
orOutputStream
has not been closed for theSQLXML
objectSQLFeatureNotSupportedException
- if the JDBC driver does not support this method- Since:
- 1.6
-
setAsciiStream
public void setAsciiStream(int parameterIndex, InputStream x) throws SQLException
Sets the designated parameter to the given input stream. When a very large ASCII value is input to aLONGVARCHAR
parameter, 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
setAsciiStream
which 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 closedPreparedStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support this method- Since:
- 1.6
-
setAsciiStream
public void setAsciiStream(int parameterIndex, 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 aLONGVARCHAR
parameter, 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 SQLException
Sets the designated parameter to the given input stream. When a very large binary value is input to aLONGVARBINARY
parameter, it may be more practical to send it via ajava.io.InputStream
object. 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
setBinaryStream
which 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 closedPreparedStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support this method- Since:
- 1.6
-
setBinaryStream
public void setBinaryStream(int parameterIndex, 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 aLONGVARBINARY
parameter, it may be more practical to send it via ajava.io.InputStream
object. 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 SQLException
Sets the designated parameter to aInputStream
object. 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 thesetBinaryStream
method is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as aLONGVARBINARY
or aBLOB
Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setBlob
which 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 closedPreparedStatement
or 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 SQLException
Sets the designated parameter to aInputStream
object. The inputstream must contain the number of characters specified by length otherwise aSQLException
will be generated when thePreparedStatement
is 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 thesetBinaryStream
method is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as aLONGVARBINARY
or 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 SQLException
Sets the designated parameter to the givenReader
object. When a very large UNICODE value is input to aLONGVARCHAR
parameter, it may be more practical to send it via ajava.io.Reader
object. 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
setCharacterStream
which takes a length parameter.- Parameters:
parameterIndex
- the first parameter is 1, the second is 2, ...reader
- thejava.io.Reader
object 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 closedPreparedStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support this method- Since:
- 1.6
-
setCharacterStream
public void setCharacterStream(int parameterIndex, Reader reader, long length) throws SQLException
Sets the designated parameter to the givenReader
object, which is the given number of characters long. When a very large UNICODE value is input to aLONGVARCHAR
parameter, it may be more practical to send it via ajava.io.Reader
object. 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.Reader
object 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 SQLException
Sets the designated parameter to aReader
object. 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 thesetCharacterStream
method is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as aLONGVARCHAR
or aCLOB
Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setClob
which 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 closedPreparedStatement
or 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 SQLException
Sets the designated parameter to aReader
object. The reader must contain the number of characters specified by length otherwise aSQLException
will be generated when thePreparedStatement
is 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 thesetCharacterStream
method is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as aLONGVARCHAR
or 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 closedPreparedStatement
or 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 SQLException
Sets the designated parameter to aReader
object. TheReader
reads 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
setNCharacterStream
which 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 closedPreparedStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support this method- Since:
- 1.6
-
setNCharacterStream
public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException
Sets the designated parameter to aReader
object. TheReader
reads 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 closedPreparedStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support this method- Since:
- 1.6
-
setNClob
public void setNClob(int parameterIndex, NClob value) throws SQLException
Sets the designated parameter to ajava.sql.NClob
object. The driver converts this to a SQLNCLOB
value 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 closedPreparedStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support this method- Since:
- 1.6
-
setNClob
public void setNClob(int parameterIndex, Reader reader) throws SQLException
Sets the designated parameter to aReader
object. 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 thesetCharacterStream
method is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as aLONGNVARCHAR
or aNCLOB
Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of
setNClob
which 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 closedPreparedStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support this method- Since:
- 1.6
-
setNClob
public void setNClob(int parameterIndex, Reader reader, long length) throws SQLException
Sets the designated parameter to aReader
object. The reader must contain the number of characters specified by length otherwise aSQLException
will be generated when thePreparedStatement
is 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 thesetCharacterStream
method is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as aLONGNVARCHAR
or 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 closedPreparedStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support this method- Since:
- 1.6
-
setNString
public void setNString(int parameterIndex, String value) throws SQLException
Sets the designated parameter to the givenString
object. The driver converts this to a SQLNCHAR
orNVARCHAR
orLONGNVARCHAR
value (depending on the argument's size relative to the driver's limits onNVARCHAR
values) 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 closedPreparedStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support this method- Since:
- 1.6
-
setRowId
public void setRowId(int parameterIndex, RowId x) throws SQLException
Sets the designated parameter to the givenjava.sql.RowId
object. The driver converts this to a SQLROWID
value 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 closedPreparedStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support this method- Since:
- 1.6
-
setSQLXML
public void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException
Sets the designated parameter to the givenjava.sql.SQLXML
object. The driver converts this to an SQLXML
value when it sends it to the database.- Parameters:
parameterIndex
- index of the first parameter is 1, the second is 2, ...xmlObject
- aSQLXML
object that maps an SQLXML
value- 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
or thejava.xml.transform.Result
,Writer
orOutputStream
has not been closed for theSQLXML
objectSQLFeatureNotSupportedException
- if the JDBC driver does not support this method- Since:
- 1.6
-
isClosed
public boolean isClosed() throws SQLException
Retrieves whether thisStatement
object has been closed. AStatement
is closed if the method close has been called on it, or if it is automatically closed.- Returns:
- true if this
Statement
object is closed; false if it is still open - Throws:
SQLException
- if a database access error occurs- Since:
- 1.6
-
isPoolable
public boolean isPoolable() throws SQLException
Returns a value indicating whether theStatement
is poolable or not.- Returns:
true
if theStatement
is poolable;false
otherwise- 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 SQLException
Requests that aStatement
be 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, aStatement
is not poolable when created, and aPreparedStatement
andCallableStatement
are 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 callingisWrapperFor
on 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 tounwrap
so that callers can use this method to avoid expensiveunwrap
calls that may fail. If this method returns true then callingunwrap
with 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
unwrap
recursively on the wrapped object or a proxy for that result. If the receiver is not a wrapper and does not implement the interface, then anSQLException
is 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 thisPreparedStatement
object and returns theResultSet
object generated by the query.- Returns:
- a
ResultSet
object that contains the data produced by the query; nevernull
- Throws:
SQLException
- if a database access error occurs; this method is called on a closedPreparedStatement
or the SQL statement does not return aResultSet
object
-
executeQuery
public ResultSet executeQuery(String sql) throws SQLException
Executes the given SQL statement, which returns a singleResultSet
object.- Parameters:
sql
- an SQL statement to be sent to the database, typically a static SQLSELECT
statement- Returns:
- a
ResultSet
object that contains the data produced by the given query; nevernull
- Throws:
SQLException
- if a database access error occurs, this method is called on a closedStatement
or the given SQL statement produces anything other than a singleResultSet
object
-
getGeneratedKeys
public ResultSet getGeneratedKeys() throws SQLException
Retrieves any auto-generated keys created as a result of executing thisStatement
object. If thisStatement
object did not generate any keys, an emptyResultSet
object 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
ResultSet
object containing the auto-generated key(s) generated by the execution of thisStatement
object - Throws:
SQLException
- if a database access error occurs or this method is called on a closedStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support this method- Since:
- 1.4
-
getResultSet
public ResultSet getResultSet() throws SQLException
Retrieves the current result as aResultSet
object. This method should be called only once per result.- Returns:
- the current result as a
ResultSet
object ornull
if 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.DECIMAL
orjava.sql.JDBCType.NUMERIC types
, this is the number of digits after the decimal point. For Java Object typesInputStream
andReader
, 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 closedCallableStatement
or 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 closedCallableStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support the specified targetSqlType
-
registerOutParameter
public void registerOutParameter(int parameterIndex, SQLType sqlType) throws SQLException
Registers the OUT parameter in ordinal positionparameterIndex
to the JDBC typesqlType
.- Parameters:
parameterIndex
- the first parameter is 1, the second is 2, and so onsqlType
- the JDBC type code defined bySQLType
to use to register the OUT Parameter. If the parameter is of JDBC typeJDBCType.NUMERIC
orJDBCType.DECIMAL
, the version ofregisterOutParameter
that 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 closedCallableStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support the specified sqlType
-
registerOutParameter
public void registerOutParameter(int parameterIndex, SQLType sqlType, int scale) throws SQLException
Registers the parameter in ordinal positionparameterIndex
to be of JDBC typesqlType
. This version ofregisterOutParameter
should be used when the parameter is of JDBC typeJDBCType.NUMERIC
orJDBCType.DECIMAL
.- Parameters:
parameterIndex
- the first parameter is 1, the second is 2, and so onsqlType
- the JDBC type code defined bySQLType
to 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 closedCallableStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support the specified sqlType
-
registerOutParameter
public void registerOutParameter(int parameterIndex, SQLType sqlType, String typeName) throws SQLException
Registers the designated output parameter. This version of the methodregisterOutParameter
should be used for a user-defined orREF
output parameter.- Parameters:
parameterIndex
- the first parameter is 1, the second is 2,...sqlType
- the JDBC type code defined bySQLType
to 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 closedCallableStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support the specified sqlType
-
registerOutParameter
public void registerOutParameter(String parameterName, SQLType sqlType) throws SQLException
Registers the OUT parameter namedparameterName
to the JDBC typesqlType
.- Parameters:
parameterName
- the name of the parametersqlType
- the JDBC type code defined bySQLType
to use to register the OUT Parameter. If the parameter is of JDBC typeJDBCType.NUMERIC
orJDBCType.DECIMAL
, the version ofregisterOutParameter
that 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 namedparameterName
to be of JDBC typesqlType
. This version ofregisterOutParameter
should be used when the parameter is of JDBC typeJDBCType.NUMERIC
orJDBCType.DECIMAL
.- Parameters:
parameterName
- the name of the parametersqlType
- the JDBC type code defined bySQLType
to 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 closedCallableStatement
SQLFeatureNotSupportedException
- 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 methodregisterOutParameter
should be used for a user-named or REF output parameter.- Parameters:
parameterName
- the name of the parametersqlType
- the JDBC type code defined bySQLType
to 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 closedCallableStatement
SQLFeatureNotSupportedException
- if the JDBC driver does not support the specified sqlType or if the JDBC driver does not support this method
-
-