Interface RowSetReader
-
- All Known Subinterfaces:
- XmlReader
public interface RowSetReader
The facility that a disconnectedRowSet
object calls on to populate itself with rows of data. A reader (an object implementing theRowSetReader
interface) may be registered with aRowSet
object that supports the reader/writer paradigm. When theRowSet
object'sexecute
method is called, it in turn calls the reader'sreadData
method.- Since:
- 1.4
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method and Description void
readData(RowSetInternal caller)
Reads the new contents of the callingRowSet
object.
-
-
-
Method Detail
readData
void readData(RowSetInternal caller) throws SQLException
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
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.