|
Préférences
Moteurs de recherche
|
||||||||||||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.6.0
javax.sql.rowset
|
Field Summary |
---|
Fields inherited from interface java.sql.ResultSet |
---|
CLOSE_CURSORS_AT_COMMIT, CONCUR_READ_ONLY, CONCUR_UPDATABLE, FETCH_FORWARD, FETCH_REVERSE, FETCH_UNKNOWN, HOLD_CURSORS_OVER_COMMIT, TYPE_FORWARD_ONLY, TYPE_SCROLL_INSENSITIVE, TYPE_SCROLL_SENSITIVE |
Method Summary | |
---|---|
void |
commit()
Each JdbcRowSet contains a Connection object from
the ResultSet or JDBC properties passed to it's constructors. |
boolean |
getAutoCommit()
Each JdbcRowSet contains a Connection object from
the original ResultSet or JDBC properties passed to it. |
RowSetWarning |
getRowSetWarnings()
Retrieves the first warning reported by calls on this JdbcRowSet
object. |
boolean |
getShowDeleted()
Retrieves a boolean indicating whether rows marked
for deletion appear in the set of current rows. |
void |
rollback()
Each JdbcRowSet contains a Connection object from
the original ResultSet or JDBC properties passed to it. |
void |
rollback(Savepoint s)
Each JdbcRowSet contains a Connection object from
the original ResultSet or JDBC properties passed to it. |
void |
setAutoCommit(boolean autoCommit)
Each JdbcRowSet contains a Connection object from
the original ResultSet or JDBC properties passed to it. |
void |
setShowDeleted(boolean b)
Sets the property showDeleted to the given
boolean value. |
Methods inherited from interface java.sql.Wrapper |
---|
isWrapperFor, unwrap |
Methods inherited from interface javax.sql.rowset.Joinable |
---|
getMatchColumnIndexes, getMatchColumnNames, setMatchColumn, setMatchColumn, setMatchColumn, setMatchColumn, unsetMatchColumn, unsetMatchColumn, unsetMatchColumn, unsetMatchColumn |
Method Detail |
---|
boolean getShowDeleted() throws SQLException
boolean
indicating whether rows marked
for deletion appear in the set of current rows. If true
is
returned, deleted rows are visible with the current rows. If
false
is returned, rows are not visible with the set of
current rows. The default value is false
.
Standard rowset implementations may choose to restrict this behavior for security considerations or for certain deployment scenarios. The visibility of deleted rows is implementation-defined and does not represent standard behavior.
Note: Allowing deleted rows to remain visible complicates the behavior
of some standard JDBC RowSet
implementations methods.
However, most rowset users can simply ignore this extra detail because
only very specialized applications will likely want to take advantage of
this feature.
true
if deleted rows are visible;
false
otherwise
SQLException
- if a rowset implementation is unable to
to determine whether rows marked for deletion remain visiblesetShowDeleted(boolean)
void setShowDeleted(boolean b) throws SQLException
showDeleted
to the given
boolean
value. This property determines whether
rows marked for deletion continue to appear in the set of current rows.
If the value is set to true
, deleted rows are immediately
visible with the set of current rows. If the value is set to
false
, the deleted rows are set as invisible with the
current set of rows.
Standard rowset implementations may choose to restrict this behavior for security considerations or for certain deployment scenarios. This is left as implementation-defined and does not represent standard behavior.
b
- true
if deleted rows should be shown;
false
otherwise
SQLException
- if a rowset implementation is unable to
to reset whether deleted rows should be visiblegetShowDeleted()
RowSetWarning getRowSetWarnings() throws SQLException
JdbcRowSet
object.
If a second warning was reported on this JdbcRowSet
object,
it will be chained to the first warning and can be retrieved by
calling the method RowSetWarning.getNextWarning
on the
first warning. Subsequent warnings on this JdbcRowSet
object will be chained to the RowSetWarning
objects
returned by the method RowSetWarning.getNextWarning
.
The warning chain is automatically cleared each time a new row is read.
This method may not be called on a RowSet
object
that has been closed;
doing so will cause an SQLException
to be thrown.
Because it is always connected to its data source, a JdbcRowSet
object can rely on the presence of active
Statement
, Connection
, and ResultSet
instances. This means that applications can obtain additional
SQLWarning
notifications by calling the getNextWarning
methods that
they provide.
Disconnected Rowset
objects, such as a
CachedRowSet
object, do not have access to
these getNextWarning
methods.
RowSetWarning
object reported on this JdbcRowSet
object
or null
if there are none
SQLException
- if this method is called on a closed
JdbcRowSet
objectRowSetWarning
void commit() throws SQLException
JdbcRowSet
contains a Connection
object from
the ResultSet
or JDBC properties passed to it's constructors.
This method wraps the Connection
commit method to allow flexible
auto commit or non auto commit transactional control support.
Makes all changes made since the previous commit/rollback permanent and releases any database locks currently held by this Connection object. This method should be used only when auto-commit mode has been disabled.
SQLException
- if a database access error occurs or this
Connection object within this JdbcRowSet
is in auto-commit modeConnection.setAutoCommit(boolean)
boolean getAutoCommit() throws SQLException
JdbcRowSet
contains a Connection
object from
the original ResultSet
or JDBC properties passed to it. This
method wraps the Connection
's getAutoCommit
method
to allow an application to determine the JdbcRowSet
transaction
behavior.
Sets this connection's auto-commit mode to the given state. If a connection is in auto-commit mode, then all its SQL statements will be executed and committed as individual transactions. Otherwise, its SQL statements are grouped into transactions that are terminated by a call to either the method commit or the method rollback. By default, new connections are in auto-commit mode.
SQLException
- if a database access error occursConnection.getAutoCommit()
void setAutoCommit(boolean autoCommit) throws SQLException
JdbcRowSet
contains a Connection
object from
the original ResultSet
or JDBC properties passed to it. This
method wraps the Connection
's getAutoCommit
method
to allow an application to set the JdbcRowSet
transaction behavior.
Sets the current auto-commit mode for this Connection
object.
SQLException
- if a database access error occursConnection.setAutoCommit(boolean)
void rollback() throws SQLException
JdbcRowSet
contains a Connection
object from
the original ResultSet
or JDBC properties passed to it.
Undoes all changes made in the current transaction and releases any
database locks currently held by this Connection
object. This method
should be used only when auto-commit mode has been disabled.
SQLException
- if a database access error occurs or this Connection
object within this JdbcRowSet
is in auto-commit mode.rollback(Savepoint)
void rollback(Savepoint s) throws SQLException
JdbcRowSet
contains a Connection
object from
the original ResultSet
or JDBC properties passed to it.
Undoes all changes made in the current transaction to the last set savepoint
and releases any database locks currently held by this Connection
object. This method should be used only when auto-commit mode has been disabled.
SQLException
- if a database access error occurs or this Connection
object within this JdbcRowSet
is in auto-commit mode.rollback()