Package rasj.odmg

Class RasOQLQuery

java.lang.Object

rasj.odmg.RasOQLQuery

All Implemented Interfaces:

OQLQuery, RasCommDefs

public class RasOQLQuery
extends java.lang.Object
implements OQLQuery, RasCommDefs

This class implements the ODMG OQLQuery interface.

Author:

Peter Zoller

Field Summary

Fields inherited from interface rasj.clientcommhttp.RasCommDefs

BIG_ENDIAN, BROWSER, LITTLE_ENDIAN, RASCLIENT, RESPONSE_ERROR, RESPONSE_INT, RESPONSE_MDDS, RESPONSE_OID, RESPONSE_OK, RESPONSE_OK_NEGATIVE, RESPONSE_SKALARS

Constructor Summary

Constructors

Constructor	Description
RasOQLQuery(RasImplementationInterface imp)	Constructor

Method Summary

Modifier and Type	Method	Description
void	bind(java.lang.Object parameter)	Binds a parameter to the query.
void	create(java.lang.String query)	Defines the query to be executed.
java.lang.Object	execute()	Execute the OQL query.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RasOQLQuery

public RasOQLQuery(RasImplementationInterface imp)

Constructor

Method Detail

create

public void create(java.lang.String query)
            throws QueryInvalidException

Defines the query to be executed.

Specified by:

create in interface OQLQuery

Parameters:

query - The OQL query string.

Throws:

QueryInvalidException - The query syntax is invalid.

bind

public void bind(java.lang.Object parameter)
          throws QueryParameterCountInvalidException,
                 QueryParameterTypeInvalidException

Binds a parameter to the query.

Specified by:

bind in interface OQLQuery

Parameters:

parameter - A value to be substituted for a query parameter.

Throws:

QueryParameterCountInvalidException - The number of calls to bind has exceeded the number of parameters in the query.

QueryParameterTypeInvalidException - The type of the parameter does not correspond with the type of the parameter in the query.

execute

public java.lang.Object execute()
                         throws QueryException

Execute the OQL query.

Specified by:

execute in interface OQLQuery

Returns:

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 an Integer 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).

Throws:

QueryException - An exception has occurred while executing the query.