AbstractServiceDiscovery (Apache Dubbo 3.1.7 API)

java.lang.Object
- org.apache.dubbo.registry.client.AbstractServiceDiscovery

所有已实现的接口:

Comparable<Prioritized>, Prioritized, ServiceDiscovery, RegistryService

直接已知子类:

NopServiceDiscovery, ReflectionBasedServiceDiscovery
```
public abstract class AbstractServiceDiscovery
extends Object
implements ServiceDiscovery
```
Each service discovery is bond to one application.

字段概要
- 从接口继承的字段 org.apache.dubbo.common.lang.Prioritized
  COMPARATOR, MAX_PRIORITY, MIN_PRIORITY, NORMAL_PRIORITY

构造器概要

构造器
构造器和说明
`AbstractServiceDiscovery(ApplicationModel applicationModel, URL registryURL)`
`AbstractServiceDiscovery(String serviceName, URL registryURL)`

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`void`	`destroy()` Destroy the `ServiceDiscovery`
`ServiceInstance`	`getLocalInstance()`
`MetadataInfo`	`getLocalMetadata()`
`MetadataInfo`	`getLocalMetadata(String revision)`
`MetadataInfo`	`getRemoteMetadata(String revision)`
`MetadataInfo`	`getRemoteMetadata(String revision, List<ServiceInstance> instances)`
`URL`	`getUrl()`
`boolean`	`isDestroy()`
`List<URL>`	`lookup(URL url)` Query the registered data that matches the conditions.
`void`	`register()`
`void`	`register(URL url)` Register data, such as : provider service, consumer address, route rule, override rule and other data.
`void`	`subscribe(URL url, NotifyListener listener)` Subscribe to eligible registered data and automatically push when the registered data is changed.
`void`	`unregister()`
`void`	`unregister(URL url)` Unregister Unregistering is required to support the contract: 1.
`void`	`unsubscribe(URL url, NotifyListener listener)` Unsubscribe Unsubscribing is required to support the contract: 1.
`void`	`update()` Update assumes that DefaultServiceInstance and its attributes will never get updated once created.

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 org.apache.dubbo.registry.client.ServiceDiscovery
addServiceInstancesChangedListener, createListener, getDelay, getInstances, getServices, removeServiceInstancesChangedListener, toString

从接口继承的方法 org.apache.dubbo.common.lang.Prioritized
compareTo, getPriority

- 构造器详细资料
  - AbstractServiceDiscovery
```
public AbstractServiceDiscovery(ApplicationModel applicationModel,
                                URL registryURL)
```
  - AbstractServiceDiscovery
```
public AbstractServiceDiscovery(String serviceName,
                                URL registryURL)
```
- 方法详细资料
  - register
```
public void register()
              throws RuntimeException
```
    指定者:
    
    register 在接口中 ServiceDiscovery
    
    抛出:
    
    RuntimeException
  - update
```
public void update()
            throws RuntimeException
```
    Update assumes that DefaultServiceInstance and its attributes will never get updated once created. Checking hasExportedServices() before registration guarantees that at least one service is ready for creating the instance.
    
    指定者:
    
    update 在接口中 ServiceDiscovery
    
    抛出:
    
    RuntimeException
  - unregister
```
public void unregister()
                throws RuntimeException
```
    指定者:
    
    unregister 在接口中 ServiceDiscovery
    
    抛出:
    
    RuntimeException
  - getLocalInstance
```
public final ServiceInstance getLocalInstance()
```
    指定者:
    
    getLocalInstance 在接口中 ServiceDiscovery
  - getLocalMetadata
```
public MetadataInfo getLocalMetadata()
```
    指定者:
    
    getLocalMetadata 在接口中 ServiceDiscovery
  - getLocalMetadata
```
public MetadataInfo getLocalMetadata(String revision)
```
    指定者:
    
    getLocalMetadata 在接口中 ServiceDiscovery
  - getRemoteMetadata
```
public MetadataInfo getRemoteMetadata(String revision,
                                      List<ServiceInstance> instances)
```
    指定者:
    
    getRemoteMetadata 在接口中 ServiceDiscovery
  - getRemoteMetadata
```
public MetadataInfo getRemoteMetadata(String revision)
```
    指定者:
    
    getRemoteMetadata 在接口中 ServiceDiscovery
  - destroy
```
public final void destroy()
                   throws Exception
```
    从接口复制的说明: ServiceDiscovery
    
    Destroy the ServiceDiscovery
    
    指定者:
    
    destroy 在接口中 ServiceDiscovery
    
    抛出:
    
    Exception - If met with error
  - isDestroy
```
public final boolean isDestroy()
```
    指定者:
    
    isDestroy 在接口中 ServiceDiscovery
  - register
