public interface OQLQuery
extends Query

An OQL query object. Obtained from the database and used to construct and execute a query on that database. All query operations are bound to the database transaction. Closing the database or the transaction will effectively close the query.

If the query specified parameters these parameters must be set (bound) before executing the query. Execution of the query will result in an enumeration of all the objects found by the query. The query can be re-executed by binding new parameters and calling the Query.execute() method a second time. A query can be re-execute while objects are still retrieved from a previous execution.

For example:

 Query        oql;
 QueryResults results;

 // Construct a new query and bind the id value
 oql = db.getQuery( "SELECT ... WHERE id=$1" );
 oql.bind( 5 );
 results = oql.execute();
 // Iterate over all the results and print them
 while ( results.hasMore() ) {
   System.out.println( results.next(); );
 }
 results.close();
 oql.close();