|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface RegistryService
RegistryService. (SPI, Prototype, ThreadSafe)
Registry
,
RegistryFactory.getRegistry(URL)
Method Summary | |
---|---|
List<URL> |
lookup(URL url)
查询符合条件的已注册数据,与订阅的推模式相对应,这里为拉模式,只返回一次结果。 |
void |
register(URL url)
注册数据,比如:提供者地址,消费者地址,路由规则,覆盖规则,等数据。 |
void |
subscribe(URL url,
NotifyListener listener)
订阅符合条件的已注册数据,当有注册数据变更时自动推送. |
void |
unregister(URL url)
取消注册. |
void |
unsubscribe(URL url,
NotifyListener listener)
取消订阅. |
Method Detail |
---|
void register(URL url)
注册需处理契约:
1. 当URL设置了check=false时,注册失败后不报错,在后台定时重试,否则抛出异常。
2. 当URL设置了dynamic=false参数,则需持久存储,否则,当注册者出现断电等情况异常退出时,需自动删除。
3. 当URL设置了category=routers时,表示分类存储,缺省类别为providers,可按分类部分通知数据。
4. 当注册中心重启,网络抖动,不能丢失数据,包括断线自动删除数据。
5. 允许URI相同但参数不同的URL并存,不能覆盖。
url
- 注册信息,不允许为空,如:dubbo://10.20.153.10/com.alibaba.foo.BarService?version=1.0.0&application=kylinvoid unregister(URL url)
取消注册需处理契约:
1. 如果是dynamic=false的持久存储数据,找不到注册数据,则抛IllegalStateException,否则忽略。
2. 按全URL匹配取消注册。
url
- 注册信息,不允许为空,如:dubbo://10.20.153.10/com.alibaba.foo.BarService?version=1.0.0&application=kylinvoid subscribe(URL url, NotifyListener listener)
订阅需处理契约:
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. 必须阻塞订阅过程,等第一次通知完后再返回。
url
- 订阅条件,不允许为空,如:consumer://10.20.153.10/com.alibaba.foo.BarService?version=1.0.0&application=kylinlistener
- 变更事件监听器,不允许为空void unsubscribe(URL url, NotifyListener listener)
取消订阅需处理契约:
1. 如果没有订阅,直接忽略。
2. 按全URL匹配取消订阅。
url
- 订阅条件,不允许为空,如:consumer://10.20.153.10/com.alibaba.foo.BarService?version=1.0.0&application=kylinlistener
- 变更事件监听器,不允许为空List<URL> lookup(URL url)
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)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |