org.wildfly.discovery.spi

Interface DiscoveryProvider

All Known Implementing Classes:

AggregateDiscoveryProvider, LocalRegistryAndDiscoveryProvider, MutableDiscoveryProvider, StaticDiscoveryProvider

public interface DiscoveryProvider

A discovery provider. This interface is implemented by all discovery provider implementations.

Author:

David M. Lloyd

Field Summary

Fields

Modifier and Type	Field and Description
static DiscoveryProvider	EMPTY The empty discovery provider.

Method Summary

Modifier and Type	Method and Description
DiscoveryRequest	discover(ServiceType serviceType, FilterSpec filterSpec, DiscoveryResult result) Attempt to discover implementations of a service.

Field Detail

EMPTY

static final DiscoveryProvider EMPTY

The empty discovery provider.

Method Detail

discover

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

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.

Parameters:

serviceType - the service type to match

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

result - the discovery result