AbstractRegistry (dubbo-registry-api 1.0.0-RELEASE API)

java.lang.Object
- com.alibaba.dubbo.registry.support.AbstractRegistry

所有已实现的接口:

com.alibaba.dubbo.common.Node, Registry, RegistryService

直接已知子类:

FailbackRegistry
```
public abstract class AbstractRegistry
extends Object
implements Registry
```
AbstractRegistry. (SPI, Prototype, ThreadSafe)

作者:

chao.liuc, william.liangf

构造器概要

构造器
构造器和说明

AbstractRegistry(com.alibaba.dubbo.common.URL url)

构造器
构造器和说明
`AbstractRegistry(com.alibaba.dubbo.common.URL url)`

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`void`	`destroy()`
`void`	`doSaveProperties(long version)`
`File`	`getCacheFile()`
`Properties`	`getCacheProperties()`
`List<com.alibaba.dubbo.common.URL>`	`getCacheUrls(com.alibaba.dubbo.common.URL url)`
`AtomicLong`	`getLastCacheChanged()`
`Map<com.alibaba.dubbo.common.URL,Map<String,List<com.alibaba.dubbo.common.URL>>>`	`getNotified()`
`Set<com.alibaba.dubbo.common.URL>`	`getRegistered()`
`Map<com.alibaba.dubbo.common.URL,Set<NotifyListener>>`	`getSubscribed()`
`com.alibaba.dubbo.common.URL`	`getUrl()`
`List<com.alibaba.dubbo.common.URL>`	`lookup(com.alibaba.dubbo.common.URL url)` 查询符合条件的已注册数据，与订阅的推模式相对应，这里为拉模式，只返回一次结果。
`void`	`register(com.alibaba.dubbo.common.URL url)` 注册数据，比如：提供者地址，消费者地址，路由规则，覆盖规则，等数据。
`void`	`subscribe(com.alibaba.dubbo.common.URL url, NotifyListener listener)` 订阅符合条件的已注册数据，当有注册数据变更时自动推送.
`String`	`toString()`
`void`	`unregister(com.alibaba.dubbo.common.URL url)` 取消注册.
`void`	`unsubscribe(com.alibaba.dubbo.common.URL url, NotifyListener listener)` 取消订阅.

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

从接口继承的方法 com.alibaba.dubbo.common.Node
isAvailable

- 构造器详细资料
  - AbstractRegistry
```
public AbstractRegistry(com.alibaba.dubbo.common.URL url)
```
- 方法详细资料
  - getUrl
```
public com.alibaba.dubbo.common.URL getUrl()
```
    指定者:
    
    getUrl 在接口中 com.alibaba.dubbo.common.Node
  - getRegistered
```
public Set<com.alibaba.dubbo.common.URL> getRegistered()
```
  - getSubscribed
```
public Map<com.alibaba.dubbo.common.URL,Set<NotifyListener>> getSubscribed()
```
  - getNotified
```
public Map<com.alibaba.dubbo.common.URL,Map<String,List<com.alibaba.dubbo.common.URL>>> getNotified()
```
  - getCacheFile
```
public File getCacheFile()
```
  - getCacheProperties
```
public Properties getCacheProperties()
```
  - getLastCacheChanged
```
public AtomicLong getLastCacheChanged()
```
  - doSaveProperties
```
public void doSaveProperties(long version)
```
  - getCacheUrls
```
public List<com.alibaba.dubbo.common.URL> getCacheUrls(com.alibaba.dubbo.common.URL url)
```
  - lookup
```
public List<com.alibaba.dubbo.common.URL> lookup(com.alibaba.dubbo.common.URL url)
```
    从接口复制的说明: RegistryService
    
    查询符合条件的已注册数据，与订阅的推模式相对应，这里为拉模式，只返回一次结果。
    
    指定者:
    
    lookup 在接口中 RegistryService
    
    参数:
    
    url - 查询条件，不允许为空，如：consumer://10.20.153.10/com.alibaba.foo.BarService?version=1.0.0&application=kylin
    
    返回:
    
    已注册信息列表，可能为空，含义同com.alibaba.dubbo.registry.NotifyListener#notify(List)的参数。
    
    另请参阅:
    
    NotifyListener.notify(List)
  - register
