|
Components |
|
| |||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
com.sas.net.sharenet.ShareNetPreparedStatement
public class ShareNetPreparedStatement
This is the SAS/SHARE Driver for JDBC implementation for java.sql.PreparedStatement.
Field Summary |
---|
Fields inherited from class com.sas.net.sharenet.ShareNetStatement |
---|
connection, describe, fetchSize, maxFieldSize, months, msg, snresultset |
Method Summary | |
---|---|
void |
addBatch()
JDBC 2.0 Adds a set of parameters to the batch. |
void |
clearParameters()
Clears all the parameters. |
boolean |
execute()
Executes a query. |
java.sql.ResultSet |
executeQuery()
Executes a prepared SQL query and returns the ResultSet. |
int |
executeUpdate()
Executes an SQL INSERT, UPDATE or DELETE statement. |
java.sql.ResultSetMetaData |
getMetaData()
JDBC 2.0 Gets the number, types and properties of a ResultSet's columns as a ResultSetMetaData object. |
java.sql.ParameterMetaData |
getParameterMetaData()
Retrieves the number, types and properties of this PreparedStatement object's parameters. |
java.sql.ResultSetMetaData |
getResultSetMetaData()
Deprecated. |
void |
setArray(int parameterIndex,
java.sql.Array x)
JDBC 2.0 Sets a parameter to an Array object. |
void |
setAsciiStream(int parameterIndex,
java.io.InputStream x)
This method is not supported. |
void |
setAsciiStream(int parameterIndex,
java.io.InputStream x,
int length)
Sets a parameter to a Java java.io.InputStream. |
void |
setAsciiStream(int parameterIndex,
java.io.InputStream x,
long length)
This method is not supported. |
void |
setBigDecimal(int parameterIndex,
java.math.BigDecimal x)
Sets a parameter to a Java BigDecimal value. |
void |
setBinaryStream(int parameterIndex,
java.io.InputStream x)
This method is not supported. |
void |
setBinaryStream(int parameterIndex,
java.io.InputStream x,
int length)
Sets a parameter to a Java java.io.InputStream. |
void |
setBinaryStream(int parameterIndex,
java.io.InputStream x,
long length)
This method is not supported. |
void |
setBlob(int parameterIndex,
java.sql.Blob x)
JDBC 2.0 Sets a parameter to a BLOB object. |
void |
setBlob(int parameterIndex,
java.io.InputStream inputStream)
This method is not supported. |
void |
setBlob(int parameterIndex,
java.io.InputStream inputStream,
long length)
This method is not supported. |
void |
setBoolean(int parameterIndex,
boolean x)
Sets a parameter to a Java Boolean value. |
void |
setByte(int parameterIndex,
byte x)
Sets a parameter to a Java byte value. |
void |
setBytes(int parameterIndex,
byte[] x)
Sets a parameter to a Java byte array value. |
void |
setCharacterStream(int parameterIndex,
java.io.Reader reader)
This method is not supported. |
void |
setCharacterStream(int parameterIndex,
java.io.Reader reader,
int length)
JDBC 2.0 Sets a parameter to java.io.Reader object. |
void |
setCharacterStream(int parameterIndex,
java.io.Reader reader,
long length)
This method is not supported. |
void |
setClob(int parameterIndex,
java.sql.Clob x)
JDBC 2.0 Sets a parameter to a CLOB object. |
void |
setClob(int parameterIndex,
java.io.Reader reader)
This method is not supported. |
void |
setClob(int parameterIndex,
java.io.Reader reader,
long length)
This method is not supported. |
void |
setDate(int parameterIndex,
java.sql.Date x)
Sets a parameter to a Java java.sql.Date value. |
void |
setDate(int parameterIndex,
java.sql.Date x,
java.util.Calendar cal)
JDBC 2.0 Sets a parameter to a java.sql.Date value. |
void |
setDouble(int parameterIndex,
double x)
Sets a parameter to a Java double value. |
void |
setFloat(int parameterIndex,
float x)
Sets a parameter to a Java float value. |
void |
setInt(int parameterIndex,
int x)
Sets a parameter to a Java int value. |
void |
setLong(int parameterIndex,
long x)
Sets a parameter to a Java long value. |
void |
setNCharacterStream(int parameterIndex,
java.io.Reader value)
This method is not supported. |
void |
setNCharacterStream(int parameterIndex,
java.io.Reader value,
long length)
This method is not supported. |
void |
setNClob(int parameterIndex,
java.sql.NClob value)
This method is not supported. |
void |
setNClob(int parameterIndex,
java.io.Reader reader)
This method is not supported. |
void |
setNClob(int parameterIndex,
java.io.Reader reader,
long length)
This method is not supported. |
void |
setNString(int parameterIndex,
java.lang.String value)
This method is not supported. |
void |
setNull(int parameterIndex,
int sqlType)
Sets a parameter to SQL NULL. |
void |
setNull(int parameterIndex,
int sqlType,
java.lang.String x)
JDBC 2.0 Sets a parameter to SQL NULL. |
void |
setObject(int parameterIndex,
java.lang.Object x)
Sets a parameter to the default type. |
void |
setObject(int parameterIndex,
java.lang.Object x,
int sqlType)
Sets a parameter to the input type. |
void |
setObject(int parameterIndex,
java.lang.Object x,
int sqlType,
int scale)
Sets a parameter to the input type. |
void |
setRef(int parameterIndex,
java.sql.Ref x)
JDBC 2.0 Sets a parameter to a REF(<structured-type>) object. |
void |
setRowId(int parameterIndex,
java.sql.RowId x)
This method is not supported. |
void |
setShort(int parameterIndex,
short x)
Sets a parameter to a Java short value. |
void |
setSQLXML(int parameterIndex,
java.sql.SQLXML xmlObject)
This method is not supported. |
void |
setString(int parameterIndex,
java.lang.String x)
Sets a parameter to a Java string value. |
void |
setTime(int parameterIndex,
java.sql.Time x)
Sets a parameter to a Java java.sql.Time value. |
void |
setTime(int parameterIndex,
java.sql.Time x,
java.util.Calendar cal)
JDBC 2.0 Sets a parameter to a java.sql.Time value. |
void |
setTimestamp(int parameterIndex,
java.sql.Timestamp x)
Sets a parameter to a Java java.sql.Timestamp value. |
void |
setTimestamp(int parameterIndex,
java.sql.Timestamp x,
java.util.Calendar cal)
JDBC 2.0 Sets a parameter to a java.sql.Timestamp value. |
void |
setUnicodeStream(int parameterIndex,
java.io.InputStream x,
int length)
Deprecated. |
void |
setURL(int parameterIndex,
java.net.URL x)
Sets the designated parameter to the given java.net.URL value. |
Method Detail |
---|
public java.sql.ResultSet executeQuery() throws java.sql.SQLException
executeQuery
in interface java.sql.PreparedStatement
java.sql.SQLException
- This exception is thrown if a ShareNetException is detected.public int executeUpdate() throws java.sql.SQLException
executeUpdate
in interface java.sql.PreparedStatement
java.sql.SQLException
- This exception is thrown if a ShareNetException is detected.public void setNull(int parameterIndex, int sqlType) throws java.sql.SQLException
setNull
in interface java.sql.PreparedStatement
parameterIndex
- The first parameter is 1, the second parameter is 2, and so on.sqlType
- An SQL type code that is defined by java.sql.Types.
java.sql.SQLException
- This exception is thrown if a ShareNetException is detected or if
the sqlType is not FLOAT, DOUBLE, INTEGER, TIME, DATE or TIMESTAMP.
SAS software does not allow other types to be NULL.public void setBoolean(int parameterIndex, boolean x) throws java.sql.SQLException
setBoolean
in interface java.sql.PreparedStatement
java.sql.SQLException
- This exception is always thrown because SAS software
does not support the SQL type BIT.public void setByte(int parameterIndex, byte x) throws java.sql.SQLException
setByte
in interface java.sql.PreparedStatement
java.sql.SQLException
- This exception is always thrown because SAS software
does not support SQL type TINYINT.public void setShort(int parameterIndex, short x) throws java.sql.SQLException
setShort
in interface java.sql.PreparedStatement
java.sql.SQLException
- This exception is always thrown because SAS software
does not support SQL type SMALLINT.public void setInt(int parameterIndex, int x) throws java.sql.SQLException
setInt
in interface java.sql.PreparedStatement
parameterIndex
- The first parameter is 1, the second parameter is 2, and so on.x
- An int value.
java.sql.SQLException
- This exception is thrown if parameterIndex is not valid.public void setLong(int parameterIndex, long x) throws java.sql.SQLException
setLong
in interface java.sql.PreparedStatement
java.sql.SQLException
- This exception is always thrown because SAS software
does not support SQL type BIGINT.public void setFloat(int parameterIndex, float x) throws java.sql.SQLException
setFloat
in interface java.sql.PreparedStatement
parameterIndex
- The first parameter is 1, the second parameter is 2, and so on.x
- float value.
java.sql.SQLException
- This exception is thrown if parameter index is not valid.public void setDouble(int parameterIndex, double x) throws java.sql.SQLException
setDouble
in interface java.sql.PreparedStatement
parameterIndex
- The first parameter is 1, the second parameter is 2, and so on.x
- double value.
java.sql.SQLException
- This exception is thrown if parameter index is not valid.public void setBigDecimal(int parameterIndex, java.math.BigDecimal x) throws java.sql.SQLException
setBigDecimal
in interface java.sql.PreparedStatement
java.sql.SQLException
- This exception is always thrown because SAS software
does not support SQL type Numericpublic void setString(int parameterIndex, java.lang.String x) throws java.sql.SQLException
setString
in interface java.sql.PreparedStatement
parameterIndex
- The first parameter is 1, the second parameter is 2, and so on.x
- String value.
java.sql.SQLException
- This exception is thrown if parameter index is not valid.public void setBytes(int parameterIndex, byte[] x) throws java.sql.SQLException
setBytes
in interface java.sql.PreparedStatement
java.sql.SQLException
- This exception is always thrown because SAS software
does not support SQL type BINARY.public void setDate(int parameterIndex, java.sql.Date x) throws java.sql.SQLException
setDate
in interface java.sql.PreparedStatement
parameterIndex
- The first parameter is 1, the second parameter is 2, and so on.x
- java.sql.Date value.
java.sql.SQLException
- This exception is thrown if parameter index is not valid.public void setTime(int parameterIndex, java.sql.Time x) throws java.sql.SQLException
setTime
in interface java.sql.PreparedStatement
parameterIndex
- The first parameter is 1, the second parameter is 2, and so on.x
- java.sql.Time value.
java.sql.SQLException
- This exception is thrown if parameter index is not valid.public void setTimestamp(int parameterIndex, java.sql.Timestamp x) throws java.sql.SQLException
setTimestamp
in interface java.sql.PreparedStatement
parameterIndex
- The first parameter is 1, the second parameter is 2, and so on.x
- java.sql.Timestamp value.
java.sql.SQLException
- This exception is thrown if parameter index is not valid.public void setAsciiStream(int parameterIndex, java.io.InputStream x, int length) throws java.sql.SQLException
setAsciiStream
in interface java.sql.PreparedStatement
java.sql.SQLException
- This exception is always thrown because SAS software
does not support SQL type LONGVARCHAR.public void setUnicodeStream(int parameterIndex, java.io.InputStream x, int length) throws java.sql.SQLException
setUnicodeStream
in interface java.sql.PreparedStatement
java.sql.SQLException
- This exception is always thrown because SAS software
does not support SQL type LONGVARCHAR.public void setBinaryStream(int parameterIndex, java.io.InputStream x, int length) throws java.sql.SQLException
setBinaryStream
in interface java.sql.PreparedStatement
java.sql.SQLException
- This exception is always thrown because SAS software
does not support SQL type LONGVARBINARY.public void clearParameters() throws java.sql.SQLException
clearParameters
in interface java.sql.PreparedStatement
java.sql.SQLException
- This exception is required by the interface, but it is never thrown.public void setObject(int parameterIndex, java.lang.Object x, int sqlType, int scale) throws java.sql.SQLException
setObject
in interface java.sql.PreparedStatement
parameterIndex
- The first parameter is 1, the second parameter is 2, and so on.x
- An input object.sqlType
- The target SQL type for the object.scale
- This parameter is ignored. SAS software does not support Decimal or Numeric data
types.
java.sql.SQLException
- This exception may be thrown.public void setObject(int parameterIndex, java.lang.Object x) throws java.sql.SQLException
setObject
in interface java.sql.PreparedStatement
parameterIndex
- The first parameter is 1, the second parameter is 2, and so on.x
- An input object.
java.sql.SQLException
- This exception may be thrown.public void setObject(int parameterIndex, java.lang.Object x, int sqlType) throws java.sql.SQLException
setObject
in interface java.sql.PreparedStatement
parameterIndex
- The first parameter is 1, the second is 2, and so on.x
- An input object.sqlType
- The target SQL type for the object.
java.sql.SQLException
- This exception may be thrown.public boolean execute() throws java.sql.SQLException
execute
in interface java.sql.PreparedStatement
java.sql.SQLException
- This exception may be thrown.ShareNetStatement.execute(java.lang.String)
public java.sql.ResultSetMetaData getResultSetMetaData() throws java.sql.SQLException
java.sql.SQLException
- This exception is thrown if an error condition is detected.execute()
public void addBatch() throws java.sql.SQLException
addBatch
in interface java.sql.PreparedStatement
java.sql.SQLException
- This exception is always thrown.ShareNetStatement.addBatch(java.lang.String)
public void setCharacterStream(int parameterIndex, java.io.Reader reader, int length) throws java.sql.SQLException
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
setCharacterStream
in interface java.sql.PreparedStatement
parameterIndex
- The parameter index. The first parameter is 1, the second is 2, and so on.x
- The java reader object which contains the UNICODE data.length
- The number of characters in the stream.
java.sql.SQLException
- This exception is always thrownpublic void setRef(int parameterIndex, java.sql.Ref x) throws java.sql.SQLException
setRef
in interface java.sql.PreparedStatement
parameterIndex
- The parameter index. The first parameter is 1, the second is 2, and so on.x
- An object representing data of an SQL REF Type .
java.sql.SQLException
- This exception is always thrown.public void setBlob(int parameterIndex, java.sql.Blob x) throws java.sql.SQLException
setBlob
in interface java.sql.PreparedStatement
parameterIndex
- The parameter index. The first parameter is 1, the second is 2, and so on.x
- An object representing a BLOB.
java.sql.SQLException
- This exception is always thrown.public void setClob(int parameterIndex, java.sql.Clob x) throws java.sql.SQLException
setClob
in interface java.sql.PreparedStatement
parameterIndex
- The parameter index. The first parameter is 1, the second is 2, and so on.x
- An object representing a CLOB.
java.sql.SQLException
- This exception is always thrown.public void setArray(int parameterIndex, java.sql.Array x) throws java.sql.SQLException
setArray
in interface java.sql.PreparedStatement
parameterIndex
- The parameter index. The first parameter is 1, the second is 2, and so on.x
- An object representing an SQL array.
java.sql.SQLException
- This exception is always thrown.public java.sql.ResultSetMetaData getMetaData() throws java.sql.SQLException
getMetaData
in interface java.sql.PreparedStatement
java.sql.SQLException
- This exception is thrown if a database error occurs or if the result set is NULL.public void setDate(int parameterIndex, java.sql.Date x, java.util.Calendar cal) throws java.sql.SQLException
setDate
in interface java.sql.PreparedStatement
parameterIndex
- The parameter index. The first parameter is 1, the second is 2, and so on.x
- The parameter value, a java.sql.Date object.cal
- A Calendar object. Ignored if NULL.
java.sql.SQLException
- This exception may be thrown.public void setTime(int parameterIndex, java.sql.Time x, java.util.Calendar cal) throws java.sql.SQLException
setTime
in interface java.sql.PreparedStatement
parameterIndex
- The parameter index. The first parameter is 1, the second is 2, and so on.x
- The parameter value, a java.sql.Time object.cal
- A Calendar object. Ignored if NULL.
java.sql.SQLException
- This exception may be thrown.public void setTimestamp(int parameterIndex, java.sql.Timestamp x, java.util.Calendar cal) throws java.sql.SQLException
setTimestamp
in interface java.sql.PreparedStatement
parameterIndex
- The parameter index. The first parameter is 1, the second is 2, and so on.x
- The parameter value, a java.sql.Timestamp value.cal
- A Calendar object. Ignored if NULL.
java.sql.SQLException
- This exception may be thrown.public void setNull(int parameterIndex, int sqlType, java.lang.String x) throws java.sql.SQLException
setNull
in interface java.sql.PreparedStatement
parameterIndex
- The parameter index. The first parameter is 1, the second parameter is 2, and so on.sqlType
- An SQL type code that is defined by java.sql.Types.x
- the fully-qualified name of an SQL user-defined type; ignored if the parameter is not a user-defined type or REF
java.sql.SQLException
- This exception is always thrown.public void setURL(int parameterIndex, java.net.URL x) throws java.sql.SQLException
java.net.URL
value. The driver converts
this to an SQL DATALINK value when it sends it to the database.
This method is not implemented.
setURL
in interface java.sql.PreparedStatement
java.sql.SQLException
- always thrown.public java.sql.ParameterMetaData getParameterMetaData() throws java.sql.SQLException
PreparedStatement
object's parameters.
This method is not implemented.
getParameterMetaData
in interface java.sql.PreparedStatement
java.sql.SQLException
- always thrown.public void setRowId(int parameterIndex, java.sql.RowId x) throws java.sql.SQLException
Sets the designated parameter to the given java.sql.RowId
object. The
driver converts this to a SQL ROWID
value when it sends it
to the database
setRowId
in interface java.sql.PreparedStatement
parameterIndex
- the first parameter is 1, the second is 2, ...x
- the parameter value
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setNString(int parameterIndex, java.lang.String value) throws java.sql.SQLException
Sets the designated paramter to the given String
object.
The driver converts this to a SQL NCHAR
or
NVARCHAR
or LONGNVARCHAR
value
(depending on the argument's
size relative to the driver's limits on NVARCHAR
values)
when it sends it to the database.
setNString
in interface java.sql.PreparedStatement
parameterIndex
- of the first parameter is 1, the second is 2, ...value
- the parameter value
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setNCharacterStream(int parameterIndex, java.io.Reader value, long length) throws java.sql.SQLException
Sets the designated parameter to a Reader
object. The
Reader
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.
setNCharacterStream
in interface java.sql.PreparedStatement
parameterIndex
- of the first parameter is 1, the second is 2, ...value
- the parameter valuelength
- the number of characters in the parameter data.
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setNClob(int parameterIndex, java.sql.NClob value) throws java.sql.SQLException
Sets the designated parameter to a java.sql.NClob
object. The driver converts this to a
SQL NCLOB
value when it sends it to the database.
setNClob
in interface java.sql.PreparedStatement
parameterIndex
- of the first parameter is 1, the second is 2, ...value
- the parameter value
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setClob(int parameterIndex, java.io.Reader reader, long length) throws java.sql.SQLException
Sets the designated parameter to a Reader
object. The reader must contain the number
of characters specified by length otherwise a SQLException
will be
generated when the PreparedStatement
is executed.
This method differs from the setCharacterStream (int, Reader, int)
method
because it informs the driver that the parameter value should be sent to
the server as a CLOB
. When the setCharacterStream
method is used, the
driver may have to do extra work to determine whether the parameter
data should be sent to the server as a LONGVARCHAR
or a CLOB
setClob
in interface java.sql.PreparedStatement
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.
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setBlob(int parameterIndex, java.io.InputStream inputStream, long length) throws java.sql.SQLException
Sets the designated parameter to a InputStream
object. The inputstream must contain the number
of characters specified by length otherwise a SQLException
will be
generated when the PreparedStatement
is executed.
This method differs from the setBinaryStream (int, InputStream, int)
method because it informs the driver that the parameter value should be
sent to the server as a BLOB
. When the setBinaryStream
method is used,
the driver may have to do extra work to determine whether the parameter
data should be sent to the server as a LONGVARBINARY
or a BLOB
setBlob
in interface java.sql.PreparedStatement
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.
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setNClob(int parameterIndex, java.io.Reader reader, long length) throws java.sql.SQLException
Sets the designated parameter to a Reader
object. The reader must contain the number
of characters specified by length otherwise a SQLException
will be
generated when the PreparedStatement
is executed.
This method differs from the setCharacterStream (int, Reader, int)
method
because it informs the driver that the parameter value should be sent to
the server as a NCLOB
. When the setCharacterStream
method is used, the
driver may have to do extra work to determine whether the parameter
data should be sent to the server as a LONGNVARCHAR
or a NCLOB
setNClob
in interface java.sql.PreparedStatement
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.
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setSQLXML(int parameterIndex, java.sql.SQLXML xmlObject) throws java.sql.SQLException
Sets the designated parameter to the given java.sql.SQLXML
object. The driver converts this to an SQL XML
value when it
sends it to the database.
setSQLXML
in interface java.sql.PreparedStatement
parameterIndex
- index of the first parameter is 1, the second is 2, ...xmlObject
- a SQLXML
object that maps an SQL XML
value
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setAsciiStream(int parameterIndex, java.io.InputStream x, long length) throws java.sql.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 a LONGVARCHAR
parameter, it may be more practical to send it via a
java.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.
setAsciiStream
in interface java.sql.PreparedStatement
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
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setBinaryStream(int parameterIndex, java.io.InputStream x, long length) throws java.sql.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 a LONGVARBINARY
parameter, it may be more practical to send it via a
java.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.
setBinaryStream
in interface java.sql.PreparedStatement
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
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setCharacterStream(int parameterIndex, java.io.Reader reader, long length) throws java.sql.SQLException
Sets the designated parameter to the given Reader
object, which is the given number of characters long.
When a very large UNICODE value is input to a LONGVARCHAR
parameter, it may be more practical to send it via a
java.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.
setCharacterStream
in interface java.sql.PreparedStatement
parameterIndex
- the first parameter is 1, the second is 2, ...reader
- the java.io.Reader
object that contains the
Unicode datalength
- the number of characters in the stream
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setAsciiStream(int parameterIndex, java.io.InputStream x) throws java.sql.SQLException
Sets the designated parameter to the given input stream.
When a very large ASCII value is input to a LONGVARCHAR
parameter, it may be more practical to send it via a
java.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.
setAsciiStream
in interface java.sql.PreparedStatement
parameterIndex
- the first parameter is 1, the second is 2, ...x
- the Java input stream that contains the ASCII parameter value
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setBinaryStream(int parameterIndex, java.io.InputStream x) throws java.sql.SQLException
Sets the designated parameter to the given input stream.
When a very large binary value is input to a LONGVARBINARY
parameter, it may be more practical to send it via a
java.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.
setBinaryStream
in interface java.sql.PreparedStatement
parameterIndex
- the first parameter is 1, the second is 2, ...x
- the java input stream which contains the binary parameter value
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setCharacterStream(int parameterIndex, java.io.Reader reader) throws java.sql.SQLException
Sets the designated parameter to the given Reader
object.
When a very large UNICODE value is input to a LONGVARCHAR
parameter, it may be more practical to send it via a
java.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.
setCharacterStream
in interface java.sql.PreparedStatement
parameterIndex
- the first parameter is 1, the second is 2, ...reader
- the java.io.Reader
object that contains the
Unicode data
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setNCharacterStream(int parameterIndex, java.io.Reader value) throws java.sql.SQLException
Sets the designated parameter to a Reader
object. The
Reader
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.
setNCharacterStream
in interface java.sql.PreparedStatement
parameterIndex
- of the first parameter is 1, the second is 2, ...value
- the parameter value
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setClob(int parameterIndex, java.io.Reader reader) throws java.sql.SQLException
Sets the designated parameter to a Reader
object.
This method differs from the setCharacterStream (int, Reader)
method
because it informs the driver that the parameter value should be sent to
the server as a CLOB
. When the setCharacterStream
method is used, the
driver may have to do extra work to determine whether the parameter
data should be sent to the server as a LONGVARCHAR
or a CLOB
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.
setClob
in interface java.sql.PreparedStatement
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.
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setBlob(int parameterIndex, java.io.InputStream inputStream) throws java.sql.SQLException
Sets the designated parameter to a InputStream
object.
This method differs from the setBinaryStream (int, InputStream)
method because it informs the driver that the parameter value should be
sent to the server as a BLOB
. When the setBinaryStream
method is used,
the driver may have to do extra work to determine whether the parameter
data should be sent to the server as a LONGVARBINARY
or a BLOB
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.
setBlob
in interface java.sql.PreparedStatement
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.
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
public void setNClob(int parameterIndex, java.io.Reader reader) throws java.sql.SQLException
Sets the designated parameter to a Reader
object.
This method differs from the setCharacterStream (int, Reader)
method
because it informs the driver that the parameter value should be sent to
the server as a NCLOB
. When the setCharacterStream
method is used, the
driver may have to do extra work to determine whether the parameter
data should be sent to the server as a LONGNVARCHAR
or a NCLOB
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.
setNClob
in interface java.sql.PreparedStatement
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.
java.sql.SQLException
- Always thrown, to indicate that this method is not
implemented.
|
Components |
|
| |||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |