- java.lang.Object
-
- javax.sql.rowset.BaseRowSet
-
- All Implemented Interfaces:
- Serializable, Cloneable
public abstract class BaseRowSet extends Object implements Serializable, Cloneable
An abstract class providing aRowSet
object with its basic functionality. The basic functions include having properties and sending event notifications, which all JavaBeansTM components must implement.1.0 Overview
TheBaseRowSet
class provides the core functionality for allRowSet
implementations, and all standard implementations may use this class in combination with one or moreRowSet
interfaces in order to provide a standard vendor-specific implementation. To clarify, all implementations must implement at least one of theRowSet
interfaces (JdbcRowSet
,CachedRowSet
,JoinRowSet
,FilteredRowSet
, orWebRowSet
). This means that any implementation that extends theBaseRowSet
class must also implement one of theRowSet
interfaces.The
BaseRowSet
class provides the following:- Properties
- Fields for storing current properties
- Methods for getting and setting properties
- Event notification
- A complete set of setter methods for setting the parameters in a
RowSet
object's command - Streams
- Fields for storing stream instances
- Constants for indicating the type of a stream
2.0 Setting Properties
All rowsets maintain a set of properties, which will usually be set using a tool. The number and kinds of properties a rowset has will vary, depending on what theRowSet
implementation does and how it gets its data. For example, rowsets that get their data from aResultSet
object need to set the properties that are required for making a database connection. If aRowSet
object uses theDriverManager
facility to make a connection, it needs to set a property for the JDBC URL that identifies the appropriate driver, and it needs to set the properties that give the user name and password. If, on the other hand, the rowset uses aDataSource
object to make the connection, which is the preferred method, it does not need to set the property for the JDBC URL. Instead, it needs to set the property for the logical name of the data source along with the properties for the user name and password.NOTE: In order to use a
DataSource
object for making a connection, theDataSource
object must have been registered with a naming service that uses the Java Naming and Directory InterfaceTM (JNDI) API. This registration is usually done by a person acting in the capacity of a system administrator.3.0 Setting the Command and Its Parameters
When a rowset gets its data from a relational database, it executes a command (a query) that produces aResultSet
object. This query is the command that is set for theRowSet
object's command property. The rowset populates itself with data by reading the data from theResultSet
object into itself. If the query contains placeholders for values to be set, theBaseRowSet
setter methods are used to set these values. All setter methods allow these values to be set tonull
if required.The following code fragment illustrates how the
CachedRowSet
TM objectcrs
might have its command property set. Note that if a tool is used to set properties, this is the code that the tool would use.crs.setCommand("SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" + "WHERE CREDIT_LIMIT > ? AND REGION = ?");
In this example, the values for
CREDIT_LIMIT
andREGION
are placeholder parameters, which are indicated with a question mark (?). The first question mark is placeholder parameter number1
, the second question mark is placeholder parameter number2
, and so on. Any placeholder parameters must be set with values before the query can be executed. To set these placeholder parameters, theBaseRowSet
class provides a set of setter methods, similar to those provided by thePreparedStatement
interface, for setting values of each data type. ARowSet
object stores the parameter values internally, and itsexecute
method uses them internally to set values for the placeholder parameters before it sends the command to the DBMS to be executed.The following code fragment demonstrates setting the two parameters in the query from the previous example.
crs.setInt(1, 5000); crs.setString(2, "West");
If theexecute
method is called at this point, the query sent to the DBMS will be:"SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" + "WHERE CREDIT_LIMIT > 5000 AND REGION = 'West'"
NOTE: SettingArray
,Clob
,Blob
andRef
objects as a command parameter, stores these values asSerialArray
,SerialClob
,SerialBlob
andSerialRef
objects respectively.4.0 Handling of Parameters Behind the Scenes
NOTE: TheBaseRowSet
class provides two kinds of setter methods, those that set properties and those that set placeholder parameters. The setter methods discussed in this section are those that set placeholder parameters.The placeholder parameters set with the
BaseRowSet
setter methods are stored as objects in an internalHashtable
object. Primitives are stored as theirObject
type. For example,byte
is stored asByte
object, andint
is stored as anInteger
object. When the methodexecute
is called, the values in theHashtable
object are substituted for the appropriate placeholder parameters in the command.A call to the method
getParams
returns the values stored in theHashtable
object as an array ofObject
instances. An element in this array may be a simpleObject
instance or an array (which is a type ofObject
). The particular setter method used determines whether an element in this array is anObject
or an array.The majority of methods for setting placeholder parameters take two parameters, with the first parameter indicating which placeholder parameter is to be set, and the second parameter giving the value to be set. Methods such as
setInt
,setString
,setBoolean
, andsetLong
fall into this category. After these methods have been called, a call to the methodgetParams
will return an array with the values that have been set. Each element in the array is anObject
instance representing the values that have been set. The order of these values in the array is determined by theint
(the first parameter) passed to the setter method. The values in the array are the values (the second parameter) passed to the setter method. In other words, the first element in the array is the value to be set for the first placeholder parameter in theRowSet
object's command. The second element is the value to be set for the second placeholder parameter, and so on.Several setter methods send the driver and DBMS information beyond the value to be set. When the method
getParams
is called after one of these setter methods has been used, the elements in the array will themselves be arrays to accommodate the additional information. In this category, the methodsetNull
is a special case because one version takes only two parameters (setNull(int parameterIndex, int SqlType)
). Nevertheless, it requires an array to contain the information that will be passed to the driver and DBMS. The first element in this array is the value to be set, which isnull
, and the second element is theint
supplied for sqlType, which indicates the type of SQL value that is being set tonull
. This information is needed by some DBMSs and is therefore required in order to ensure that applications are portable. The other version is intended to be used when the value to be set tonull
is a user-defined type. It takes three parameters (setNull(int parameterIndex, int sqlType, String typeName)
) and also requires an array to contain the information to be passed to the driver and DBMS. The first two elements in this array are the same as for the first version ofsetNull
. The third element, typeName, gives the SQL name of the user-defined type. As is true with the other setter methods, the number of the placeholder parameter to be set is indicated by an element's position in the array returned bygetParams
. So, for example, if the parameter supplied tosetNull
is2
, the second element in the array returned bygetParams
will be an array of two or three elements.Some methods, such as
setObject
andsetDate
have versions that take more than two parameters, with the extra parameters giving information to the driver or the DBMS. For example, the methodssetDate
,setTime
, andsetTimestamp
can take aCalendar
object as their third parameter. If the DBMS does not store time zone information, the drivern uses theCalendar
object to construct theDate
,Time
, orTimestamp
object being set. As is true with other methods that provide additional information, the element in the array returned bygetParams
is an array instead of a simpleObject
instance.The methods
setAsciiStream
,setBinaryStream
,setCharacterStream
, andsetUnicodeStream
(which is deprecated, so applications should usegetCharacterStream
instead) take three parameters, so for them, the element in the array returned bygetParams
is also an array. What is different about these setter methods is that in addition to the information provided by parameters, the array contains one of theBaseRowSet
constants indicating the type of stream being set.NOTE: The method
getParams
is called internally byRowSet
implementations extending this class; it is not normally called by an application programmer directly.5.0 Event Notification
TheBaseRowSet
class provides the event notification mechanism for rowsets. It contains the fieldlisteners
, methods for adding and removing listeners, and methods for notifying listeners of changes.A listener is an object that has implemented the
RowSetListener
interface. If it has been added to aRowSet
object's list of listeners, it will be notified when an event occurs on thatRowSet
object. Each listener's implementation of theRowSetListener
methods defines what that object will do when it is notified that an event has occurred.There are three possible events for a
RowSet
object:- the cursor moves
- an individual row is changed (updated, deleted, or inserted)
- the contents of the entire
RowSet
object are changed
The
BaseRowSet
method used for the notification indicates the type of event that has occurred. For example, the methodnotifyRowChanged
indicates that a row has been updated, deleted, or inserted. Each of the notification methods creates aRowSetEvent
object, which is supplied to the listener in order to identify theRowSet
object on which the event occurred. What the listener does with this information, which may be nothing, depends on how it was implemented.6.0 Default Behavior
A defaultBaseRowSet
object is initialized with many starting values. The following is true of a defaultRowSet
instance that extends theBaseRowSet
class:- Has a scrollable cursor and does not show changes made by others.
- Is updatable.
- Does not show rows that have been deleted.
- Has no time limit for how long a driver may take to
execute the
RowSet
object's command. - Has no limit for the number of rows it may contain.
- Has no limit for the number of bytes a column may contain. NOTE: This
limit applies only to columns that hold values of the
following types:
BINARY
,VARBINARY
,LONGVARBINARY
,CHAR
,VARCHAR
, andLONGVARCHAR
. - Will not see uncommitted data (make "dirty" reads).
- Has escape processing turned on.
- Has its connection's type map set to
null
. - Has an empty
Vector
object for storing the values set for the placeholder parameters in theRowSet
object's command.
If other values are desired, an application must set the property values explicitly. For example, the following line of code sets the maximum number of rows for the
CachedRowSet
object crs to 500.crs.setMaxRows(500);
Methods implemented in extensions of thisBaseRowSet
class must throw anSQLException
object for any violation of the defined assertions. Also, if the extending class overrides and reimplements anyBaseRowSet
method and encounters connectivity or underlying data source issues, that method may in addition throw anSQLException
object for that reason.- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field and Description static int
ASCII_STREAM_PARAM
A constant indicating to aRowSetReaderImpl
object that a given parameter is an ASCII stream.protected InputStream
asciiStream
TheInputStream
object that will be returned by the methodgetAsciiStream
, which is specified in theResultSet
interface.static int
BINARY_STREAM_PARAM
A constant indicating to aRowSetReaderImpl
object that a given parameter is a binary stream.protected InputStream
binaryStream
TheInputStream
object that will be returned by the methodgetBinaryStream
, which is specified in theResultSet
interface.protected Reader
charStream
TheReader
object that will be returned by the methodgetCharacterStream
, which is specified in theResultSet
interface.static int
UNICODE_STREAM_PARAM
A constant indicating to aRowSetReaderImpl
object that a given parameter is a Unicode stream.protected InputStream
unicodeStream
TheInputStream
object that will be returned by the methodgetUnicodeStream
, which is specified in theResultSet
interface.
-
Constructor Summary
Constructors Constructor and Description BaseRowSet()
Constructs a newBaseRowSet
object initialized with a defaultVector
object for itslisteners
field.
-
Method Summary
Methods Modifier and Type Method and Description void
addRowSetListener(RowSetListener listener)
The listener will be notified whenever an event occurs on thisRowSet
object.void
clearParameters()
Clears all of the current parameter values in thisRowSet
object's internal representation of the parameters to be set in thisRowSet
object's command when it is executed.String
getCommand()
Retrieves the SQL query that is the command for thisRowSet
object.int
getConcurrency()
Returns the concurrency for thisRowSet
object.String
getDataSourceName()
Returns the logical name that when supplied to a naming service that uses the Java Naming and Directory Interface (JNDI) API, will retrieve ajavax.sql.DataSource
object.boolean
getEscapeProcessing()
Ascertains whether escape processing is enabled for thisRowSet
object.int
getFetchDirection()
Retrieves thisRowSet
object's current setting for the fetch direction.int
getFetchSize()
Returns the fetch size for thisRowSet
object.int
getMaxFieldSize()
Retrieves the maximum number of bytes that can be used for a column value in thisRowSet
object.int
getMaxRows()
Retrieves the maximum number of rows that thisRowSet
object may contain.Object[]
getParams()
Retrieves an array containing the parameter values (both Objects and primitives) that have been set for thisRowSet
object's command and throws anSQLException
object if all parameters have not been set.String
getPassword()
Returns the password used to create a database connection for thisRowSet
object.int
getQueryTimeout()
Retrieves the maximum number of seconds the driver will wait for a query to execute.boolean
getShowDeleted()
Retrieves aboolean
indicating whether rows marked for deletion appear in the set of current rows.int
getTransactionIsolation()
Returns the transaction isolation property for thisRowSet
object's connection.int
getType()
Returns the type of thisRowSet
object.Map<String,Class<?>>
getTypeMap()
Retrieves the type map associated with theConnection
object for thisRowSet
object.String
getUrl()
Retrieves the JDBC URL that thisRowSet
object'sjavax.sql.Reader
object uses to make a connection with a relational database using a JDBC technology-enabled driver.String
getUsername()
Returns the user name used to create a database connection.protected void
initParams()
Performs the necessary internal configurations and initializations to allow any JDBCRowSet
implementation to start using the standard facilities provided by aBaseRowSet
instance.boolean
isReadOnly()
Returns aboolean
indicating whether thisRowSet
object is read-only.protected void
notifyCursorMoved()
Notifies all of the listeners registered with thisRowSet
object that its cursor has moved.protected void
notifyRowChanged()
Notifies all of the listeners registered with thisRowSet
object that one of its rows has changed.protected void
notifyRowSetChanged()
Notifies all of the listeners registered with thisRowSet
object that its entire contents have changed.void
removeRowSetListener(RowSetListener listener)
Removes the designated object from thisRowSet
object's list of listeners.void
setArray(int parameterIndex, Array array)
Sets the designated parameter to anArray
object in the Java programming language.void
setAsciiStream(int parameterIndex, InputStream x)
Sets the designated parameter in thisRowSet
object's command to the given input stream.void
setAsciiStream(int parameterIndex, InputStream x, int length)
Sets the designated parameter to the givenjava.io.InputStream
object, 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, int length)
Sets the designated parameter to the given input stream, which will have the specified number of bytes.void
setBigDecimal(int parameterIndex, BigDecimal x)
Sets the designated parameter to the givenjava.lang.BigDecimal
value.void
setBigDecimal(String parameterName, BigDecimal x)
Sets the designated parameter to the givenjava.math.BigDecimal
value.void
setBinaryStream(int parameterIndex, InputStream x)
Sets the designated parameter in thisRowSet
object's command to the given input stream.void
setBinaryStream(int parameterIndex, InputStream x, int length)
Sets the designated parameter to the givenjava.io.InputStream
object, 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, int length)
Sets the designated parameter to the given input stream, which will have the specified number of bytes.void
setBlob(int parameterIndex, Blob x)
Sets the designated parameter to the givenBlob
object in the Java programming language.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, Blob x)
Sets the designated parameter to the givenjava.sql.Blob
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
setBoolean(int parameterIndex, boolean x)
Sets the designated parameter to the givenboolean
in the Java programming language.void
setBoolean(String parameterName, boolean x)
Sets the designated parameter to the given Javaboolean
value.void
setByte(int parameterIndex, byte x)
Sets the designated parameter to the givenbyte
in the Java programming language.void
setByte(String parameterName, byte x)
Sets the designated parameter to the given Javabyte
value.void
setBytes(int parameterIndex, byte[] x)
Sets the designated parameter to the given array of bytes.void
setBytes(String parameterName, byte[] x)
Sets the designated parameter to the given Java array of bytes.void
setCharacterStream(int parameterIndex, Reader reader)
Sets the designated parameter in thisRowSet
object's command to the givenReader
object.void
setCharacterStream(int parameterIndex, Reader reader, int length)
Sets the designated parameter to the givenjava.io.Reader
object, which will have the specified number of characters.void
setCharacterStream(String parameterName, Reader reader)
Sets the designated parameter to the givenReader
object.void
setCharacterStream(String parameterName, Reader reader, int length)
Sets the designated parameter to the givenReader
object, which is the given number of characters long.void
setClob(int parameterIndex, Clob x)
Sets the designated parameter to the givenClob
object in the Java programming language.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, Clob x)
Sets the designated parameter to the givenjava.sql.Clob
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
setCommand(String cmd)
Sets thisRowSet
object'scommand
property to the givenString
object and clears the parameters, if any, that were set for the previous command.void
setConcurrency(int concurrency)
Sets the concurrency for thisRowSet
object to the specified concurrency.void
setDataSourceName(String name)
Sets theDataSource
name property for thisRowSet
object to the given logical name and sets thisRowSet
object's Url property tonull
.void
setDate(int parameterIndex, Date x)
Sets the designated parameter to the givenjava.sql.Date
value.void
setDate(int parameterIndex, Date x, Calendar cal)
Sets the designated parameter to the givenjava.sql.Date
object.void
setDate(String parameterName, Date x)
Sets the designated parameter to the givenjava.sql.Date
value using the default time zone of the virtual machine that is running the application.void
setDate(String parameterName, Date x, Calendar cal)
Sets the designated parameter to the givenjava.sql.Date
value, using the givenCalendar
object.void
setDouble(int parameterIndex, double x)
Sets the designated parameter to the givendouble
in the Java programming language.void
setDouble(String parameterName, double x)
Sets the designated parameter to the given Javadouble
value.void
setEscapeProcessing(boolean enable)
Sets to the givenboolean
whether or not the driver will scan for escape syntax and do escape substitution before sending SQL statements to the database.void
setFetchDirection(int direction)
Gives the driver a performance hint as to the direction in which the rows in thisRowSet
object will be processed.void
setFetchSize(int rows)
Sets the fetch size for thisRowSet
object to the given number of rows.void
setFloat(int parameterIndex, float x)
Sets the designated parameter to the givenfloat
in the Java programming language.void
setFloat(String parameterName, float x)
Sets the designated parameter to the given Javafloat
value.void
setInt(int parameterIndex, int x)
Sets the designated parameter to anint
in the Java programming language.void
setInt(String parameterName, int x)
Sets the designated parameter to the given Javaint
value.void
setLong(int parameterIndex, long x)
Sets the designated parameter to the givenlong
in the Java programming language.void
setLong(String parameterName, long x)
Sets the designated parameter to the given Javalong
value.void
setMaxFieldSize(int max)
Sets the maximum number of bytes that can be used for a column value in thisRowSet
object to the given number.void
setMaxRows(int max)
Sets the maximum number of rows that thisRowSet
object may contain to the given number.void
setNCharacterStream(int parameterIndex, Reader value)
Sets the designated parameter in thisRowSet
object's command 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, NClob value)
Sets the designated parameter to ajava.sql.NClob
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(String parameterName, 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
setNString(int parameterIndex, String value)
Sets the designated paramter to the givenString
object.void
setNString(String parameterName, String value)
Sets the designated paramter to the givenString
object.void
setNull(int parameterIndex, int sqlType)
Sets the designated parameter to SQLNULL
.void
setNull(int parameterIndex, int sqlType, String typeName)
Sets the designated parameter to SQLNULL
.void
setNull(String parameterName, int sqlType)
Sets the designated parameter to SQLNULL
.void
setNull(String parameterName, int sqlType, String typeName)
Sets the designated parameter to SQLNULL
.void
setObject(int parameterIndex, Object x)
Sets the designated parameter to anObject
in the Java programming language.void
setObject(int parameterIndex, Object x, int targetSqlType)
Sets the value of the designated parameter with the givenObject
value.void
setObject(int parameterIndex, Object x, int targetSqlType, int scale)
Sets the designated parameter to anObject
in the Java programming language.void
setObject(String parameterName, Object x)
Sets the value of the designated parameter with the given object.void
setObject(String parameterName, Object x, int targetSqlType)
Sets the value of the designated parameter with the given object.void
setObject(String parameterName, Object x, int targetSqlType, int scale)
Sets the value of the designated parameter with the given object.void
setPassword(String pass)
Sets the password used to create a database connection for thisRowSet
object to the givenString
object.void
setQueryTimeout(int seconds)
Sets to the given number the maximum number of seconds the driver will wait for a query to execute.void
setReadOnly(boolean value)
Sets thisRowSet
object's readOnly property to the givenboolean
.void
setRef(int parameterIndex, Ref ref)
Sets the designated parameter to the givenRef
object in the Java programming language.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
setShort(int parameterIndex, short x)
Sets the designated parameter to the givenshort
in the Java programming language.void
setShort(String parameterName, short x)
Sets the designated parameter to the given Javashort
value.void
setShowDeleted(boolean value)
Sets the propertyshowDeleted
to the givenboolean
value, which determines whether rows marked for deletion appear in the set of current rows.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.void
setString(int parameterIndex, String x)
Sets the designated parameter to the givenString
value.void
setString(String parameterName, String x)
Sets the designated parameter to the given JavaString
value.void
setTime(int parameterIndex, Time x)
Sets the designated parameter to the givenjava.sql.Time
value.void
setTime(int parameterIndex, Time x, Calendar cal)
Sets the designated parameter to the givenjava.sql.Time
object.void
setTime(String parameterName, Time x)
Sets the designated parameter to the givenjava.sql.Time
value.void
setTime(String parameterName, Time x, Calendar cal)
Sets the designated parameter to the givenjava.sql.Time
value, using the givenCalendar
object.void
setTimestamp(int parameterIndex, Timestamp x)
Sets the designated parameter to the givenjava.sql.Timestamp
value.void
setTimestamp(int parameterIndex, Timestamp x, Calendar cal)
Sets the designated parameter to the givenjava.sql.Timestamp
object.void
setTimestamp(String parameterName, Timestamp x)
Sets the designated parameter to the givenjava.sql.Timestamp
value.void
setTimestamp(String parameterName, Timestamp x, Calendar cal)
Sets the designated parameter to the givenjava.sql.Timestamp
value, using the givenCalendar
object.void
setTransactionIsolation(int level)
Sets the transaction isolation property for this JDBCRowSet
object to the given constant.void
setType(int type)
Sets the type for thisRowSet
object to the specified type.void
setTypeMap(Map<String,Class<?>> map)
Installs the givenjava.util.Map
object as the type map associated with theConnection
object for thisRowSet
object.void
setUnicodeStream(int parameterIndex, InputStream x, int length)
Deprecated.getCharacterStream should be used in its placevoid
setURL(int parameterIndex, URL x)
Sets the designated parameter to the givenjava.net.URL
value.void
setUrl(String url)
Sets the Url property for thisRowSet
object to the givenString
object and sets the dataSource name property tonull
.void
setUsername(String name)
Sets the username property for thisRowSet
object to the given user name.
-
-
-
Field Detail
-
UNICODE_STREAM_PARAM
public static final int UNICODE_STREAM_PARAM
A constant indicating to aRowSetReaderImpl
object that a given parameter is a Unicode stream. ThisRowSetReaderImpl
object is provided as an extension of theSyncProvider
abstract class defined in theSyncFactory
static factory SPI mechanism.- See Also:
- Constant Field Values
-
BINARY_STREAM_PARAM
public static final int BINARY_STREAM_PARAM
A constant indicating to aRowSetReaderImpl
object that a given parameter is a binary stream. ARowSetReaderImpl
object is provided as an extension of theSyncProvider
abstract class defined in theSyncFactory
static factory SPI mechanism.- See Also:
- Constant Field Values
-
ASCII_STREAM_PARAM
public static final int ASCII_STREAM_PARAM
A constant indicating to aRowSetReaderImpl
object that a given parameter is an ASCII stream. ARowSetReaderImpl
object is provided as an extension of theSyncProvider
abstract class defined in theSyncFactory
static factory SPI mechanism.- See Also:
- Constant Field Values
-
binaryStream
protected InputStream binaryStream
TheInputStream
object that will be returned by the methodgetBinaryStream
, which is specified in theResultSet
interface.
-
unicodeStream
protected InputStream unicodeStream
TheInputStream
object that will be returned by the methodgetUnicodeStream
, which is specified in theResultSet
interface.
-
asciiStream
protected InputStream asciiStream
TheInputStream
object that will be returned by the methodgetAsciiStream
, which is specified in theResultSet
interface.
-
charStream
protected Reader charStream
TheReader
object that will be returned by the methodgetCharacterStream
, which is specified in theResultSet
interface.
-
-
Constructor Detail
-
BaseRowSet
public BaseRowSet()
Constructs a newBaseRowSet
object initialized with a defaultVector
object for itslisteners
field. The other default values with which it is initialized are listed in Section 6.0 of the class comment for this class.
-
-
Method Detail
-
initParams
protected void initParams()
Performs the necessary internal configurations and initializations to allow any JDBCRowSet
implementation to start using the standard facilities provided by aBaseRowSet
instance. This method should be called after theRowSet
object has been instantiated to correctly initialize all parameters. This method should never be called by an application, but is called from with aRowSet
implementation extending this class.
-
addRowSetListener
public void addRowSetListener(RowSetListener listener)
The listener will be notified whenever an event occurs on thisRowSet
object.A listener might, for example, be a table or graph that needs to be updated in order to accurately reflect the current state of the
RowSet
object.Note: if the
RowSetListener
object isnull
, this method silently discards thenull
value and does not add a null reference to the set of listeners.Note: if the listener is already set, and the new
RowSetListerner
instance is added to the set of listeners already registered to receive event notifications from thisRowSet
.- Parameters:
listener
- an object that has implemented thejavax.sql.RowSetListener
interface and wants to be notified of any events that occur on thisRowSet
object; May be null.- See Also:
removeRowSetListener(javax.sql.RowSetListener)
-
removeRowSetListener
public void removeRowSetListener(RowSetListener listener)
Removes the designated object from thisRowSet
object's list of listeners. If the given argument is not a registered listener, this method does nothing. Note: if theRowSetListener
object isnull
, this method silently discards thenull
value.- Parameters:
listener
- aRowSetListener
object that is on the list of listeners for thisRowSet
object- See Also:
addRowSetListener(javax.sql.RowSetListener)
-
notifyCursorMoved
protected void notifyCursorMoved() throws SQLException
Notifies all of the listeners registered with thisRowSet
object that its cursor has moved.When an application calls a method to move the cursor, that method moves the cursor and then calls this method internally. An application should never invoke this method directly.
- Throws:
SQLException
- if the class extending theBaseRowSet
abstract class does not implement theRowSet
interface or one of it's sub-interfaces.
-
notifyRowChanged
protected void notifyRowChanged() throws SQLException
Notifies all of the listeners registered with thisRowSet
object that one of its rows has changed.When an application calls a method that changes a row, such as the
CachedRowSet
methodsinsertRow
,updateRow
, ordeleteRow
, that method callsnotifyRowChanged
internally. An application should never invoke this method directly.- Throws:
SQLException
- if the class extending theBaseRowSet
abstract class does not implement theRowSet
interface or one of it's sub-interfaces.
-
notifyRowSetChanged
protected void notifyRowSetChanged() throws SQLException
Notifies all of the listeners registered with thisRowSet
object that its entire contents have changed.When an application calls methods that change the entire contents of the
RowSet
object, such as theCachedRowSet
methodsexecute
,populate
,restoreOriginal
, orrelease
, that method callsnotifyRowSetChanged
internally (either directly or indirectly). An application should never invoke this method directly.- Throws:
SQLException
- if the class extending theBaseRowSet
abstract class does not implement theRowSet
interface or one of it's sub-interfaces.
-
getCommand
public String getCommand()
Retrieves the SQL query that is the command for thisRowSet
object. The command property contains the query that will be executed to populate thisRowSet
object.The SQL query returned by this method is used by
RowSet
methods such asexecute
andpopulate
, which may be implemented by any class that extends theBaseRowSet
abstract class and implements one or more of the standard JSR-114RowSet
interfaces.The command is used by the
RowSet
object's reader to obtain aResultSet
object. The reader then reads the data from theResultSet
object and uses it to to populate thisRowSet
object.The default value for the
command
property isnull
.- Returns:
- the
String
that is the value for thisRowSet
object'scommand
property; may benull
- See Also:
setCommand(java.lang.String)
-
setCommand
public void setCommand(String cmd) throws SQLException
Sets thisRowSet
object'scommand
property to the givenString
object and clears the parameters, if any, that were set for the previous command.The
command
property may not be needed if theRowSet
object gets its data from a source that does not support commands, such as a spreadsheet or other tabular file. Thus, this property is optional and may benull
.- Parameters:
cmd
- aString
object containing an SQL query that will be set as thisRowSet
object's command property; may benull
but may not be an empty string- Throws:
SQLException
- if an empty string is provided as the command value- See Also:
getCommand()
-
getUrl
public String getUrl() throws SQLException
Retrieves the JDBC URL that thisRowSet
object'sjavax.sql.Reader
object uses to make a connection with a relational database using a JDBC technology-enabled driver.The
Url
property will benull
if the underlying data source is a non-SQL data source, such as a spreadsheet or an XML data source.- Returns:
- a
String
object that contains the JDBC URL used to establish the connection for thisRowSet
object; may benull
(default value) if not set - Throws:
SQLException
- if an error occurs retrieving the URL value- See Also:
setUrl(java.lang.String)
-
setUrl
public void setUrl(String url) throws SQLException
Sets the Url property for thisRowSet
object to the givenString
object and sets the dataSource name property tonull
. The Url property is a JDBC URL that is used when the connection is created using a JDBC technology-enabled driver ("JDBC driver") and theDriverManager
. The correct JDBC URL for the specific driver to be used can be found in the driver documentation. Although there are guidelines for for how a JDBC URL is formed, a driver vendor can specify anyString
object except one with a length of0
(an empty string).Setting the Url property is optional if connections are established using a
DataSource
object instead of theDriverManager
. The driver will use either the URL property or the dataSourceName property to create a connection, whichever was specified most recently. If an application uses a JDBC URL, it must load a JDBC driver that accepts the JDBC URL before it uses theRowSet
object to connect to a database. TheRowSet
object will use the URL internally to create a database connection in order to read or write data.- Parameters:
url
- aString
object that contains the JDBC URL that will be used to establish the connection to a database for thisRowSet
object; may benull
but must not be an empty string- Throws:
SQLException
- if an error occurs setting the Url property or the parameter supplied is a string with a length of0
(an empty string)- See Also:
getUrl()
-
getDataSourceName
public String getDataSourceName()
Returns the logical name that when supplied to a naming service that uses the Java Naming and Directory Interface (JNDI) API, will retrieve ajavax.sql.DataSource
object. ThisDataSource
object can be used to establish a connection to the data source that it represents.Users should set either the url or the data source name property. The driver will use the property set most recently to establish a connection.
- Returns:
- a
String
object that identifies theDataSource
object to be used for making a connection; if no logical name has been set,null
is returned. - See Also:
setDataSourceName(java.lang.String)
-
setDataSourceName
public void setDataSourceName(String name) throws SQLException
Sets theDataSource
name property for thisRowSet
object to the given logical name and sets thisRowSet
object's Url property tonull
. The name must have been bound to aDataSource
object in a JNDI naming service so that an application can do a lookup using that name to retrieve theDataSource
object bound to it. TheDataSource
object can then be used to establish a connection to the data source it represents.Users should set either the Url property or the dataSourceName property. If both properties are set, the driver will use the property set most recently.
- Parameters:
name
- aString
object with the name that can be supplied to a naming service based on JNDI technology to retrieve theDataSource
object that can be used to get a connection; may benull
but must not be an empty string- Throws:
SQLException
- if an empty string is provided as theDataSource
name- See Also:
getDataSourceName()
-
getUsername
public String getUsername()
Returns the user name used to create a database connection. Because it is not serialized, the username property is set at runtime before calling the methodexecute
.- Returns:
- the
String
object containing the user name that is supplied to the data source to create a connection; may benull
(default value) if not set - See Also:
setUsername(java.lang.String)
-
setUsername
public void setUsername(String name)
Sets the username property for thisRowSet
object to the given user name. Because it is not serialized, the username property is set at run time before calling the methodexecute
.- Parameters:
name
- theString
object containing the user name that is supplied to the data source to create a connection. It may be null.- See Also:
getUsername()
-
getPassword
public String getPassword()
Returns the password used to create a database connection for thisRowSet
object. Because the password property is not serialized, it is set at run time before calling the methodexecute
. The default value isnull
- Returns:
- the
String
object that represents the password that must be supplied to the database to create a connection - See Also:
setPassword(java.lang.String)
-
setPassword
public void setPassword(String pass)
Sets the password used to create a database connection for thisRowSet
object to the givenString
object. Because the password property is not serialized, it is set at run time before calling the methodexecute
.- Parameters:
pass
- theString
object that represents the password that is supplied to the database to create a connection. It may be null.- See Also:
getPassword()
-
setType
public void setType(int type) throws SQLException
Sets the type for thisRowSet
object to the specified type. The default type isResultSet.TYPE_SCROLL_INSENSITIVE
.- Parameters:
type
- one of the following constants:ResultSet.TYPE_FORWARD_ONLY
,ResultSet.TYPE_SCROLL_INSENSITIVE
, orResultSet.TYPE_SCROLL_SENSITIVE
- Throws:
SQLException
- if the parameter supplied is not one of the following constants:ResultSet.TYPE_FORWARD_ONLY
orResultSet.TYPE_SCROLL_INSENSITIVE
ResultSet.TYPE_SCROLL_SENSITIVE
- See Also:
getConcurrency()
,getType()
-
getType
public int getType() throws SQLException
Returns the type of thisRowSet
object. The type is initially determined by the statement that created theRowSet
object. TheRowSet
object can call the methodsetType
at any time to change its type. The default isTYPE_SCROLL_INSENSITIVE
.- Returns:
- the type of this JDBC
RowSet
object, which must be one of the following:ResultSet.TYPE_FORWARD_ONLY
,ResultSet.TYPE_SCROLL_INSENSITIVE
, orResultSet.TYPE_SCROLL_SENSITIVE
- Throws:
SQLException
- if an error occurs getting the type of of thisRowSet
object- See Also:
setType(int)
-
setConcurrency
public void setConcurrency(int concurrency) throws SQLException
Sets the concurrency for thisRowSet
object to the specified concurrency. The default concurrency for anyRowSet
object (connected or disconnected) isResultSet.CONCUR_UPDATABLE
, but this method may be called at any time to change the concurrency.- Parameters:
concurrency
- one of the following constants:ResultSet.CONCUR_READ_ONLY
orResultSet.CONCUR_UPDATABLE
- Throws:
SQLException
- if the parameter supplied is not one of the following constants:ResultSet.CONCUR_UPDATABLE
orResultSet.CONCUR_READ_ONLY
- See Also:
getConcurrency()
,isReadOnly()
-
isReadOnly
public boolean isReadOnly()
Returns aboolean
indicating whether thisRowSet
object is read-only. Any attempts to update a read-onlyRowSet
object will result in anSQLException
being thrown. By default, rowsets are updatable if updates are possible.- Returns:
true
if thisRowSet
object cannot be updated;false
otherwise- See Also:
setConcurrency(int)
,setReadOnly(boolean)
-
setReadOnly
public void setReadOnly(boolean value)
Sets thisRowSet
object's readOnly property to the givenboolean
.- Parameters:
value
-true
to indicate that thisRowSet
object is read-only;false
to indicate that it is updatable
-
getTransactionIsolation
public int getTransactionIsolation()
Returns the transaction isolation property for thisRowSet
object's connection. This property represents the transaction isolation level requested for use in transactions.For
RowSet
implementations such as theCachedRowSet
that operate in a disconnected environment, theSyncProvider
object offers complementary locking and data integrity options. The options described below are pertinent only to connectedRowSet
objects (JdbcRowSet
objects).- Returns:
- one of the following constants:
Connection.TRANSACTION_NONE
,Connection.TRANSACTION_READ_UNCOMMITTED
,Connection.TRANSACTION_READ_COMMITTED
,Connection.TRANSACTION_REPEATABLE_READ
, orConnection.TRANSACTION_SERIALIZABLE
- See Also:
SyncFactory
,SyncProvider
,setTransactionIsolation(int)
-
setTransactionIsolation
public void setTransactionIsolation(int level) throws SQLException
Sets the transaction isolation property for this JDBCRowSet
object to the given constant. The DBMS will use this transaction isolation level for transactions if it can.For
RowSet
implementations such as theCachedRowSet
that operate in a disconnected environment, theSyncProvider
object being used offers complementary locking and data integrity options. The options described below are pertinent only to connectedRowSet
objects (JdbcRowSet
objects).- Parameters:
level
- one of the following constants, listed in ascending order:Connection.TRANSACTION_NONE
,Connection.TRANSACTION_READ_UNCOMMITTED
,Connection.TRANSACTION_READ_COMMITTED
,Connection.TRANSACTION_REPEATABLE_READ
, orConnection.TRANSACTION_SERIALIZABLE
- Throws:
SQLException
- if the given parameter is not one of the Connection constants- See Also:
SyncFactory
,SyncProvider
,getTransactionIsolation()
-
getTypeMap
public Map<String,Class<?>> getTypeMap()
Retrieves the type map associated with theConnection
object for thisRowSet
object.Drivers that support the JDBC 3.0 API will create
Connection
objects with an associated type map. This type map, which is initially empty, can contain one or more fully-qualified SQL names andClass
objects indicating the class to which the named SQL value will be mapped. The type mapping specified in the connection's type map is used for custom type mapping when no other type map supersedes it.If a type map is explicitly supplied to a method that can perform custom mapping, that type map supersedes the connection's type map.
- Returns:
- the
java.util.Map
object that is the type map for thisRowSet
object's connection
-
setTypeMap
public void setTypeMap(Map<String,Class<?>> map)
Installs the givenjava.util.Map
object as the type map associated with theConnection
object for thisRowSet
object. The custom mapping indicated in this type map will be used unless a different type map is explicitly supplied to a method, in which case the type map supplied will be used.- Parameters:
map
- ajava.util.Map
object that contains the mapping from SQL type names for user defined types (UDT) to classes in the Java programming language. Each entry in theMap
object consists of the fully qualified SQL name of a UDT and theClass
object for theSQLData
implementation of that UDT. May benull
.
-
getMaxFieldSize
public int getMaxFieldSize() throws SQLException
Retrieves the maximum number of bytes that can be used for a column value in thisRowSet
object. This limit applies only to columns that hold values of the following types:BINARY
,VARBINARY
,LONGVARBINARY
,CHAR
,VARCHAR
, andLONGVARCHAR
. If the limit is exceeded, the excess data is silently discarded.- Returns:
- an
int
indicating the current maximum column size limit; zero means that there is no limit - Throws:
SQLException
- if an error occurs internally determining the maximum limit of the column size
-
setMaxFieldSize
public void setMaxFieldSize(int max) throws SQLException
Sets the maximum number of bytes that can be used for a column value in thisRowSet
object to the given number. This limit applies only to columns that hold values of the following types:BINARY
,VARBINARY
,LONGVARBINARY
,CHAR
,VARCHAR
, andLONGVARCHAR
. If the limit is exceeded, the excess data is silently discarded. For maximum portability, it is advisable to use values greater than 256.- Parameters:
max
- anint
indicating the new maximum column size limit; zero means that there is no limit- Throws:
SQLException
- if (1) an error occurs internally setting the maximum limit of the column size or (2) a size of less than 0 is set
-
getMaxRows
public int getMaxRows() throws SQLException
Retrieves the maximum number of rows that thisRowSet
object may contain. If this limit is exceeded, the excess rows are silently dropped.- Returns:
- an
int
indicating the current maximum number of rows; zero means that there is no limit - Throws:
SQLException
- if an error occurs internally determining the maximum limit of rows that aRowset
object can contain
-
setMaxRows
public void setMaxRows(int max) throws SQLException
Sets the maximum number of rows that thisRowSet
object may contain to the given number. If this limit is exceeded, the excess rows are silently dropped.- Parameters:
max
- anint
indicating the current maximum number of rows; zero means that there is no limit- Throws:
SQLException
- if an error occurs internally setting the maximum limit on the number of rows that a JDBCRowSet
object can contain; or if max is less than0
; or if max is less than thefetchSize
of theRowSet
-
setEscapeProcessing
public void setEscapeProcessing(boolean enable) throws SQLException
Sets to the givenboolean
whether or not the driver will scan for escape syntax and do escape substitution before sending SQL statements to the database. The default is for the driver to do escape processing.Note: Since
PreparedStatement
objects have usually been parsed prior to making this call, disabling escape processing for prepared statements will likely have no effect.- Parameters:
enable
-true
to enable escape processing;false
to disable it- Throws:
SQLException
- if an error occurs setting the underlying JDBC technology-enabled driver to process the escape syntax
-
getQueryTimeout
public int getQueryTimeout() throws SQLException
Retrieves the maximum number of seconds the driver will wait for a query to execute. If the limit is exceeded, anSQLException
is thrown.- Returns:
- the current query timeout limit in seconds; zero means that there is no limit
- Throws:
SQLException
- if an error occurs in determining the query time-out value
-
setQueryTimeout
public void setQueryTimeout(int seconds) throws SQLException
Sets to the given number the maximum number of seconds the driver will wait for a query to execute. If the limit is exceeded, anSQLException
is thrown.- Parameters:
seconds
- the new query time-out limit in seconds; zero means that there is no limit; must not be less than zero- Throws:
SQLException
- if an error occurs setting the query time-out or if the query time-out value is less than 0
-
getShowDeleted
public boolean getShowDeleted() throws SQLException
Retrieves aboolean
indicating whether rows marked for deletion appear in the set of current rows. The default value isfalse
.Note: Allowing deleted rows to remain visible complicates the behavior of some of the methods. However, most
RowSet
object users can simply ignore this extra detail because only sophisticated applications will likely want to take advantage of this feature.- Returns:
true
if deleted rows are visible;false
otherwise- Throws:
SQLException
- if an error occurs determining if deleted rows are visible or not- See Also:
setShowDeleted(boolean)
-
setShowDeleted
public void setShowDeleted(boolean value) throws SQLException
Sets the propertyshowDeleted
to the givenboolean
value, which determines whether rows marked for deletion appear in the set of current rows.- Parameters:
value
-true
if deleted rows should be shown;false
otherwise- Throws:
SQLException
- if an error occurs setting whether deleted rows are visible or not- See Also:
getShowDeleted()
-
getEscapeProcessing
public boolean getEscapeProcessing() throws SQLException
Ascertains whether escape processing is enabled for thisRowSet
object.- Returns:
true
if escape processing is turned on;false
otherwise- Throws:
SQLException
- if an error occurs determining if escape processing is enabled or not or if the internal escape processing trigger has not been enabled
-
setFetchDirection
public void setFetchDirection(int direction) throws SQLException
Gives the driver a performance hint as to the direction in which the rows in thisRowSet
object will be processed. The driver may ignore this hint.A
RowSet
object inherits the default properties of theResultSet
object from which it got its data. ThatResultSet
object's default fetch direction is set by theStatement
object that created it.This method applies to a
RowSet
object only while it is connected to a database using a JDBC driver.A
RowSet
object may use this method at any time to change its setting for the fetch direction.- Parameters:
direction
- one ofResultSet.FETCH_FORWARD
,ResultSet.FETCH_REVERSE
, orResultSet.FETCH_UNKNOWN
- Throws:
SQLException
- if (1) theRowSet
type isTYPE_FORWARD_ONLY
and the given fetch direction is notFETCH_FORWARD
or (2) the given fetch direction is not one of the following: ResultSet.FETCH_FORWARD, ResultSet.FETCH_REVERSE, or ResultSet.FETCH_UNKNOWN- See Also:
getFetchDirection()
-
getFetchDirection
public int getFetchDirection() throws SQLException
Retrieves thisRowSet
object's current setting for the fetch direction. The default type isResultSet.FETCH_FORWARD
- Returns:
- one of
ResultSet.FETCH_FORWARD
,ResultSet.FETCH_REVERSE
, orResultSet.FETCH_UNKNOWN
- Throws:
SQLException
- if an error occurs in determining the current fetch direction for fetching rows- See Also:
setFetchDirection(int)
-
setFetchSize
public void setFetchSize(int rows) throws SQLException
Sets the fetch size for thisRowSet
object to the given number of rows. The fetch size gives a JDBC technology-enabled driver ("JDBC driver") a hint as to the number of rows that should be fetched from the database when more rows are needed for thisRowSet
object. If the fetch size specified is zero, the driver ignores the value and is free to make its own best guess as to what the fetch size should be.A
RowSet
object inherits the default properties of theResultSet
object from which it got its data. ThatResultSet
object's default fetch size is set by theStatement
object that created it.This method applies to a
RowSet
object only while it is connected to a database using a JDBC driver. For connectedRowSet
implementations such asJdbcRowSet
, this method has a direct and immediate effect on the underlying JDBC driver.A
RowSet
object may use this method at any time to change its setting for the fetch size.For
RowSet
implementations such asCachedRowSet
, which operate in a disconnected environment, theSyncProvider
object being used may leverage the fetch size to poll the data source and retrieve a number of rows that do not exceed the fetch size and that may form a subset of the actual rows returned by the original query. This is an implementation variance determined by the specificSyncProvider
object employed by the disconnectedRowSet
object.- Parameters:
rows
- the number of rows to fetch;0
to let the driver decide what the best fetch size is; must not be less than0
or more than the maximum number of rows allowed for thisRowSet
object (the number returned by a call to the methodgetMaxRows()
)- Throws:
SQLException
- if the specified fetch size is less than0
or more than the limit for the maximum number of rows- See Also:
getFetchSize()
-
getFetchSize
public int getFetchSize() throws SQLException
Returns the fetch size for thisRowSet
object. The default value is zero.- Returns:
- the number of rows suggested as the fetch size when this
RowSet
object needs more rows from the database - Throws:
SQLException
- if an error occurs determining the number of rows in the current fetch size- See Also:
setFetchSize(int)
-
getConcurrency
public int getConcurrency() throws SQLException
Returns the concurrency for thisRowSet
object. The default isCONCUR_UPDATABLE
for both connected and disconnectedRowSet
objects.An application can call the method
setConcurrency
at any time to change aRowSet
object's concurrency.- Returns:
- the concurrency type for this
RowSet
object, which must be one of the following:ResultSet.CONCUR_READ_ONLY
orResultSet.CONCUR_UPDATABLE
- Throws:
SQLException
- if an error occurs getting the concurrency of thisRowSet
object- See Also:
setConcurrency(int)
,isReadOnly()
-
setNull
public void setNull(int parameterIndex, int sqlType) throws SQLException
Sets the designated parameter to SQLNULL
. Note that the parameter's SQL type must be specified using one of the type codes defined injava.sql.Types
. This SQL type is specified in the second parameter.Note that the second parameter tells the DBMS the data type of the value being set to
NULL
. Some DBMSs require this information, so it is required in order to make code more portable.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.Calls made to the method
getParams
after this version ofsetNull
has been called will return anObject
array containing the parameter values that have been set. In that array, the element that represents the values set with this method will itself be an array. The first element of that array isnull
. The second element is the value set for sqlType. The parameter number is indicated by an element's position in the array returned by the methodgetParams
, with the first element being the value for the first placeholder parameter, the second element being the value for the second placeholder parameter, and so on. In other words, if the second placeholder parameter is being set tonull
, the array containing it will be the second element in the array returned bygetParams
.Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is parameterIndex -1.
- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greatersqlType
- anint
that is one of the SQL type codes defined in the classTypes
. If a non-standard sqlType is supplied, this method will not throw aSQLException
. This allows implicit support for non-standard SQL types.- Throws:
SQLException
- if a database access error occurs or the given parameter index is out of bounds- See Also:
getParams()
-
setNull
public void setNull(int parameterIndex, int sqlType, String typeName) throws SQLException
Sets the designated parameter to SQLNULL
. Although this version of the methodsetNull
is intended for user-defined andREF
parameters, this method may be used to set a null parameter for any JDBC type. The following are user-defined types:STRUCT
,DISTINCT
, andJAVA_OBJECT
, and named array types.Note: To be portable, applications must give the SQL type code and the fully qualified SQL type name when specifying a
NULL
user-defined orREF
parameter. In the case of a user-defined type, the name is the type name of the parameter itself. For aREF
parameter, the name is the type name of the referenced type. If a JDBC technology-enabled driver does not need the type code or type name information, it may ignore it.If the parameter does not have a user-defined or
REF
type, the giventypeName
parameter is ignored.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.Calls made to the method
getParams
after this version ofsetNull
has been called will return anObject
array containing the parameter values that have been set. In that array, the element that represents the values set with this method will itself be an array. The first element of that array isnull
. The second element is the value set for sqlType, and the third element is the value set for typeName. The parameter number is indicated by an element's position in the array returned by the methodgetParams
, with the first element being the value for the first placeholder parameter, the second element being the value for the second placeholder parameter, and so on. In other words, if the second placeholder parameter is being set tonull
, the array containing it will be the second element in the array returned bygetParams
.Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is parameterIndex -1.
- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greatersqlType
- a value fromjava.sql.Types
typeName
- the fully qualified name of an SQL user-defined type, which is ignored if the parameter is not a user-defined type orREF
value- Throws:
SQLException
- if an error occurs or the given parameter index is out of bounds- See Also:
getParams()
-
setBoolean
public void setBoolean(int parameterIndex, boolean x) throws SQLException
Sets the designated parameter to the givenboolean
in the Java programming language. The driver converts this to an SQLBIT
value when it sends it to the database.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
,populate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- the parameter value- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setByte
public void setByte(int parameterIndex, byte x) throws SQLException
Sets the designated parameter to the givenbyte
in the Java programming language. The driver converts this to an SQLTINYINT
value when it sends it to the database.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- the parameter value- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setShort
public void setShort(int parameterIndex, short x) throws SQLException
Sets the designated parameter to the givenshort
in the Java programming language. The driver converts this to an SQLSMALLINT
value when it sends it to the database.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- the parameter value- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setInt
public void setInt(int parameterIndex, int x) throws SQLException
Sets the designated parameter to anint
in the Java programming language. The driver converts this to an SQLINTEGER
value when it sends it to the database.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- the parameter value- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setLong
public void setLong(int parameterIndex, long x) throws SQLException
Sets the designated parameter to the givenlong
in the Java programming language. The driver converts this to an SQLBIGINT
value when it sends it to the database.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- the parameter value- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setFloat
public void setFloat(int parameterIndex, float x) throws SQLException
Sets the designated parameter to the givenfloat
in the Java programming language. The driver converts this to an SQLFLOAT
value when it sends it to the database.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- the parameter value- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setDouble
public void setDouble(int parameterIndex, double x) throws SQLException
Sets the designated parameter to the givendouble
in the Java programming language. The driver converts this to an SQLDOUBLE
value when it sends it to the database.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class. S- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- the parameter value- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setBigDecimal
public void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException
Sets the designated parameter to the givenjava.lang.BigDecimal
value. The driver converts this to an SQLNUMERIC
value when it sends it to the database.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.Note:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- the parameter value- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setString
public void setString(int parameterIndex, String x) throws SQLException
Sets the designated parameter to the givenString
value. The driver converts this to an SQLVARCHAR
orLONGVARCHAR
value (depending on the argument's size relative to the driver's limits onVARCHAR
values) when it sends it to the database.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- the parameter value- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setBytes
public void setBytes(int parameterIndex, byte[] x) throws SQLException
Sets the designated parameter to the given array of bytes. The driver converts this to an SQLVARBINARY
orLONGVARBINARY
value (depending on the argument's size relative to the driver's limits onVARBINARY
values) when it sends it to the database.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- the parameter value- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setDate
public void setDate(int parameterIndex, Date x) throws SQLException
Sets the designated parameter to the givenjava.sql.Date
value. The driver converts this to an SQLDATE
value when it sends it to the database.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.Calls made to the method
getParams
after this version ofsetDate
has been called will return an array with the value to be set for placeholder parameter number parameterIndex being theDate
object supplied as the second parameter. Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is parameterIndex -1.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- the parameter value- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setTime
public void setTime(int parameterIndex, Time x) throws SQLException
Sets the designated parameter to the givenjava.sql.Time
value. The driver converts this to an SQLTIME
value when it sends it to the database.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.Calls made to the method
getParams
after this version of the methodsetTime
has been called will return an array of the parameters that have been set. The parameter to be set for parameter placeholder number parameterIndex will be theTime
object that was set as the second parameter to this method.Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is parameterIndex -1.
- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- ajava.sql.Time
object, which is to be set as the value for placeholder parameter parameterIndex- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setTimestamp
public void setTimestamp(int parameterIndex, Timestamp x) throws SQLException
Sets the designated parameter to the givenjava.sql.Timestamp
value. The driver converts this to an SQLTIMESTAMP
value when it sends it to the database.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.Calls made to the method
getParams
after this version ofsetTimestamp
has been called will return an array with the value for parameter placeholder number parameterIndex being theTimestamp
object that was supplied as the second parameter to this method. Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is parameterIndex -1.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- ajava.sql.Timestamp
object- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setAsciiStream
public void setAsciiStream(int parameterIndex, InputStream x, int length) throws SQLException
Sets the designated parameter to the givenjava.io.InputStream
object, which will have the specified number of bytes. The contents of the stream will be read and sent to the database. This method throws anSQLException
object if the number of bytes read and sent to the database is not equal to length.When a very large ASCII value is input to a
LONGVARCHAR
parameter, it may be more practical to send it via ajava.io.InputStream
object. A JDBC technology-enabled driver will read the data from the stream as needed until it reaches end-of-file. The driver will do any necessary conversion from ASCII to the databaseCHAR
format.Note: This stream object can be either a standard Java stream object or your own subclass that implements the standard interface.
The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.Note:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.Calls made to the method
getParams
aftersetAsciiStream
has been called will return an array containing the parameter values that have been set. The element in the array that represents the values set with this method will itself be an array. The first element of that array is the givenjava.io.InputStream
object. The second element is the value set for length. The third element is an internalBaseRowSet
constant specifying that the stream passed to this method is an ASCII stream. The parameter number is indicated by an element's position in the array returned by the methodgetParams
, with the first element being the value for the first placeholder parameter, the second element being the value for the second placeholder parameter, and so on. In other words, if the input stream being set is the value for the second placeholder parameter, the array containing it will be the second element in the array returned bygetParams
.Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is element number parameterIndex -1.
- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- the Java input stream that contains the ASCII parameter valuelength
- the number of bytes in the stream. This is the number of bytes the driver will send to the DBMS; lengths of 0 or less are are undefined but will cause an invalid length exception to be thrown in the underlying JDBC driver.- Throws:
SQLException
- if an error occurs, the parameter index is out of bounds, or when connected to a data source, the number of bytes the driver reads and sends to the database is not equal to the number of bytes specified in length- See Also:
getParams()
-
setAsciiStream
public void setAsciiStream(int parameterIndex, InputStream x) throws SQLException
Sets the designated parameter in thisRowSet
object's command 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 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, int length) throws SQLException
Sets the designated parameter to the givenjava.io.InputStream
object, which will have the specified number of bytes. The contents of the stream will be read and sent to the database. This method throws anSQLException
object if the number of bytes read and sent to the database is not equal to length.When a very large binary value is input to a
LONGVARBINARY
parameter, it may be more practical to send it via ajava.io.InputStream
object. A JDBC technology-enabled driver will read the data from the stream as needed until it reaches end-of-file.Note: This stream object can be either a standard Java stream object or your own subclass that implements the standard interface.
The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.Calls made to the method
getParams
aftersetBinaryStream
has been called will return an array containing the parameter values that have been set. In that array, the element that represents the values set with this method will itself be an array. The first element of that array is the givenjava.io.InputStream
object. The second element is the value set for length. The third element is an internalBaseRowSet
constant specifying that the stream passed to this method is a binary stream. The parameter number is indicated by an element's position in the array returned by the methodgetParams
, with the first element being the value for the first placeholder parameter, the second element being the value for the second placeholder parameter, and so on. In other words, if the input stream being set is the value for the second placeholder parameter, the array containing it will be the second element in the array returned bygetParams
.Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is element number parameterIndex -1.
- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- the input stream that contains the binary value to be setlength
- the number of bytes in the stream; lengths of 0 or less are are undefined but will cause an invalid length exception to be thrown in the underlying JDBC driver.- Throws:
SQLException
- if an error occurs, the parameter index is out of bounds, or when connected to a data source, the number of bytes the driver reads and sends to the database is not equal to the number of bytes specified in length- See Also:
getParams()
-
setBinaryStream
public void setBinaryStream(int parameterIndex, InputStream x) throws SQLException
Sets the designated parameter in thisRowSet
object's command 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 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
-
setUnicodeStream
public void setUnicodeStream(int parameterIndex, InputStream x, int length) throws SQLException
Deprecated. getCharacterStream should be used in its placeSets the designated parameter to the givenjava.io.InputStream
object, which will have the specified number of bytes. The contents of the stream will be read and sent to the database. This method throws anSQLException
if the number of bytes read and sent to the database is not equal to length.When a very large Unicode value is input to a
LONGVARCHAR
parameter, it may be more practical to send it via ajava.io.InputStream
object. A JDBC technology-enabled driver will read the data from the stream as needed, until it reaches end-of-file. The driver will do any necessary conversion from Unicode to the databaseCHAR
format. The byte format of the Unicode stream must be Java UTF-8, as defined in the Java Virtual Machine Specification.Note: This stream object can be either a standard Java stream object or your own subclass that implements the standard interface.
This method is deprecated; the method
getCharacterStream
should be used in its place.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Calls made to the methodgetParams
aftersetUnicodeStream
has been called will return an array containing the parameter values that have been set. In that array, the element that represents the values set with this method will itself be an array. The first element of that array is the givenjava.io.InputStream
object. The second element is the value set for length. The third element is an internalBaseRowSet
constant specifying that the stream passed to this method is a Unicode stream. The parameter number is indicated by an element's position in the array returned by the methodgetParams
, with the first element being the value for the first placeholder parameter, the second element being the value for the second placeholder parameter, and so on. In other words, if the input stream being set is the value for the second placeholder parameter, the array containing it will be the second element in the array returned bygetParams
.Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is element number parameterIndex -1.
- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- thejava.io.InputStream
object that contains the UNICODE parameter valuelength
- the number of bytes in the input stream- Throws:
SQLException
- if an error occurs, the parameter index is out of bounds, or the number of bytes the driver reads and sends to the database is not equal to the number of bytes specified in length- See Also:
getParams()
-
setCharacterStream
public void setCharacterStream(int parameterIndex, Reader reader, int length) throws SQLException
Sets the designated parameter to the givenjava.io.Reader
object, which will have the specified number of characters. The contents of the reader will be read and sent to the database. This method throws anSQLException
if the number of bytes read and sent to the database is not equal to length.When a very large Unicode value is input to a
LONGVARCHAR
parameter, it may be more practical to send it via aReader
object. A JDBC technology-enabled driver will read the data from the stream as needed until it reaches end-of-file. The driver will do any necessary conversion from Unicode to the databaseCHAR
format. The byte format of the Unicode stream must be Java UTF-8, as defined in the Java Virtual Machine Specification.Note: This stream object can be either a standard Java stream object or your own subclass that implements the standard interface.
The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.Calls made to the method
getParams
aftersetCharacterStream
has been called will return an array containing the parameter values that have been set. In that array, the element that represents the values set with this method will itself be an array. The first element of that array is the givenjava.io.Reader
object. The second element is the value set for length. The parameter number is indicated by an element's position in the array returned by the methodgetParams
, with the first element being the value for the first placeholder parameter, the second element being the value for the second placeholder parameter, and so on. In other words, if the reader being set is the value for the second placeholder parameter, the array containing it will be the second element in the array returned bygetParams
.Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is element number parameterIndex -1.
- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterreader
- theReader
object that contains the Unicode datalength
- the number of characters in the stream; lengths of 0 or less are undefined but will cause an invalid length exception to be thrown in the underlying JDBC driver.- Throws:
SQLException
- if an error occurs, the parameter index is out of bounds, or when connected to a data source, the number of bytes the driver reads and sends to the database is not equal to the number of bytes specified in length- See Also:
getParams()
-
setCharacterStream
public void setCharacterStream(int parameterIndex, Reader reader) throws SQLException
Sets the designated parameter in thisRowSet
object's command 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 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
-
setObject
public void setObject(int parameterIndex, Object x, int targetSqlType, int scale) throws SQLException
Sets the designated parameter to anObject
in the Java programming language. The second parameter must be anObject
type. For integral values, thejava.lang
equivalent objects should be used. For example, use the classInteger
for anint
.The driver converts this object to the specified target SQL type before sending it to the database. If the object has a custom mapping (is of a class implementing
SQLData
), the driver should call the methodSQLData.writeSQL
to write the object to the SQL data stream. If, on the other hand, the object is of a class implementingRef
,Blob
,Clob
,Struct
, orArray
, the driver should pass it to the database as a value of the corresponding SQL type.Note that this method may be used to pass database- specific abstract data types.
The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
execute is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.Calls made to the method
getParams
after this version ofsetObject
has been called will return an array containing the parameter values that have been set. In that array, the element that represents the values set with this method will itself be an array. The first element of that array is the givenObject
instance, and the second element is the value set for targetSqlType. The third element is the value set for scale, which the driver will ignore if the type of the object being set is notjava.sql.Types.NUMERIC
orjava.sql.Types.DECIMAL
. The parameter number is indicated by an element's position in the array returned by the methodgetParams
, with the first element being the value for the first placeholder parameter, the second element being the value for the second placeholder parameter, and so on. In other words, if the object being set is the value for the second placeholder parameter, the array containing it will be the second element in the array returned bygetParams
.Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is element number parameterIndex -1.
- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- theObject
containing the input parameter value; must be anObject
typetargetSqlType
- the SQL type (as defined injava.sql.Types
) to be sent to the database. Thescale
argument may further qualify this type. If a non-standard targetSqlType is supplied, this method will not throw aSQLException
. This allows implicit support for non-standard SQL types.scale
- for the typesjava.sql.Types.DECIMAL
andjava.sql.Types.NUMERIC
, this is the number of digits after the decimal point. For all other types, this value will be ignored.- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setObject
public void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException
Sets the value of the designated parameter with the givenObject
value. This method is likesetObject(int parameterIndex, Object x, int targetSqlType, int scale)
except that it assumes a scale of zero.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.Calls made to the method
getParams
after this version ofsetObject
has been called will return an array containing the parameter values that have been set. In that array, the element that represents the values set with this method will itself be an array. The first element of that array is the givenObject
instance. The second element is the value set for targetSqlType. The parameter number is indicated by an element's position in the array returned by the methodgetParams
, with the first element being the value for the first placeholder parameter, the second element being the value for the second placeholder parameter, and so on. In other words, if the object being set is the value for the second placeholder parameter, the array containing it will be the second element in the array returned bygetParams
.Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is element number parameterIndex -1.
- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- theObject
containing the input parameter value; must be anObject
typetargetSqlType
- the SQL type (as defined injava.sql.Types
) to be sent to the database. If a non-standard targetSqlType is supplied, this method will not throw aSQLException
. This allows implicit support for non-standard SQL types.- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setObject
public void setObject(int parameterIndex, Object x) throws SQLException
Sets the designated parameter to anObject
in the Java programming language. The second parameter must be anObject
type. For integral values, thejava.lang
equivalent objects should be used. For example, use the classInteger
for anint
.The JDBC specification defines a standard mapping from Java
Object
types to SQL types. The driver will use this standard mapping to convert the given object to its corresponding SQL type before sending it to the database. If the object has a custom mapping (is of a class implementingSQLData
), the driver should call the methodSQLData.writeSQL
to write the object to the SQL data stream.If, on the other hand, the object is of a class implementing
Ref
,Blob
,Clob
,Struct
, orArray
, the driver should pass it to the database as a value of the corresponding SQL type.This method throws an exception if there is an ambiguity, for example, if the object is of a class implementing more than one interface.
Note that this method may be used to pass database-specific abstract data types.
The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.After this method has been called, a call to the method
getParams
will return an object array of the current command parameters, which will include theObject
set for placeholder parameter numberparameterIndex
. Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is element number parameterIndex -1.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- the object containing the input parameter value- Throws:
SQLException
- if an error occurs the parameter index is out of bounds, or there is ambiguity in the implementation of the object being set- See Also:
getParams()
-
setRef
public void setRef(int parameterIndex, Ref ref) throws SQLException
Sets the designated parameter to the givenRef
object in the Java programming language. The driver converts this to an SQLREF
value when it sends it to the database. Internally, theRef
is represented as aSerialRef
to ensure serializability.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.After this method has been called, a call to the method
getParams
will return an object array of the current command parameters, which will include theRef
object set for placeholder parameter numberparameterIndex
. Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is element number parameterIndex -1.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterref
- aRef
object representing an SQLREF
value; cannot be null- Throws:
SQLException
- if an error occurs; the parameter index is out of bounds or theRef
object isnull
; or theRef
object returns anull
base type name.- See Also:
getParams()
,SerialRef
-
setBlob
public void setBlob(int parameterIndex, Blob x) throws SQLException
Sets the designated parameter to the givenBlob
object in the Java programming language. The driver converts this to an SQLBLOB
value when it sends it to the database. Internally, theBlob
is represented as aSerialBlob
to ensure serializability.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces. NOTE:JdbcRowSet
does not require thepopulate
method as it is undefined in this class.After this method has been called, a call to the method
getParams
will return an object array of the current command parameters, which will include theBlob
object set for placeholder parameter numberparameterIndex
. Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is element number parameterIndex -1.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- aBlob
object representing an SQLBLOB
value- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
,SerialBlob
-
setClob
public void setClob(int parameterIndex, Clob x) throws SQLException
Sets the designated parameter to the givenClob
object in the Java programming language. The driver converts this to an SQLCLOB
value when it sends it to the database. Internally, theClob
is represented as aSerialClob
to ensure serializability.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.After this method has been called, a call to the method
getParams
will return an object array of the current command parameters, which will include theClob
object set for placeholder parameter numberparameterIndex
. Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is element number parameterIndex -1.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- aClob
object representing an SQLCLOB
value; cannot be null- Throws:
SQLException
- if an error occurs; the parameter index is out of bounds or theClob
is null- See Also:
getParams()
,SerialBlob
-
setArray
public void setArray(int parameterIndex, Array array) throws SQLException
Sets the designated parameter to anArray
object in the Java programming language. The driver converts this to an SQLARRAY
value when it sends it to the database. Internally, theArray
is represented as aSerialArray
to ensure serializability.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.Note:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.After this method has been called, a call to the method
getParams
will return an object array of the current command parameters, which will include theArray
object set for placeholder parameter numberparameterIndex
. Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is element number parameterIndex -1.- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterarray
- anArray
object representing an SQLARRAY
value; cannot be null. TheArray
object passed to this method must return a non-null Object for allgetArray()
method calls. A null value will cause aSQLException
to be thrown.- Throws:
SQLException
- if an error occurs; the parameter index is out of bounds or theARRAY
is null- See Also:
getParams()
,SerialArray
-
setDate
public void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException
Sets the designated parameter to the givenjava.sql.Date
object. When the DBMS does not store time zone information, the driver will use the givenCalendar
object to construct the SQLDATE
value to send to the database. With aCalendar
object, the driver can calculate the date taking into account a custom time zone. If noCalendar
object is specified, the driver uses the time zone of the Virtual Machine that is running the application.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.Calls made to the method
getParams
after this version ofsetDate
has been called will return an array containing the parameter values that have been set. In that array, the element that represents the values set with this method will itself be an array. The first element of that array is the givenjava.sql.Date
object. The second element is the value set for cal. The parameter number is indicated by an element's position in the array returned by the methodgetParams
, with the first element being the value for the first placeholder parameter, the second element being the value for the second placeholder parameter, and so on. In other words, if the date being set is the value for the second placeholder parameter, the array containing it will be the second element in the array returned bygetParams
.Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is parameterIndex -1.
- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- ajava.sql.Date
object representing an SQLDATE
valuecal
- ajava.util.Calendar
object to use when when constructing the date- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setTime
public void setTime(int parameterIndex, Time x, Calendar cal) throws SQLException
Sets the designated parameter to the givenjava.sql.Time
object. The driver converts this to an SQLTIME
value when it sends it to the database.When the DBMS does not store time zone information, the driver will use the given
Calendar
object to construct the SQLTIME
value to send to the database. With aCalendar
object, the driver can calculate the date taking into account a custom time zone. If noCalendar
object is specified, the driver uses the time zone of the Virtual Machine that is running the application.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.Calls made to the method
getParams
after this version ofsetTime
has been called will return an array containing the parameter values that have been set. In that array, the element that represents the values set with this method will itself be an array. The first element of that array is the givenjava.sql.Time
object. The second element is the value set for cal. The parameter number is indicated by an element's position in the array returned by the methodgetParams
, with the first element being the value for the first placeholder parameter, the second element being the value for the second placeholder parameter, and so on. In other words, if the time being set is the value for the second placeholder parameter, the array containing it will be the second element in the array returned bygetParams
.Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is parameterIndex -1.
- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- ajava.sql.Time
objectcal
- thejava.util.Calendar
object the driver can use to construct the time- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
setTimestamp
public void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) throws SQLException
Sets the designated parameter to the givenjava.sql.Timestamp
object. The driver converts this to an SQLTIMESTAMP
value when it sends it to the database.When the DBMS does not store time zone information, the driver will use the given
Calendar
object to construct the SQLTIMESTAMP
value to send to the database. With aCalendar
object, the driver can calculate the timestamp taking into account a custom time zone. If noCalendar
object is specified, the driver uses the time zone of the Virtual Machine that is running the application.The parameter value set by this method is stored internally and will be supplied as the appropriate parameter in this
RowSet
object's command when the methodexecute
is called. Methods such asexecute
andpopulate
must be provided in any class that extends this class and implements one or more of the standard JSR-114RowSet
interfaces.NOTE:
JdbcRowSet
does not require thepopulate
method as it is undefined in this class.Calls made to the method
getParams
after this version ofsetTimestamp
has been called will return an array containing the parameter values that have been set. In that array, the element that represents the values set with this method will itself be an array. The first element of that array is the givenjava.sql.Timestamp
object. The second element is the value set for cal. The parameter number is indicated by an element's position in the array returned by the methodgetParams
, with the first element being the value for the first placeholder parameter, the second element being the value for the second placeholder parameter, and so on. In other words, if the timestamp being set is the value for the second placeholder parameter, the array containing it will be the second element in the array returned bygetParams
.Note that because the numbering of elements in an array starts at zero, the array element that corresponds to placeholder parameter number parameterIndex is parameterIndex -1.
- Parameters:
parameterIndex
- the ordinal number of the placeholder parameter in thisRowSet
object's command that is to be set. The first parameter is 1, the second is 2, and so on; must be1
or greaterx
- ajava.sql.Timestamp
objectcal
- thejava.util.Calendar
object the driver can use to construct the timestamp- Throws:
SQLException
- if an error occurs or the parameter index is out of bounds- See Also:
getParams()
-
clearParameters
public void clearParameters() throws SQLException
Clears all of the current parameter values in thisRowSet
object's internal representation of the parameters to be set in thisRowSet
object's command when it is executed.In general, parameter values remain in force for repeated use in this
RowSet
object's command. Setting a parameter value with the setter methods automatically clears the value of the designated parameter and replaces it with the new specified value.This method is called internally by the
setCommand
method to clear all of the parameters set for the previous command.Furthermore, this method differs from the
initParams
method in that it maintains the schema of theRowSet
object.- Throws:
SQLException
- if an error occurs clearing the parameters
-
getParams
public Object[] getParams() throws SQLException
Retrieves an array containing the parameter values (both Objects and primitives) that have been set for thisRowSet
object's command and throws anSQLException
object if all parameters have not been set. Before the command is sent to the DBMS to be executed, these parameters will be substituted for placeholder parameters in thePreparedStatement
object that is the command for aRowSet
implementation extending theBaseRowSet
class.Each element in the array that is returned is an
Object
instance that contains the values of the parameters supplied to a setter method. The order of the elements is determined by the value supplied for parameterIndex. If the setter method takes only the parameter index and the value to be set (possibly null), the array element will contain the value to be set (which will be expressed as anObject
). If there are additional parameters, the array element will itself be an array containing the value to be set plus any additional parameter values supplied to the setter method. If the method sets a stream, the array element includes the type of stream being supplied to the method. These additional parameters are for the use of the driver or the DBMS and may or may not be used.NOTE: Stored parameter values of types
Array
,Blob
,Clob
andRef
are returned asSerialArray
,SerialBlob
,SerialClob
andSerialRef
respectively.- Returns:
- an array of
Object
instances that includes the parameter values that may be set in thisRowSet
object's command; an empty array if no parameters have been set - Throws:
SQLException
- if an error occurs retrieveing the object array of parameters of thisRowSet
object or if not all parameters have been set
-
setNull
public void setNull(String parameterName, int sqlType) throws SQLException
Sets the designated parameter to SQLNULL
.Note: You must specify the parameter's SQL type.
- Parameters:
parameterName
- the name of the parametersqlType
- the SQL type code defined injava.sql.Types
- Throws:
SQLException
- 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.4
-
setNull
public void setNull(String parameterName, int sqlType, String typeName) throws SQLException
Sets the designated parameter to SQLNULL
. This version of the methodsetNull
should be used for user-defined types and REF type parameters. Examples of user-defined types include: STRUCT, DISTINCT, JAVA_OBJECT, and named array types.Note: To be portable, applications must give the SQL type code and the fully-qualified SQL type name when specifying a NULL user-defined or REF parameter. In the case of a user-defined type the name is the type name of the parameter itself. For a REF parameter, the name is the type name of the referenced type. If a JDBC driver does not need the type code or type name information, it may ignore it. Although it is intended for user-defined and Ref parameters, this method may be used to set a null parameter of any JDBC type. If the parameter does not have a user-defined or REF type, the given typeName is ignored.
- Parameters:
parameterName
- the name of the parametersqlType
- a value fromjava.sql.Types
typeName
- the fully-qualified name of an SQL user-defined type; ignored if the parameter is not a user-defined type or SQLREF
value- Throws:
SQLException
- 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.4
-
setBoolean
public void setBoolean(String parameterName, boolean x) throws SQLException
Sets the designated parameter to the given Javaboolean
value. The driver converts this to an SQLBIT
orBOOLEAN
value when it sends it to the database.- Parameters:
parameterName
- the name of the parameterx
- the parameter value- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
setByte
public void setByte(String parameterName, byte x) throws SQLException
Sets the designated parameter to the given Javabyte
value. The driver converts this to an SQLTINYINT
value when it sends it to the database.- Parameters:
parameterName
- the name of the parameterx
- the parameter value- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
setShort
public void setShort(String parameterName, short x) throws SQLException
Sets the designated parameter to the given Javashort
value. The driver converts this to an SQLSMALLINT
value when it sends it to the database.- Parameters:
parameterName
- the name of the parameterx
- the parameter value- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
setInt
public void setInt(String parameterName, int x) throws SQLException
Sets the designated parameter to the given Javaint
value. The driver converts this to an SQLINTEGER
value when it sends it to the database.- Parameters:
parameterName
- the name of the parameterx
- the parameter value- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
setLong
public void setLong(String parameterName, long x) throws SQLException
Sets the designated parameter to the given Javalong
value. The driver converts this to an SQLBIGINT
value when it sends it to the database.- Parameters:
parameterName
- the name of the parameterx
- the parameter value- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
setFloat
public void setFloat(String parameterName, float x) throws SQLException
Sets the designated parameter to the given Javafloat
value. The driver converts this to an SQLFLOAT
value when it sends it to the database.- Parameters:
parameterName
- the name of the parameterx
- the parameter value- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
setDouble
public void setDouble(String parameterName, double x) throws SQLException
Sets the designated parameter to the given Javadouble
value. The driver converts this to an SQLDOUBLE
value when it sends it to the database.- Parameters:
parameterName
- the name of the parameterx
- the parameter value- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
setBigDecimal
public void setBigDecimal(String parameterName, BigDecimal x) throws SQLException
Sets the designated parameter to the givenjava.math.BigDecimal
value. The driver converts this to an SQLNUMERIC
value when it sends it to the database.- Parameters:
parameterName
- the name of the parameterx
- the parameter value- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
setString
public void setString(String parameterName, String x) throws SQLException
Sets the designated parameter to the given JavaString
value. The driver converts this to an SQLVARCHAR
orLONGVARCHAR
value (depending on the argument's size relative to the driver's limits onVARCHAR
values) when it sends it to the database.- Parameters:
parameterName
- the name of the parameterx
- the parameter value- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
setBytes
public void setBytes(String parameterName, byte[] x) throws SQLException
Sets the designated parameter to the given Java array of bytes. The driver converts this to an SQLVARBINARY
orLONGVARBINARY
(depending on the argument's size relative to the driver's limits onVARBINARY
values) when it sends it to the database.- Parameters:
parameterName
- the name of the parameterx
- the parameter value- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
setTimestamp
public void setTimestamp(String parameterName, Timestamp x) throws SQLException
Sets the designated parameter to the givenjava.sql.Timestamp
value. The driver converts this to an SQLTIMESTAMP
value when it sends it to the database.- Parameters:
parameterName
- the name of the parameterx
- the parameter value- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
setAsciiStream
public void setAsciiStream(String parameterName, InputStream x, int 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 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.4
-
setBinaryStream
public void setBinaryStream(String parameterName, InputStream x, int 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 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.4
-
setCharacterStream
public void setCharacterStream(String parameterName, Reader reader, int 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 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.4
-
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 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 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 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(int parameterIndex, Reader value) throws SQLException
Sets the designated parameter in thisRowSet
object's command 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 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
-
setObject
public void setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException
Sets the value of the designated parameter with the given object. The second argument must be an object type; for integral values, thejava.lang
equivalent objects should be used.The given Java object will be converted to the given targetSqlType before being sent to the database. If the object has a custom mapping (is of a class implementing the interface
SQLData
), the JDBC driver should call the methodSQLData.writeSQL
to write it to the SQL data stream. If, on the other hand, the object is of a class implementingRef
,Blob
,Clob
,NClob
,Struct
,java.net.URL
, orArray
, the driver should pass it to the database as a value of the corresponding SQL type.Note that this method may be used to pass datatabase- specific abstract data types.
- Parameters:
parameterName
- the name of the parameterx
- the object containing the input parameter valuetargetSqlType
- the SQL type (as defined in java.sql.Types) to be sent to the database. The scale argument may further qualify this type.scale
- for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, this is the number of digits after the decimal point. For all other types, this value will be ignored.- Throws:
SQLException
- if a database access error occurs or this method is called on a closedCallableStatement
SQLFeatureNotSupportedException
- iftargetSqlType
is aARRAY
,BLOB
,CLOB
,DATALINK
,JAVA_OBJECT
,NCHAR
,NCLOB
,NVARCHAR
,LONGNVARCHAR
,REF
,ROWID
,SQLXML
orSTRUCT
data type and the JDBC driver does not support this data type- Since:
- 1.4
- See Also:
Types
,getParams()
-
setObject
public void setObject(String parameterName, Object x, int targetSqlType) throws SQLException
Sets the value of the designated parameter with the given object. This method is like the methodsetObject
above, except that it assumes a scale of zero.- Parameters:
parameterName
- the name of the parameterx
- the object containing the input parameter valuetargetSqlType
- the SQL type (as defined in java.sql.Types) to be sent to the database- Throws:
SQLException
- if a database access error occurs or this method is called on a closedCallableStatement
SQLFeatureNotSupportedException
- iftargetSqlType
is aARRAY
,BLOB
,CLOB
,DATALINK
,JAVA_OBJECT
,NCHAR
,NCLOB
,NVARCHAR
,LONGNVARCHAR
,REF
,ROWID
,SQLXML
orSTRUCT
data type and the JDBC driver does not support this data type- Since:
- 1.4
- See Also:
getParams()
-
setObject
public void setObject(String parameterName, Object x) throws SQLException
Sets the value of the designated parameter with the given object. The second parameter must be of typeObject
; therefore, thejava.lang
equivalent objects should be used for built-in types.The JDBC specification specifies a standard mapping from Java
Object
types to SQL types. The given argument will be converted to the corresponding SQL type before being sent to the database.Note that this method may be used to pass datatabase- specific abstract data types, by using a driver-specific Java type. If the object is of a class implementing the interface
SQLData
, the JDBC driver should call the methodSQLData.writeSQL
to write it to the SQL data stream. If, on the other hand, the object is of a class implementingRef
,Blob
,Clob
,NClob
,Struct
,java.net.URL
, orArray
, the driver should pass it to the database as a value of the corresponding SQL type.This method throws an exception if there is an ambiguity, for example, if the object is of a class implementing more than one of the interfaces named above.
- Parameters:
parameterName
- the name of the parameterx
- the object containing the input parameter value- Throws:
SQLException
- if a database access error occurs, this method is called on a closedCallableStatement
or if the givenObject
parameter is ambiguousSQLFeatureNotSupportedException
- if the JDBC driver does not support this method- Since:
- 1.4
- See Also:
getParams()
-
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 a database access error occurs, this method is called on a closedPreparedStatement
, if parameterIndex does not correspond to a parameter marker in the SQL statement, 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
-
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 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(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 parameterIndex does not correspond to a parameter marker in the SQL statement, or if the length specified is less than zero; if the number of bytes in the inputstream does not match the specfied 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
-
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 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 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(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 a database access error occurs, this method is called on a closedPreparedStatement
, if parameterIndex does not correspond to a parameter marker in the SQL statement, or if the length specified is less than zero.SQLFeatureNotSupportedException
- if the JDBC driver does not support this method- 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 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(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 parameterIndex does not correspond to a parameter marker in the SQL statement; 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
-
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 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 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
-
setDate
public void setDate(String parameterName, Date x) throws SQLException
Sets the designated parameter to the givenjava.sql.Date
value using the default time zone of the virtual machine that is running the application. The driver converts this to an SQLDATE
value when it sends it to the database.- Parameters:
parameterName
- the name of the parameterx
- the parameter value- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
setDate
public void setDate(String parameterName, Date x, Calendar cal) throws SQLException
Sets the designated parameter to the givenjava.sql.Date
value, using the givenCalendar
object. The driver uses theCalendar
object to construct an SQLDATE
value, which the driver then sends to the database. With a aCalendar
object, the driver can calculate the date taking into account a custom timezone. If noCalendar
object is specified, the driver uses the default timezone, which is that of the virtual machine running the application.- Parameters:
parameterName
- the name of the parameterx
- the parameter valuecal
- theCalendar
object the driver will use to construct the date- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
setTime
public void setTime(String parameterName, Time x) throws SQLException
Sets the designated parameter to the givenjava.sql.Time
value. The driver converts this to an SQLTIME
value when it sends it to the database.- Parameters:
parameterName
- the name of the parameterx
- the parameter value- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
setTime
public void setTime(String parameterName, Time x, Calendar cal) throws SQLException
Sets the designated parameter to the givenjava.sql.Time
value, using the givenCalendar
object. The driver uses theCalendar
object to construct an SQLTIME
value, which the driver then sends to the database. With a aCalendar
object, the driver can calculate the time taking into account a custom timezone. If noCalendar
object is specified, the driver uses the default timezone, which is that of the virtual machine running the application.- Parameters:
parameterName
- the name of the parameterx
- the parameter valuecal
- theCalendar
object the driver will use to construct the time- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
setTimestamp
public void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException
Sets the designated parameter to the givenjava.sql.Timestamp
value, using the givenCalendar
object. The driver uses theCalendar
object to construct an SQLTIMESTAMP
value, which the driver then sends to the database. With a aCalendar
object, the driver can calculate the timestamp taking into account a custom timezone. If noCalendar
object is specified, the driver uses the default timezone, which is that of the virtual machine running the application.- Parameters:
parameterName
- the name of the parameterx
- the parameter valuecal
- theCalendar
object the driver will use to construct the timestamp- Throws:
SQLException
- 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.4
- See Also:
getParams()
-
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 a database access error occurs, this method is called on a closed result set, thejava.xml.transform.Result
,Writer
orOutputStream
has not been closed for theSQLXML
object or if there is an error processing the XML value. ThegetCause
method of the exception may provide a more detailed exception, for example, if the stream does not contain valid XML.- 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 a database access error occurs, this method is called on a closed result set, thejava.xml.transform.Result
,Writer
orOutputStream
has not been closed for theSQLXML
object or if there is an error processing the XML value. ThegetCause
method of the exception may provide a more detailed exception, for example, if the stream does not contain valid XML.- 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 a database access error occurs- 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 a database access error occurs- Since:
- 1.6
-
setNString
public void setNString(int parameterIndex, String value) throws SQLException
Sets the designated paramter 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 the driver does not support national character sets; if the driver can detect that a data conversion error could occur ; or if a database access error occurs- Since:
- 1.6
-
setNString
public void setNString(String parameterName, String value) throws SQLException
Sets the designated paramter to the givenString
object. The driver converts this to a SQLNCHAR
orNVARCHAR
orLONGNVARCHAR
- Parameters:
parameterName
- the name of the column to be setvalue
- the parameter value- Throws:
SQLException
- if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; or if a database access error occurs- 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 the driver does not support national character sets; if the driver can detect that a data conversion error could occur ; or if a database access error occurs- 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 column to be setvalue
- the parameter valuelength
- the number of characters in the parameter data.- Throws:
SQLException
- if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; or if a database access error occurs- 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 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 value) throws SQLException
Sets the designated parameter to ajava.sql.NClob
object. The object implements thejava.sql.NClob
interface. ThisNClob
object maps to a SQLNCLOB
.- Parameters:
parameterName
- the name of the column to be setvalue
- the parameter value- Throws:
SQLException
- if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; or if a database access error occurs- 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 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 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 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(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
-
setNClob
public void setNClob(int parameterIndex, NClob value) throws SQLException
Sets the designated parameter to ajava.sql.NClob
object. The driver converts this oa 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 the driver does not support national character sets; if the driver can detect that a data conversion error could occur ; or if a database access error occurs- 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
-
setURL
public void setURL(int parameterIndex, URL x) throws SQLException
Sets the designated parameter to the givenjava.net.URL
value. The driver converts this to an SQLDATALINK
value when it sends it to the database.- Parameters:
parameterIndex
- the first parameter is 1, the second is 2, ...x
- thejava.net.URL
object to be set- Throws:
SQLException
- 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.4
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
22/12/2024 14:36:42 Cette version de la page est en cache (à la date du 22/12/2024 14:36:42) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 15/09/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/sql/rowset/baserowset.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.