org.exolab.castor.jdo.engine

Class OQLQueryImpl

Implemented Interfaces:
OQLQuery, Query

public class OQLQueryImpl
extends java.lang.Object
implements Query, OQLQuery

Version:
$Revision: 1.3 $ $Date: 2003/04/16 21:53:48 $
Author:
Assaf Arkin

Nested Class Summary

(package private) class
OQLQueryImpl.OQLEnumeration

Constructor Summary

OQLQueryImpl(DatabaseImpl dbImpl)

Method Summary

void
bind(Object value)
Bind a parameter value to the query.
void
bind(boolean value)
Bind a parameter value to the query.
void
bind(double value)
Bind a parameter value to the query.
void
bind(float value)
Bind a parameter value to the query.
void
bind(int value)
Bind a parameter value to the query.
void
bind(long value)
Bind a parameter value to the query.
void
bind(short value)
Bind a parameter value to the query.
void
close()
Close the query and release all resources held by the query.
void
create(String oql)
Creates an OQL query from the supplied statement.
void
createCall(String oql)
QueryResults
execute()
Execute the query.
QueryResults
execute(boolean scrollable)
Experimental This is used for cursor support
QueryResults
execute(short accessMode)
Experimental

Execute the query.

QueryResults
execute(short accessMode, boolean scrollable)
String
getSQL()
Get the generated SQL statement for this OQLQuery

Constructor Details

OQLQueryImpl

(package private)  OQLQueryImpl(DatabaseImpl dbImpl)

Method Details

bind

public void bind(Object value)
Bind a parameter value to the query. Parameters are set in the order in which they appear in the query and must match in number and type of each parameter.
Specified by:
bind in interface Query
Parameters:
value - The parameter value

bind

public void bind(boolean value)
Bind a parameter value to the query. Parameters are set in the order in which they appear in the query and must match in number and type of each parameter.
Specified by:
bind in interface Query
Parameters:
value - The parameter value

bind

public void bind(double value)
Bind a parameter value to the query. Parameters are set in the order in which they appear in the query and must match in number and type of each parameter.
Specified by:
bind in interface Query
Parameters:
value - The parameter value

bind

public void bind(float value)
Bind a parameter value to the query. Parameters are set in the order in which they appear in the query and must match in number and type of each parameter.
Specified by:
bind in interface Query
Parameters:
value - The parameter value

bind

public void bind(int value)
Bind a parameter value to the query. Parameters are set in the order in which they appear in the query and must match in number and type of each parameter.
Specified by:
bind in interface Query
Parameters:
value - The parameter value

bind

public void bind(long value)
Bind a parameter value to the query. Parameters are set in the order in which they appear in the query and must match in number and type of each parameter.
Specified by:
bind in interface Query
Parameters:
value - The parameter value

bind

public void bind(short value)
Bind a parameter value to the query. Parameters are set in the order in which they appear in the query and must match in number and type of each parameter.
Specified by:
bind in interface Query
Parameters:
value - The parameter value

close

public void close()
Close the query and release all resources held by the query.
Specified by:
close in interface Query

create

public void create(String oql)
            throws QueryException
Creates an OQL query from the supplied statement.
Specified by:
create in interface OQLQuery
Parameters:
Throws:
QueryException - The query syntax is invalid

createCall

public void createCall(String oql)
            throws QueryException

execute

public QueryResults execute()
            throws QueryException,
                   PersistenceException,
                   TransactionNotInProgressException
Execute the query. The query is executed returning an enumeration of all the objects found. If no objects were found, the enumeration will be empty.

After execution the parameter list is reset. New parameters can be bound and the query re-executed.

Specified by:
execute in interface Query
Returns:
Query results (zero or more objects)
Throws:
QueryException - The query expression cannot be processed, or the query parameters are invalid
TransactionNotInProgressException - Method called while transaction is not in progress
PersistenceException - An error reported by the persistence engine

execute

public QueryResults execute(boolean scrollable)
            throws QueryException,
                   PersistenceException,
                   TransactionNotInProgressException
Experimental This is used for cursor support
Specified by:
execute in interface Query

execute

public QueryResults execute(short accessMode)
            throws QueryException,
                   PersistenceException,
                   TransactionNotInProgressException
Experimental

Execute the query. The query is executed returning an enumeration of all the objects found. If no objects were found, the enumeration will be empty.

After execution the parameter list is reset. New parameters can be bound and the query re-executed.

Specified by:
execute in interface Query
Parameters:
accessMode - The access mode
Returns:
Query results (zero or more objects)
Throws:
QueryException - The query expression cannot be processed, or the query parameters are invalid
TransactionNotInProgressException - Method called while transaction is not in progress
PersistenceException - An error reported by the persistence engine

execute

public QueryResults execute(short accessMode,
                            boolean scrollable)
            throws QueryException,
                   PersistenceException,
                   TransactionNotInProgressException
Specified by:
execute in interface Query

getSQL

public String getSQL()
            throws QueryException
Get the generated SQL statement for this OQLQuery

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