| java.lang.Object
 org.apache.ojb.odmg.oql.OQLQueryImpl
| OQLQueryImpl | | public class OQLQueryImpl implements EnhancedOQLQuery,Configurable(Code) | | The OQL query interface implementation.
version:
$Id: OQLQueryImpl.java,v 1.18.2.5 2005/12/21 22:29:53 tomdz Exp $ |
| Method Summary | |
| public void | bind(Object parameter)
Bind a parameter to the query. | | public void | configure(Configuration pConfig)
| | public void | create(String queryString)
Create an OQL query from the string parameter.
In order to execute a query, an OQLQuery object must be created
by calling Implementation.newOQLQuery, then calling the
create method with the query string.
The create method might throw QueryInvalidException
if the query could not be compiled properly. | | public void | create(String queryString, int startAtIndex, int endAtIndex)
| | public Object | execute()
Execute the query.
After executing a query, the parameter list is reset.
Some implementations may throw additional exceptions that are also derived
from ODMGException.
The object that represents the result of the query.The returned data, whatever its OQL type, is encapsulated into an object.For instance, when OQL returns an integer, the result is put into anInteger object. | | public int | fullSize()
| | protected ListIterator | getBindIterator()
Gets the bindIterator. | | protected Class | getCollectionClass()
| | protected OdmgConfiguration | getConfiguration()
| | public Query | getQuery()
| | protected void | performLockingIfRequired(TransactionImpl tx, PersistenceBroker broker, ManageableCollection result)
|
| OQLQueryImpl | | public OQLQueryImpl(PBKey pbKey)(Code) | |
Parameters:
pbKey - |
| bind | | public void bind(Object parameter) throws org.odmg.QueryParameterCountInvalidException, org.odmg.QueryParameterTypeInvalidException(Code) | | Bind a parameter to the query.
A parameter is denoted in the query string passed to create by $i,
where i is the rank of the parameter, beginning with 1.
The parameters are set consecutively by calling this method bind.
The ith variable is set by the ith call to the bind method.
If any of the $i are not set by a call to bind at the point
execute is called, QueryParameterCountInvalidException is thrown.
The parameters must be objects, and the result is an Object.
Objects must be used instead of primitive types (Integer instead
of int) for passing the parameters.
If the parameter is of the wrong type,
QueryParameterTypeInvalidException is thrown.
After executing a query, the parameter list is reset.
Parameters:
parameter - A value to be substituted for a query parameter.
exception:
org.odmg.QueryParameterCountInvalidException - The number of calls tobind has exceeded the number of parameters in the query.
exception:
org.odmg.QueryParameterTypeInvalidException - The type of the parameter doesnot correspond with the type of the parameter in the query. |
| create | | public void create(String queryString) throws org.odmg.QueryInvalidException(Code) | | Create an OQL query from the string parameter.
In order to execute a query, an OQLQuery object must be created
by calling Implementation.newOQLQuery, then calling the
create method with the query string.
The create method might throw QueryInvalidException
if the query could not be compiled properly. Some implementations may not want
to compile the query before execute is called. In this case
QueryInvalidException is thrown when execute is called.
Parameters:
queryString - An OQL query.
exception:
QueryInvalidException - The query syntax is invalid. |
| execute | | public Object execute() throws org.odmg.QueryException(Code) | | Execute the query.
After executing a query, the parameter list is reset.
Some implementations may throw additional exceptions that are also derived
from ODMGException.
The object that represents the result of the query.The returned data, whatever its OQL type, is encapsulated into an object.For instance, when OQL returns an integer, the result is put into anInteger object. When OQL returns a collection (literal or object),the result is always a Java collection object of the same kind(for instance, a DList).
exception:
org.odmg.QueryException - An exception has occurred while executing the query. |
| fullSize | | public int fullSize()(Code) | | |
| getBindIterator | | protected ListIterator getBindIterator()(Code) | | Gets the bindIterator.
Returns a ListIterator |
| getCollectionClass | | protected Class getCollectionClass()(Code) | | returns the collection type to be used to contain oql query result sets
|
| getQuery | | public Query getQuery()(Code) | | returns the compiled query object
|
|
|