Package org.somda.sdc.dpws.soap.wsdiscovery

Interface WsDiscoveryClient

All Superinterfaces:

Interceptor

All Known Implementing Classes:

WsDiscoveryClientInterceptor

public interface WsDiscoveryClient
extends Interceptor

Ws-Discovery Client interface.

See Also:

Conceptual Message Content

Method Summary

Modifier and Type	Method	Description
void	registerHelloByeAndProbeMatchesObserver(HelloByeAndProbeMatchesObserver observer)	Register an observer to handle Hello, Bye and ProbeMatches messages.
com.google.common.util.concurrent.ListenableFuture<ProbeMatchesType>	sendDirectedProbe(RequestResponseClient rrClient, List<QName> types, List<String> scopes)	Sends a directed probe to a device.
com.google.common.util.concurrent.ListenableFuture<Integer>	sendProbe(String probeId, Collection<QName> types, Collection<String> scopes)	Sends a probe message using the given parameters.
com.google.common.util.concurrent.ListenableFuture<Integer>	sendProbe(String probeId, Collection<QName> types, Collection<String> scopes, Integer maxResults)	Sends a probe message using the given parameters with a limited number of results until future finishes.
com.google.common.util.concurrent.ListenableFuture<ResolveMatchesType>	sendResolve(EndpointReferenceType epr)	Sends a resolve message for a given endpoint reference.
void	unregisterHelloByeAndProbeMatchesObserver(HelloByeAndProbeMatchesObserver observer)	Unregister an observer handling Hello, Bye and ProbeMatches messages.

Method Detail

sendProbe

com.google.common.util.concurrent.ListenableFuture<Integer> sendProbe(String probeId,
                                                                      Collection<QName> types,
                                                                      Collection<String> scopes)
                                                               throws MarshallingException,
                                                                      TransportException,
                                                                      InterceptorException

Sends a probe message using the given parameters.

ProbeMatches messages are handled by the observers.

Parameters:

probeId - of the probe

types - to probe for

scopes - to probe for

Returns:

Future containing the number of matches within the given timeout.

Throws:

MarshallingException - on marshalling issues in the outgoing message

TransportException - on transport issues in the outgoing message

InterceptorException - on preprocessing issues with the outgoing message

See Also:

registerHelloByeAndProbeMatchesObserver(HelloByeAndProbeMatchesObserver)

sendProbe

com.google.common.util.concurrent.ListenableFuture<Integer> sendProbe(String probeId,
                                                                      Collection<QName> types,
                                                                      Collection<String> scopes,
                                                                      Integer maxResults)
                                                               throws MarshallingException,
                                                                      TransportException,
                                                                      InterceptorException

Sends a probe message using the given parameters with a limited number of results until future finishes.

ProbeMatches messages are handled by the observers.

Parameters:

probeId - of the probe

types - to probe for

scopes - to probe for

maxResults - number of results to wait for at most

Returns:

Future containing the number of matches within the given timeout.

Throws:

MarshallingException - on marshalling issues in the outgoing message

TransportException - on transport issues in the outgoing message

InterceptorException - on preprocessing issues with the outgoing message

See Also:

registerHelloByeAndProbeMatchesObserver(HelloByeAndProbeMatchesObserver)

sendDirectedProbe

com.google.common.util.concurrent.ListenableFuture<ProbeMatchesType> sendDirectedProbe(RequestResponseClient rrClient,
                                                                                       List<QName> types,
                                                                                       List<String> scopes)

Sends a directed probe to a device.

Parameters:

rrClient - to send request on

types - to probe for

scopes - to probe for

Returns:

future providing probe matches response

TODO LDe: This is inconsistent with the rest, why does it not throw any exceptions?

sendResolve

com.google.common.util.concurrent.ListenableFuture<ResolveMatchesType> sendResolve(EndpointReferenceType epr)
                                                                            throws MarshallingException,
                                                                                   TransportException,
                                                                                   InterceptorException

Sends a resolve message for a given endpoint reference.

Parameters:

epr - to resolve for

Returns:

future providing resolve matches response

Throws:

MarshallingException - on marshalling issues in the outgoing message

TransportException - on transport issues in the outgoing message

InterceptorException - on preprocessing issues with the outgoing message

registerHelloByeAndProbeMatchesObserver

void registerHelloByeAndProbeMatchesObserver(HelloByeAndProbeMatchesObserver observer)

Register an observer to handle Hello, Bye and ProbeMatches messages.

Parameters:

observer - to listen on

unregisterHelloByeAndProbeMatchesObserver

void unregisterHelloByeAndProbeMatchesObserver(HelloByeAndProbeMatchesObserver observer)

Unregister an observer handling Hello, Bye and ProbeMatches messages.

Parameters:

observer - to unregister