Access Keys:
Skip to content (Access Key - 0)

Federated Query Processor

compared with
Current by David Ervin
on Sep 24, 2010 15:50.

Key
This line was removed.
This word was removed. This word was added.
This line was added.

Changes (12)

View Page History
The Federated Query Results Client is a caGrid service client which can retrieve results and information about the current state of query processing from a Federated Query Processor Service which has been previously issued a query.

{toc}
The Federated Query Results Client has the same constructors that any standard Introduce generated service client would have, but only those constructors which take an Endpoint Reference Type should be used, since EPRs contain the necessary resource key to access the server-side query results resource.

Other methods specific to the Federated Query Results Client are as follows:

{code}public boolean isProcessingComplete() throws RemoteException
{code}This method simply returns _true_ if the Federated Query Processor Service has completed execution of the original DCQL query and results are available, or _false_ otherwise.
{code}
public boolean isProcessingComplete() throws RemoteException
{code}

{code}public DCQLQueryResultsCollection getResults() throws RemoteException, ProcessingNotCompleteFault, FederatedQueryProcessingFault, InternalErrorFault
{code}This method gets the DCQL query results from the resource to which the Federated Query Results Client is connected.  If processing has not yet completed (as indicated by the _isProcessingComplete_ method), this will throw a Processing Not Complete Fault.  Problems encountered while processing the query will cause a Federated Query Processing Fault to be thrown.
This method simply returns _true_ if the Federated Query Processor Service has completed execution of the original DCQL query and results are available, or _false_ otherwise.

{code}public CQLQueryResults getAggregateResults() throws RemoteException, FederatedQueryProcessingFault, ProcessingNotCompleteFault, InternalErrorFault
{code}This method behaves very similarly to the Federated Query Engine's _executeAndAggregate_ method.  It gets the DCQL query results as a single, aggregate CQL Query Results instance which can be processed further with the standard data service tools.
{code}
public DCQLQueryResultsCollection getResults() throws RemoteException,
ProcessingNotCompleteFault, FederatedQueryProcessingFault, InternalErrorFault
{code}

{code}public EnumerationResponseContainer enumerate() throws RemoteException, FederatedQueryProcessingFault, ProcessingNotCompleteFault, InternalErrorFault
{code}This method allows a client to make use of WS-Enumeration to retrieve results of DCQL query processing via an Enumeration client.
This method gets the DCQL query results from the resource to which the Federated Query Results Client is connected. If processing has not yet completed (as indicated by the _isProcessingComplete_ method), this will throw a Processing Not Complete Fault.  Problems encountered while processing the query will cause a Federated Query Processing Fault to be thrown.

{code}public TransferServiceContextReference transfer() throws RemoteException, FederatedQueryProcessingFault, ProcessingNotCompleteFault, InternalErrorFault
{code}
public CQLQueryResults getAggregateResults() throws RemoteException,
FederatedQueryProcessingFault, ProcessingNotCompleteFault, InternalErrorFault
{code}

This method behaves very similarly to the Federated Query Engine's _executeAndAggregate_ method. It gets the DCQL query results as a single, aggregate CQL Query Results instance which can be processed further with the standard data service tools.

{code}
public EnumerationResponseContainer enumerate() throws RemoteException,
FederatedQueryProcessingFault, ProcessingNotCompleteFault, InternalErrorFault
{code}

This method allows a client to make use of WS-Enumeration to retrieve results of DCQL query processing via an Enumeration client.

{code}
public TransferServiceContextReference transfer() throws RemoteException,
FederatedQueryProcessingFault, ProcessingNotCompleteFault, InternalErrorFault
{code}

{code}This method allows a client to use [caGrid's Transfer|transfer14:Home] tools to retrieve results of DCQL query processing via the Transfer client tools. This can help with the speed of large result set retrieval.
Last edited by
David Ervin (970 days ago) , ...
Adaptavist Theme Builder Powered by Atlassian Confluence