Interface RowSetReader
- 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 TypeMethodDescriptionvoidreadData(RowSetInternal caller) Reads the new contents of the callingRowSetobject.
-
Method Details
-
readData
Reads the new contents of the callingRowSetobject. In order to call this method, aRowSetobject must have implemented theRowSetInternalinterface and registered thisRowSetReaderobject as its reader. ThereadDatamethod is invoked internally by theRowSet.executemethod for rowsets that support the reader/writer paradigm.The
readDatamethod 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 methodexecutewill cause anSQLExceptionto be thrown becauseexecutemay not be called recursively. Also, when a reader invokesRowSetmethods, no listeners are notified; that is, noRowSetEventobjects are generated and noRowSetListenermethods are invoked. This is true because listeners are already being notified by the methodexecute.- Parameters:
caller- theRowSetobject (1) that has implemented theRowSetInternalinterface, (2) with which this reader is registered, and (3) whoseexecutemethod called this reader- Throws:
SQLException- if a database access error occurs or this method invokes theRowSet.executemethod
-