Package org.apache.commons.dbutils
Class ResultSetIterator
java.lang.Object
org.apache.commons.dbutils.ResultSetIterator
Wraps a ResultSet
in an Iterator<Object[]>
. This is useful
when you want to present a non-database application layer with domain
neutral data.
This implementation requires the ResultSet.isLast()
method
to be implemented.
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate final RowProcessor
The processor to use when converting a row into an Object[].private final ResultSet
The wrappedResultSet
. -
Constructor Summary
ConstructorsConstructorDescriptionConstructor for ResultSetIterator.ResultSetIterator
(ResultSet rs, RowProcessor convert) Constructor for ResultSetIterator. -
Method Summary
Modifier and TypeMethodDescriptionboolean
hasNext()
Returns true if there are more rows in the ResultSet.Generates anIterable
, suitable for use in for-each loops.Object[]
next()
Returns the next row as anObject[]
.void
remove()
Deletes the current row from theResultSet
.protected void
Rethrow the SQLException as a RuntimeException.Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface java.util.Iterator
forEachRemaining
-
Field Details
-
rs
The wrappedResultSet
. -
convert
The processor to use when converting a row into an Object[].
-
-
Constructor Details
-
ResultSetIterator
Constructor for ResultSetIterator.- Parameters:
rs
- Wrap thisResultSet
in anIterator
.
-
ResultSetIterator
Constructor for ResultSetIterator.- Parameters:
rs
- Wrap thisResultSet
in anIterator
.convert
- The processor to use when converting a row into anObject[]
. Defaults to aBasicRowProcessor
.
-
-
Method Details
-
hasNext
public boolean hasNext()Returns true if there are more rows in the ResultSet.- Specified by:
hasNext
in interfaceIterator<Object[]>
- Returns:
- boolean
true
if there are more rows - Throws:
RuntimeException
- if an SQLException occurs.
-
next
Returns the next row as anObject[]
.- Specified by:
next
in interfaceIterator<Object[]>
- Returns:
- An
Object[]
with the same number of elements as columns in theResultSet
. - Throws:
RuntimeException
- if an SQLException occurs.- See Also:
-
remove
public void remove()Deletes the current row from theResultSet
.- Specified by:
remove
in interfaceIterator<Object[]>
- Throws:
RuntimeException
- if an SQLException occurs.- See Also:
-
rethrow
Rethrow the SQLException as a RuntimeException. This implementation creates a new RuntimeException with the SQLException's error message.- Parameters:
e
- SQLException to rethrow- Since:
- DbUtils 1.1
-
iterable
Generates anIterable
, suitable for use in for-each loops.- Parameters:
rs
- Wrap thisResultSet
in anIterator
.- Returns:
- an
Iterable
, suitable for use in for-each loops.
-