eu.xtreemos.xosd.srdsaccess.resmng
Interface IResourceDiscoveryListener


public interface IResourceDiscoveryListener

The interface for resource discovery query completion listener. The listener provides the means for the resource discovery engine to send the results back to the caller service. The listener provides a pair of methods for each query type: the success notification and the failure notification. The success method receives the outcome of the discovery query. The failure method, on the other hand, receives the exception caught or provided when the discovery query fails. The class implementing the listener should also have the means to store the connection between the call and the notification (e.g. Context), usually as a class embedded within a service class.

Author:
matej.artac@xlab.si

Method Summary
 void queryCallFailed(java.lang.Exception exception)
          The query failure invocation method, receiving the exception caught or produced at the error.
 void queryCallSucceeded(java.util.ArrayList<CommunicationAddress> nodeAddressList)
          The query success invocation method, receiving the list of communication addresses of the resources selected by the query.
 void queryCallSucceededGLUE(java.util.ArrayList<java.util.Hashtable<java.lang.String,java.lang.Object>> nodes)
          The query success invocation method, receiving the list of GLUE descriptions of the nodes selected by the query.
 

Method Detail

queryCallSucceeded

void queryCallSucceeded(java.util.ArrayList<CommunicationAddress> nodeAddressList)
The query success invocation method, receiving the list of communication addresses of the resources selected by the query.

Parameters:
nodeAddressList - The collection of communication addresses of the resources selected by the query.

queryCallSucceededGLUE

void queryCallSucceededGLUE(java.util.ArrayList<java.util.Hashtable<java.lang.String,java.lang.Object>> nodes)
The query success invocation method, receiving the list of GLUE descriptions of the nodes selected by the query. TODO: we also need CommunicationAddress!

Parameters:
nodeAddressList - The collection of GLUE descriptions in their parsed, searchable form.

queryCallFailed

void queryCallFailed(java.lang.Exception exception)
The query failure invocation method, receiving the exception caught or produced at the error.

Parameters:
exception - The exception caught or produced at the error.