-
- All Known Subinterfaces:
XmlReader
public interface RowSetReaderThe facility that a disconnectedRowSetobject calls on to populate itself with rows of data. A reader (an object implementing theRowSetReaderinterface) may be registered with aRowSetobject that supports the reader/writer paradigm. When theRowSetobject'sexecutemethod is called, it in turn calls the reader'sreadDatamethod.- Since:
- 1.4
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description voidreadData(RowSetInternal caller)Reads the new contents of the callingRowSetobject.
-
-
-
Method Detail
-
readData
void readData(RowSetInternal caller) throws SQLException
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
-
-