```
public void register(URL url)
```
    从接口复制的说明: RegistryService
    
    Register data, such as : provider service, consumer address, route rule, override rule and other data.
    Registering is required to support the contract:
    1. When the URL sets the check=false parameter. When the registration fails, the exception is not thrown and retried in the background. Otherwise, the exception will be thrown.
    2. When URL sets the dynamic=false parameter, it needs to be stored persistently, otherwise, it should be deleted automatically when the registrant has an abnormal exit.
    3. When the URL sets category=routers, it means classified storage, the default category is providers, and the data can be notified by the classified section.
    4. When the registry is restarted, network jitter, data can not be lost, including automatically deleting data from the broken line.
    5. Allow URLs which have the same URL but different parameters to coexist,they can't cover each other.
    
    指定者:
    
    register 在接口中 RegistryService
    
    参数:
    
    url - Registration information , is not allowed to be empty, e.g: dubbo://10.20.153.10/org.apache.dubbo.foo.BarService?version=1.0.0&application=kylin
  - unregister
```
public void unregister(URL url)
```
    从接口复制的说明: RegistryService
    
    Unregister
    Unregistering is required to support the contract:
    1. If it is the persistent stored data of dynamic=false, the registration data can not be found, then the IllegalStateException is thrown, otherwise it is ignored.
    2. Unregister according to the full url match.
    
    指定者:
    
    unregister 在接口中 RegistryService
    
    参数:
    
    url - Registration information , is not allowed to be empty, e.g: dubbo://10.20.153.10/org.apache.dubbo.foo.BarService?version=1.0.0&application=kylin
  - subscribe
```
public void subscribe(URL url,
                      NotifyListener listener)
```
    从接口复制的说明: RegistryService
    
    Subscribe to eligible registered data and automatically push when the registered data is changed.
    Subscribing need to support contracts:
    1. When the URL sets the check=false parameter. When the registration fails, the exception is not thrown and retried in the background.
    2. When URL sets category=routers, it only notifies the specified classification data. Multiple classifications are separated by commas, and allows asterisk to match, which indicates that all categorical data are subscribed.
    3. Allow interface, group, version, and classifier as a conditional query, e.g.: interface=org.apache.dubbo.foo.BarService&version=1.0.0
    4. And the query conditions allow the asterisk to be matched, subscribe to all versions of all the packets of all interfaces, e.g. :interface=*&group=*&version=*&classifier=*
    5. When the registry is restarted and network jitter, it is necessary to automatically restore the subscription request.
    6. Allow URLs which have the same URL but different parameters to coexist,they can't cover each other.
    7. The subscription process must be blocked, when the first notice is finished and then returned.
    
    指定者:
    
    subscribe 在接口中 RegistryService
    
    参数:
    
    url - Subscription condition, not allowed to be empty, e.g. consumer://10.20.153.10/org.apache.dubbo.foo.BarService?version=1.0.0&application=kylin
    
    listener - A listener of the change event, not allowed to be empty
  - unsubscribe
```
public void unsubscribe(URL url,
                        NotifyListener listener)
```
    从接口复制的说明: RegistryService
    
    Unsubscribe
    Unsubscribing is required to support the contract:
    1. If you don't subscribe, ignore it directly.
    2. Unsubscribe by full URL match.
    
    指定者:
    
    unsubscribe 在接口中 RegistryService
    
    参数:
    
    url - Subscription condition, not allowed to be empty, e.g. consumer://10.20.153.10/org.apache.dubbo.foo.BarService?version=1.0.0&application=kylin
    
    listener - A listener of the change event, not allowed to be empty
  - lookup
```
public List<URL> lookup(URL url)
```
    从接口复制的说明: RegistryService
    
    Query the registered data that matches the conditions. Corresponding to the push mode of the subscription, this is the pull mode and returns only one result.
    
    指定者:
    
    lookup 在接口中 RegistryService
    
    参数:
    
    url - Query condition, is not allowed to be empty, e.g. consumer://10.20.153.10/org.apache.dubbo.foo.BarService?version=1.0.0&application=kylin
    
    返回:
    
    The registered information list, which may be empty, the meaning is the same as the parameters of org.apache.dubbo.registry.NotifyListener#notify(List).
    
    另请参阅:
    
    NotifyListener.notify(List)
  - getUrl
```
public URL getUrl()
```
    指定者:
    
    getUrl 在接口中 ServiceDiscovery

类 AbstractServiceDiscovery

字段概要

从接口继承的字段 org.apache.dubbo.common.lang.Prioritized

构造器概要

方法概要

从类继承的方法 java.lang.Object

从接口继承的方法 org.apache.dubbo.registry.client.ServiceDiscovery

从接口继承的方法 org.apache.dubbo.common.lang.Prioritized

构造器详细资料

AbstractServiceDiscovery

AbstractServiceDiscovery

方法详细资料

register

update

unregister

getLocalInstance

getLocalMetadata

getLocalMetadata

getRemoteMetadata

getRemoteMetadata

destroy

isDestroy

register

unregister

subscribe

unsubscribe

lookup

getUrl