org.jminor.common.db

Interface ResultIterator<T>

Type Parameters:

T - the type to fetch from the result set

All Superinterfaces:

java.lang.AutoCloseable

public interface ResultIterator<T>
extends java.lang.AutoCloseable

Iterates through a ResultSet fetching instances of T. Closes the ResultSet when iteration is finished or in case of an exception. NOTA BENE: the hasNext() method is not idempotent, calling it moves the cursor in the underlying result set so next() must be called before hasNext() is called again or you will miss rows.

Method Summary

Modifier and Type	Method and Description
void	close() Closes the underlying result set and other resources held by this iterator
boolean	hasNext() Returns true if a row is available in the underlying result set.
T	next()

Method Detail

hasNext

boolean hasNext()
         throws java.sql.SQLException

Returns true if a row is available in the underlying result set. NOTA BENE: This method is not idempotent, calling this method moves the cursor in the underlying result set so next() must be called before this method is called again or you will miss rows. Calls close() before returning false when iteration has been completed.

Returns:

true if a row is available in the underlying result set

Throws:

java.sql.SQLException - in case of an exception

next

T next()
throws java.sql.SQLException

Returns:

an instance of T fetched from the result set

Throws:

java.sql.SQLException - in case of an exception

close

void close()

Closes the underlying result set and other resources held by this iterator

Specified by:

close in interface java.lang.AutoCloseable