Package org.exolab.castor.jdo.engine
Class OQLQueryImpl
- java.lang.Object
-
- org.exolab.castor.jdo.engine.OQLQueryImpl
-
public class OQLQueryImpl extends java.lang.Object implements Query, OQLQuery
An OQLQuery implementation to execute a query based upon an OQL statement.- Version:
- $Revision: 8141 $ $Date: 2006-04-25 15:08:23 -0600 (Tue, 25 Apr 2006) $
- Author:
- Assaf Arkin
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description (package private) class
OQLQueryImpl.OQLEnumeration
Enumeration
implementation to traverse the result as returned by the execution of the OQL query.
-
Constructor Summary
Constructors Constructor Description OQLQueryImpl(Database database)
Creates an instance to execute a query based upon an OQL statement.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description 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
bind(java.lang.Object value)
Bind a parameter value to the query.void
close()
Close the query and release all resources held by the query.void
create(java.lang.String oql)
Creates an OQL query from the supplied statement.void
createCall(java.lang.String oql)
QueryResults
execute()
Execute the query.QueryResults
execute(boolean scrollable)
This is used for cursor support.QueryResults
execute(AccessMode accessMode)
Execute the query.QueryResults
execute(AccessMode accessMode, boolean scrollable)
This is used for cursor support.java.lang.String
getSQL()
Get the generated SQL statement for this OQLQuery.
-
-
-
Constructor Detail
-
OQLQueryImpl
OQLQueryImpl(Database database)
Creates an instance to execute a query based upon an OQL statement.- Parameters:
database
- The Castor database to run the query against.
-
-
Method Detail
-
bind
public void bind(java.lang.Object value)
Description copied from interface:Query
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.
-
bind
public void bind(boolean value)
Description copied from interface:Query
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.
-
bind
public void bind(short value)
Description copied from interface:Query
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.
-
bind
public void bind(int value)
Description copied from interface:Query
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.
-
bind
public void bind(long value)
Description copied from interface:Query
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.
-
bind
public void bind(float value)
Description copied from interface:Query
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.
-
bind
public void bind(double value)
Description copied from interface:Query
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.
-
create
public void create(java.lang.String oql) throws PersistenceException
Description copied from interface:OQLQuery
Creates an OQL query from the supplied statement.- Specified by:
create
in interfaceOQLQuery
- Parameters:
oql
- An OQL query statement- Throws:
PersistenceException
-
createCall
public void createCall(java.lang.String oql) throws QueryException
- Parameters:
oql
-- Throws:
QueryException
-
execute
public QueryResults execute() throws PersistenceException
Description copied from interface:Query
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 interfaceQuery
- Returns:
- Query results (zero or more objects)
- Throws:
QueryException
- The query expression cannot be processed, or the query parameters are invalidTransactionNotInProgressException
- Method called while transaction is not in progressPersistenceException
- An error reported by the persistence engine
-
execute
public QueryResults execute(boolean scrollable) throws PersistenceException
Description copied from interface:Query
This is used for cursor support. Experimental- Specified by:
execute
in interfaceQuery
- Throws:
PersistenceException
-
execute
public QueryResults execute(AccessMode accessMode) throws PersistenceException
Description copied from interface:Query
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 interfaceQuery
- 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 invalidTransactionNotInProgressException
- Method called while transaction is not in progressPersistenceException
- An error reported by the persistence engine
-
execute
public QueryResults execute(AccessMode accessMode, boolean scrollable) throws PersistenceException
Description copied from interface:Query
This is used for cursor support. Experimental- Specified by:
execute
in interfaceQuery
- Throws:
PersistenceException
-
getSQL
public java.lang.String getSQL() throws QueryException
Get the generated SQL statement for this OQLQuery.- Returns:
- A SQL statement.
- Throws:
QueryException
- If the SQL query cannot be generated.
-
-