org.wildfly.discovery

Class Discovery

java.lang.Object

org.wildfly.discovery.Discovery

public final class Discovery
extends Object

The service discovery API. Each discovery instance is associated with discovery providers which are able to provide answers to discovery queries.

Author:

David M. Lloyd

Method Summary

Modifier and Type	Method and Description
static Discovery	create(DiscoveryProvider... providers) Create a discovery object with the given providers.
static Discovery	create(DiscoveryProvider provider) Create a discovery object with the given single provider.
ServicesQueue	discover(ServiceType serviceType, FilterSpec filterSpec) Perform a service discovery.

Methods inherited from class java.lang.Object

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

Method Detail

discover

public ServicesQueue discover(ServiceType serviceType,
                              FilterSpec filterSpec)

Perform a service discovery. The returned services queue is populated as discovery answers become available. Answers may be cached within each provider. The order of answers is not significant and can vary from call to call, especially with asynchronous discovery mechanisms. The returned service queue may be closed to indicate no further interest in query answers, and for this purpose it implements AutoCloseable in order to facilitate simple usage in a try-with-resources block.

Parameters:

serviceType - the abstract or concrete type of service to search for

filterSpec - the service filter specification

Returns:

the services queue

create

public static Discovery create(DiscoveryProvider... providers)

Create a discovery object with the given providers. The given providers argument and its array elements may not be null.

Parameters:

providers - the discovery providers (must not be null)

Returns:

the discovery object

create

public static Discovery create(DiscoveryProvider provider)

Create a discovery object with the given single provider. The given provider argument may not be null.

Parameters:

provider - the discovery provider (must not be null)

Returns:

the discovery object