org.wildfly.discovery.impl

Class MutableDiscoveryProvider

java.lang.Object

org.wildfly.discovery.impl.MutableDiscoveryProvider

All Implemented Interfaces:

DiscoveryProvider

public final class MutableDiscoveryProvider
extends Object
implements DiscoveryProvider

A discovery provider which can be mutated at run time to delegate to a new provider.

Author:

David M. Lloyd

Field Summary

Fields inherited from interface org.wildfly.discovery.spi.DiscoveryProvider

EMPTY

Constructor Summary

Constructors

Constructor and Description
MutableDiscoveryProvider() Construct a new instance using an empty provider.
MutableDiscoveryProvider(DiscoveryProvider initialProvider) Construct a new instance.

Method Summary

Modifier and Type	Method and Description
DiscoveryRequest	discover(ServiceType serviceType, FilterSpec filterSpec, DiscoveryResult result) Attempt to discover implementations of a service.
void	setDiscoveryProvider(DiscoveryProvider delegateProvider) Set the discovery provider instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

MutableDiscoveryProvider

public MutableDiscoveryProvider(DiscoveryProvider initialProvider)

Construct a new instance.

Parameters:

initialProvider - the initial provider to use (must not be null)

MutableDiscoveryProvider

public MutableDiscoveryProvider()

Construct a new instance using an empty provider.

Method Detail

setDiscoveryProvider

public void setDiscoveryProvider(DiscoveryProvider delegateProvider)

Set the discovery provider instance.

Parameters:

delegateProvider - the discovery provider instance (must not be null)

discover

public DiscoveryRequest discover(ServiceType serviceType,
                                 FilterSpec filterSpec,
                                 DiscoveryResult result)

Description copied from interface: DiscoveryProvider

Attempt to discover implementations of a service. Matches must be written to the DiscoveryResult.addMatch(ServiceURL) method on the result parameter as they are found. The DiscoveryResult.complete() method must be called when the discovery process is complete or has timed out or failed for any other reason, otherwise discovery clients may hang indefinitely.

The discovery process should be asynchronous if possible. In this case, this method should return as soon as possible in order to unblock the calling thread quickly and allow other discovery mechanisms to proceed. The discovery process will not be considered complete until the result's completion method is called, even if such a call comes from a different thread.

Specified by:

discover in interface DiscoveryProvider

Parameters:

serviceType - the service type to match

filterSpec - the service attribute filter expression, or null to return all matches

result - the discovery result