org.exolab.castor.jdo
Interface QueryResults

All Superinterfaces:

java.util.Enumeration

public interface QueryResults

extends java.util.Enumeration

An iteration of the results of a query. This interface provides the ability to move forward only in the result set and pick the next result and close it.

Version:

$Revision: 1.1.1.1 $ $Date: 2003/03/03 07:08:08 $

Author:

Assaf Arkin

Method Summary

boolean	absolute(int row) moves the result of the query to the absolute position in the resultset
void	close() Closes the result set and releases all resources held by it.
boolean	hasMore() Returns true if there are any more results in the result set.
java.lang.Object	next() Returns the next result in the result set.
int	size() finds the size of the resulting resultset from the query.

Methods inherited from interface java.util.Enumeration

hasMoreElements, nextElement

Method Detail

hasMore

public boolean hasMore()
                throws PersistenceException

Returns true if there are any more results in the result set. If an error occured reading the last result, an exception will be thrown and the result set cannot be used further.

Returns:

True if there are any more results in the result set

Throws:

PersistenceException - An error with the persistence engine

next

public java.lang.Object next()
                      throws PersistenceException,
                             java.util.NoSuchElementException

Returns the next result in the result set. If there are no more results (a previous cal to hasMore() returns false) this method will throw an exceptin. If an error occured reading the last result, an exception will be thrown and the result set cannot be used further.

Returns:

The next result in the result set

Throws:

PersistenceException - An error with the persistence engine

java.util.NoSuchElementException - There are no more results in the result set

close

public void close()

Closes the result set and releases all resources held by it.

absolute

public boolean absolute(int row)
                 throws PersistenceException

moves the result of the query to the absolute position in the resultset

Throws:

PersistenceException - A persistence error occured

size

public int size()
         throws PersistenceException

finds the size of the resulting resultset from the query.

Throws:

PersistenceException