org.exolab.castor.jdo

Interface OQLQuery

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 OQLQuery 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();
 

Version: $Revision: 1.4 $ $Date: 2004/10/01 20:44:12 $

Author: Assaf Arkin

See Also: Query

Method Summary
voidcreate(String query)
Creates an OQL query from the supplied statement.

Method Detail

create

public void create(String query)
Creates an OQL query from the supplied statement.

Parameters: query An OQL query statement

Throws: PersistenceException

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