edu.cmu.aura.service
Class PrimitiveServiceStub

java.lang.Object
  |
  +--edu.cmu.aura.service.rpc.GenericStub
        |
        +--edu.cmu.aura.service.PrimitiveServiceStub

All Implemented Interfaces:

PrimitiveService, java.rmi.Remote

public class PrimitiveServiceStub

extends edu.cmu.aura.service.rpc.GenericStub

implements PrimitiveService

PrimitiveServiceStub provides client side support for calling PrimitiveService methods.

Constructor Summary

PrimitiveServiceStub(edu.cmu.aura.service.rpc.RemoteReference dest)
Create a PrimitiveServiceStub.

PrimitiveServiceStub(java.lang.String hostName, int port)
Create a PrimitiveServiceStub.

Method Summary

int	postQuery(java.util.ArrayList selectedAttributes, java.util.ArrayList fromServices, edu.cmu.aura.service.query.ExpressionNode expression, java.util.ArrayList attribReqs, long timeLimit, long execInterval, edu.cmu.aura.service.rpc.RemoteReference queryClient) Query a service recurrently.
QueryResult	query(java.util.ArrayList selectedAttributes, java.util.ArrayList fromServices, edu.cmu.aura.service.query.ExpressionNode expression, java.util.ArrayList attribReqs, long timeLimit) Query a service.
void	removeQuery(java.lang.String serviceName, int queryID) Remove a recurrent query.

Methods inherited from class edu.cmu.aura.service.rpc.GenericStub

setDest

Methods inherited from class java.lang.Object

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

Constructor Detail

PrimitiveServiceStub

public PrimitiveServiceStub(java.lang.String hostName,
                            int port)

Create a PrimitiveServiceStub.

Parameters:

dest - the RemoteReference of this service.

PrimitiveServiceStub

public PrimitiveServiceStub(edu.cmu.aura.service.rpc.RemoteReference dest)

Create a PrimitiveServiceStub.

Parameters:

dest - the RemoteReference of this service.

Method Detail

query

public QueryResult query(java.util.ArrayList selectedAttributes,
                         java.util.ArrayList fromServices,
                         edu.cmu.aura.service.query.ExpressionNode expression,
                         java.util.ArrayList attribReqs,
                         long timeLimit)
                  throws java.rmi.RemoteException,
                         edu.cmu.aura.service.QueryExecutionException

Query a service.

Specified by:

query in interface PrimitiveService

Parameters:

selectedAttribs - the attribs to select.

serviceNames - names of services to retrieve attributes from.

expression - expression selecting which entities or relations in the service should be returned.

attribReqs - requirements on dynamic attributes.

timeLimit - this is used by clients to inform the service on when they need the results by. This may also be viewed as a suggestion on how hard to work to retrieve the results.

Returns:

the QueryResult of the query.

postQuery

public int postQuery(java.util.ArrayList selectedAttributes,
                     java.util.ArrayList fromServices,
                     edu.cmu.aura.service.query.ExpressionNode expression,
                     java.util.ArrayList attribReqs,
                     long timeLimit,
                     long execInterval,
                     edu.cmu.aura.service.rpc.RemoteReference queryClient)
              throws java.rmi.RemoteException,
                     edu.cmu.aura.service.QueryExecutionException

Query a service recurrently.

Specified by:

postQuery in interface PrimitiveService

Parameters:

selectedAttribs - the attribs to select.

serviceNames - names of services to retrieve attributes from.

expression - expression selecting which entities or relations in the service should be returned.

attribReqs - requirements on dynamic attributes.

timeLimit - this is used by clients to inform the service on when they need the results by. This may also be viewed as a suggestion on how hard to work to retrieve the results.

execInterval - interval at which to query the service.

Returns:

the QueryResult of the query.

removeQuery

public void removeQuery(java.lang.String serviceName,
                        int queryID)
                 throws java.rmi.RemoteException

Remove a recurrent query.

Specified by:

removeQuery in interface PrimitiveService

Parameters:

serviceName - name of the service to remove the query from.

queryID - the ID of the query to remove.