```
public void register(com.alibaba.dubbo.common.URL url)
```
    从接口复制的说明: RegistryService
    
    注册数据，比如：提供者地址，消费者地址，路由规则，覆盖规则，等数据。注册需处理契约：
    1. 当URL设置了check=false时，注册失败后不报错，在后台定时重试，否则抛出异常。
    2. 当URL设置了dynamic=false参数，则需持久存储，否则，当注册者出现断电等情况异常退出时，需自动删除。
    3. 当URL设置了category=routers时，表示分类存储，缺省类别为providers，可按分类部分通知数据。
    4. 当注册中心重启，网络抖动，不能丢失数据，包括断线自动删除数据。
    5. 允许URI相同但参数不同的URL并存，不能覆盖。
    
    指定者:
    
    register 在接口中 RegistryService
    
    参数:
    
    url - 注册信息，不允许为空，如：dubbo://10.20.153.10/com.alibaba.foo.BarService?version=1.0.0&application=kylin
  - unregister
```
public void unregister(com.alibaba.dubbo.common.URL url)
```
    从接口复制的说明: RegistryService
    
    取消注册. 取消注册需处理契约：
    1. 如果是dynamic=false的持久存储数据，找不到注册数据，则抛IllegalStateException，否则忽略。
    2. 按全URL匹配取消注册。
    
    指定者:
    
    unregister 在接口中 RegistryService
    
    参数:
    
    url - 注册信息，不允许为空，如：dubbo://10.20.153.10/com.alibaba.foo.BarService?version=1.0.0&application=kylin
  - subscribe
```
public void subscribe(com.alibaba.dubbo.common.URL url,
                      NotifyListener listener)
```
    从接口复制的说明: RegistryService
    
    订阅符合条件的已注册数据，当有注册数据变更时自动推送. 订阅需处理契约：
    1. 当URL设置了check=false时，订阅失败后不报错，在后台定时重试。
    2. 当URL设置了category=routers，只通知指定分类的数据，多个分类用逗号分隔，并允许星号通配，表示订阅所有分类数据。
    3. 允许以interface,group,version,classifier作为条件查询，如：interface=com.alibaba.foo.BarService&version=1.0.0
    4. 并且查询条件允许星号通配，订阅所有接口的所有分组的所有版本，或：interface=*&group=*&version=*&classifier=*
    5. 当注册中心重启，网络抖动，需自动恢复订阅请求。
    6. 允许URI相同但参数不同的URL并存，不能覆盖。
    7. 必须阻塞订阅过程，等第一次通知完后再返回。
    
    指定者:
    
    subscribe 在接口中 RegistryService
    
    参数:
    
    url - 订阅条件，不允许为空，如：consumer://10.20.153.10/com.alibaba.foo.BarService?version=1.0.0&application=kylin
    
    listener - 变更事件监听器，不允许为空
  - unsubscribe
```
public void unsubscribe(com.alibaba.dubbo.common.URL url,
                        NotifyListener listener)
```
    从接口复制的说明: RegistryService
    
    取消订阅. 取消订阅需处理契约：
    1. 如果没有订阅，直接忽略。
    2. 按全URL匹配取消订阅。
    
    指定者:
    
    unsubscribe 在接口中 RegistryService
    
    参数:
    
    url - 订阅条件，不允许为空，如：consumer://10.20.153.10/com.alibaba.foo.BarService?version=1.0.0&application=kylin
    
    listener - 变更事件监听器，不允许为空
  - destroy
```
public void destroy()
```
    指定者:
    
    destroy 在接口中 com.alibaba.dubbo.common.Node
  - toString
```
public String toString()
```
    覆盖:
    
    toString 在类中 Object

类 AbstractRegistry

构造器概要

方法概要

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

从接口继承的方法 com.alibaba.dubbo.common.Node

构造器详细资料

AbstractRegistry

方法详细资料

getUrl

getRegistered

getSubscribed

getNotified

getCacheFile

getCacheProperties

getLastCacheChanged

doSaveProperties

getCacheUrls

lookup

register

unregister

subscribe

unsubscribe

destroy

toString