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 SummaryModifier and TypeMethodDescriptionvoidreadData(RowSetInternal caller) Reads the new contents of the callingRowSetobject.
- 
Method Details- 
readDataReads 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- the- RowSetobject (1) that has implemented the- RowSetInternalinterface, (2) with which this reader is registered, and (3) whose- executemethod called this reader
- Throws:
- SQLException- if a database access error occurs or this method invokes the- RowSet.executemethod
 
 
-