- All Known Subinterfaces:
XmlReader
public interface RowSetReader
The facility that a disconnected
RowSet
object calls on
to populate itself with rows of data. A reader (an object implementing the
RowSetReader
interface) may be registered with
a RowSet
object that supports the reader/writer paradigm.
When the RowSet
object's execute
method is
called, it in turn calls the reader's readData
method.- Since:
- 1.4
-
Method Summary
Modifier and TypeMethodDescriptionvoid
readData
(RowSetInternal caller) Reads the new contents of the callingRowSet
object.
-
Method Details
-
readData
Reads the new contents of the callingRowSet
object. In order to call this method, aRowSet
object must have implemented theRowSetInternal
interface and registered thisRowSetReader
object as its reader. ThereadData
method is invoked internally by theRowSet.execute
method for rowsets that support the reader/writer paradigm.The
readData
method adds rows to the caller. It can be implemented in a wide variety of ways and can even populate the caller with rows from a nonrelational data source. In general, a reader may invoke any of the rowset's methods, with one exception. Calling the methodexecute
will cause anSQLException
to be thrown becauseexecute
may not be called recursively. Also, when a reader invokesRowSet
methods, no listeners are notified; that is, noRowSetEvent
objects are generated and noRowSetListener
methods are invoked. This is true because listeners are already being notified by the methodexecute
.- Parameters:
caller
- theRowSet
object (1) that has implemented theRowSetInternal
interface, (2) with which this reader is registered, and (3) whoseexecute
method called this reader- Throws:
SQLException
- if a database access error occurs or this method invokes theRowSet.execute
method
-