org.apache.dubbo.registry.client

Interface ServiceDiscovery

All Superinterfaces:

Comparable<Prioritized>, Prioritized, RegistryService

All Known Implementing Classes:

AbstractServiceDiscovery, NopServiceDiscovery, ReflectionBasedServiceDiscovery

public interface ServiceDiscovery
extends RegistryService, Prioritized

Defines the common operations of Service Discovery, extended and loaded by ServiceDiscoveryFactory

Field Summary

Fields inherited from interface org.apache.dubbo.common.lang.Prioritized

COMPARATOR, MAX_PRIORITY, MIN_PRIORITY, NORMAL_PRIORITY

Method Summary

Modifier and Type	Method and Description
default void	addServiceInstancesChangedListener(ServiceInstancesChangedListener listener)
default ServiceInstancesChangedListener	createListener(Set<String> serviceNames)
void	destroy() Destroy the ServiceDiscovery
default long	getDelay()
List<ServiceInstance>	getInstances(String serviceName)
ServiceInstance	getLocalInstance()
MetadataInfo	getLocalMetadata()
default MetadataInfo	getLocalMetadata(String revision)
MetadataInfo	getRemoteMetadata(String revision)
MetadataInfo	getRemoteMetadata(String revision, List<ServiceInstance> instances)
Set<String>	getServices() Gets all service names
default URL	getUrl()
default boolean	isAvailable() Get services is the default way for service discovery to be available
boolean	isDestroy()
void	register()
default void	removeServiceInstancesChangedListener(ServiceInstancesChangedListener listener) unsubscribe to instance change event.
String	toString() A human-readable description of the implementation
void	unregister()
void	update()

Methods inherited from interface org.apache.dubbo.registry.RegistryService

lookup, register, subscribe, unregister, unsubscribe

Methods inherited from interface org.apache.dubbo.common.lang.Prioritized

compareTo, getPriority

Method Detail

register

void register()
       throws RuntimeException

Throws:

RuntimeException

update

void update()
     throws RuntimeException

Throws:

RuntimeException

unregister

void unregister()
         throws RuntimeException

Throws:

RuntimeException

getServices

Set<String> getServices()

Gets all service names

Returns:

non-null read-only Set

getInstances

List<ServiceInstance> getInstances(String serviceName)
                            throws NullPointerException

Throws:

NullPointerException

addServiceInstancesChangedListener

default void addServiceInstancesChangedListener(ServiceInstancesChangedListener listener)
                                         throws NullPointerException,
                                                IllegalArgumentException

Throws:

NullPointerException

IllegalArgumentException

removeServiceInstancesChangedListener

default void removeServiceInstancesChangedListener(ServiceInstancesChangedListener listener)
                                            throws IllegalArgumentException

unsubscribe to instance change event.

Parameters:

listener -

Throws:

IllegalArgumentException

createListener

default ServiceInstancesChangedListener createListener(Set<String> serviceNames)

getLocalInstance

ServiceInstance getLocalInstance()

getLocalMetadata

MetadataInfo getLocalMetadata()

getLocalMetadata

default MetadataInfo getLocalMetadata(String revision)

getRemoteMetadata

MetadataInfo getRemoteMetadata(String revision)

getRemoteMetadata

MetadataInfo getRemoteMetadata(String revision,
                               List<ServiceInstance> instances)

destroy

void destroy()
      throws Exception

Destroy the ServiceDiscovery

Throws:

Exception - If met with error

isDestroy

boolean isDestroy()

getUrl

default URL getUrl()

getDelay

default long getDelay()

isAvailable

default boolean isAvailable()

Get services is the default way for service discovery to be available

toString

String toString()

A human-readable description of the implementation

Overrides:

toString in class Object

Returns:

The description.