org.exolab.castor.jdo

Interface QueryResults

All Superinterfaces:
Enumeration
Known Implementing Classes:
OQLQueryImpl.OQLEnumeration, SimpleQueryExecutor.SimpleQueryResults

public interface QueryResults
extends 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.
Object
next()
Returns the next result in the result set.
int
size()
finds the size of the resulting resultset from the query.

Method Details

absolute

public boolean absolute(int row)
            throws PersistenceException
moves the result of the query to the absolute position in the resultset
Parameters:
Throws:
PersistenceException - A persistence error occured

close

public void close()
Closes the result set and releases all resources held by it.

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 Object next()
            throws PersistenceException,
                   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

size

public int size()
            throws PersistenceException
finds the size of the resulting resultset from the query.

Intalio Inc. (C) 1999-2003. All rights reserved http://www.intalio.com