org.asam.ods

Class _QueryEvaluatorStub

java.lang.Object

org.omg.CORBA.portable.ObjectImpl

org.asam.ods._QueryEvaluatorStub

All Implemented Interfaces:

java.io.Serializable, QueryEvaluator, QueryEvaluatorOperations, org.omg.CORBA.Object, org.omg.CORBA.portable.IDLEntity

public class _QueryEvaluatorStub
extends org.omg.CORBA.portable.ObjectImpl
implements QueryEvaluator

The ASAM ODS query evaluator interface allows to perform queries in synchronous mode and to create Query objects for asynchronous execution.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
_QueryEvaluatorStub()

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String[]	_ids()
Query	createQuery(java.lang.String queryStr, NameValue[] params) (25003) Create a query object to execute it in asynchronous mode.
InstanceElementIterator	getInstances(java.lang.String queryStr, NameValue[] params) (25000) Evaluate a query in synchronous mode.
NameValueSeqUnit[]	getTable(java.lang.String queryStr, NameValue[] params) (25002) Evaluate a query in synchronous mode.
NameValueUnitSequenceIterator	getTableRows(java.lang.String queryStr, NameValue[] params) (25001) Evaluate a query in synchronous mode.

Methods inherited from class org.omg.CORBA.portable.ObjectImpl

_create_request, _create_request, _duplicate, _get_delegate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_delegate, _set_policy_override, equals, hashCode, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.omg.CORBA.Object

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override

Constructor Detail

_QueryEvaluatorStub

public _QueryEvaluatorStub()

Method Detail

getInstances

public InstanceElementIterator getInstances(java.lang.String queryStr,
                                   NameValue[] params)
                                     throws AoException

(25000) Evaluate a query in synchronous mode.

Specified by:

getInstances in interface QueryEvaluatorOperations

Parameters:

queryStr - The query string.

params - Sequence of parameter names and values. The following parameters should be passed: Name: "MaxDuration"; Type: T_LONG Comment: Can be used to restrict the processing time. The time is given in milliseconds, Default value: 0 (no restriction)

Returns:

The result of the query as an instance element iterator.

Throws:

AoException - with the following possible error codes: AO_QUERY_TYPE_INVALID AO_QUERY_INVALID AO_QUERY_PROCESSING_ERROR AO_QUERY_TIMEOUT_EXCEEDED AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

getTableRows

public NameValueUnitSequenceIterator getTableRows(java.lang.String queryStr,
                                         NameValue[] params)
                                           throws AoException

(25001) Evaluate a query in synchronous mode.

Specified by:

getTableRows in interface QueryEvaluatorOperations

Parameters:

queryStr - The query string.

params - Sequence of parameter names and values. The following parameters should be passed: Name: "MaxDuration"; Type: T_LONG Comment: Can be used to restrict the processing time. The time is given in milliseconds, Default value: 0 (no restriction)

Returns:

The result of the query as a name value unit sequence iterator. Each name value unit tuple is one cell of the table. The name value unit sequence is one row of the table.

Throws:

AoException - with the following possible error codes: AO_QUERY_TYPE_INVALID AO_QUERY_INVALID AO_QUERY_PROCESSING_ERROR AO_QUERY_TIMEOUT_EXCEEDED AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

getTable

public NameValueSeqUnit[] getTable(java.lang.String queryStr,
                          NameValue[] params)
                            throws AoException

(25002) Evaluate a query in synchronous mode.

Specified by:

getTable in interface QueryEvaluatorOperations

Parameters:

queryStr - The query string.

params - Sequence of parameter names and values. The following parameters should be passed: Name: "MaxDuration"; Type: T_LONG Comment: Can be used to restrict the processing time. The time is given in milliseconds, Default value: 0 (no restriction)

Returns:

The result of the query as a name value sequence unit sequence. Each name value sequence unit tuple is one column of the table. The name value sequence unit sequence is the table. The result structure can be very huge.

Throws:

AoException - with the following possible error codes: AO_QUERY_TYPE_INVALID AO_QUERY_INVALID AO_QUERY_PROCESSING_ERROR AO_QUERY_TIMEOUT_EXCEEDED AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

createQuery

public Query createQuery(java.lang.String queryStr,
                NameValue[] params)
                  throws AoException

(25003) Create a query object to execute it in asynchronous mode.

Specified by:

createQuery in interface QueryEvaluatorOperations

Parameters:

queryStr - The query string

params - Sequence of parameter names and values. The following parameters should be passed: Name: "QueryResultType"; Type: ResultType. Comment: Specifies what kind of result is expected by the client. Default value: INSTELEM_ITERATOR_AS_RESULT Name: "MaxDuration"; Type: T_LONG Comment: Can be used to restrict the processing time. The time is given in milliseconds, Default value: 0 (no restriction)

Returns:

The query object.

Throws:

AoException - with the following possible error codes: AO_QUERY_TYPE_INVALID AO_QUERY_INVALID AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

_ids

public java.lang.String[] _ids()

Specified by:

_ids in class org.omg.CORBA.portable.ObjectImpl