Package org.kiwiproject.registry.client

Class MultiRegistryClient

java.lang.Object

org.kiwiproject.registry.client.MultiRegistryClient

All Implemented Interfaces:

RegistryClient

public class MultiRegistryClient
extends Object
implements RegistryClient

A RegistryClient that finds services in more than one registry.

Nested Class Summary

Nested classes/interfaces inherited from interface org.kiwiproject.registry.client.RegistryClient

RegistryClient.InstanceQuery

Constructor Summary

Constructors

Constructor	Description
MultiRegistryClient(List<RegistryClient> registryClients)	Construct a new instance with the specfied RegistryClients to use when performing service lookups.

Method Summary

Modifier and Type	Method	Description
List<ServiceInstance>	findAllServiceInstancesBy(RegistryClient.InstanceQuery query)	Attempts to find all service instances from the given RegistryClient.InstanceQuery.
Optional<ServiceInstance>	findServiceInstanceBy(String serviceName, String instanceId)	Attempts to find a service instance with the given service name and the given instance id.
static MultiRegistryClient	of(RegistryClient... registryClients)	Factory method to create a new instance from the given RegistryClients.
List<ServiceInstance>	retrieveAllRegisteredInstances()	Retrieves all registered service instances from the registry.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.kiwiproject.registry.client.RegistryClient

findAllServiceInstancesBy, findServiceInstanceBy, findServiceInstanceBy

Constructor Detail

MultiRegistryClient

public MultiRegistryClient(List<RegistryClient> registryClients)

Construct a new instance with the specfied RegistryClients to use when performing service lookups. The order in the provided list is the order in which the service lookups will occur.

Parameters:

registryClients - a list of RegistryClient instances to use; must have at least one RegistryClient

Method Detail

of

public static MultiRegistryClient of(RegistryClient... registryClients)

Factory method to create a new instance from the given RegistryClients.

Parameters:

registryClients - the RegistryClient instances to use; must have at least one RegistryClient

Returns:

a new MultiRegistryClient instance

findServiceInstanceBy

public Optional<ServiceInstance> findServiceInstanceBy(String serviceName,
                                                       String instanceId)

Attempts to find a service instance with the given service name and the given instance id.

Returns the first ServiceInstance it finds, checking each RegistryClient in order.

Specified by:

findServiceInstanceBy in interface RegistryClient

Parameters:

serviceName - The name of the service that is being requested

instanceId - The id of the instance that is wanted

Returns:

an Optional containing the found service or Optional.empty()

findAllServiceInstancesBy

public List<ServiceInstance> findAllServiceInstancesBy(RegistryClient.InstanceQuery query)

Attempts to find all service instances from the given RegistryClient.InstanceQuery.

Returns all services that match the query from all RegistryClients that return any results, checking each RegistryClient in order.

Specified by:

findAllServiceInstancesBy in interface RegistryClient

Parameters:

query - a RegistryClient.InstanceQuery containing the search parameters to find the instance

Returns:

a List containing the found services

retrieveAllRegisteredInstances

public List<ServiceInstance> retrieveAllRegisteredInstances()

Retrieves all registered service instances from the registry.

Returns all registered services from all RegistryClients that return any results, checking each RegistryClient in order.

Specified by:

retrieveAllRegisteredInstances in interface RegistryClient

Returns:

a List containing all registered service instances