com.alibaba.dubbo.registry
Interface NotifyListener

All Known Implementing Classes:

RegistryDirectory

public interface NotifyListener

NotifyListener. (API, Prototype, ThreadSafe)

Author:

william.liangf

See Also:

RegistryService.subscribe(URL, NotifyListener)

Method Summary

void	notify(List<URL> urls) 当收到服务变更通知时触发。 通知需处理契约： 1.

Method Detail

notify

void notify(List<URL> urls)

当收到服务变更通知时触发。 通知需处理契约：
1. 总是以服务接口和数据类型为维度全量通知，即不会通知一个服务的同类型的部分数据，用户不需要对比上一次通知结果。
2. 订阅时的第一次通知，必须是一个服务的所有类型数据的全量通知。
3. 中途变更时，允许不同类型的数据分开通知，比如：providers, consumers, routers, overrides，允许只通知其中一种类型，但该类型的数据必须是全量的，不是增量的。
4. 如果一种类型的数据为空，需通知一个empty协议并带category参数的标识性URL数据。
5. 通知者(即注册中心实现)需保证通知的顺序，比如：单线程推送，队列串行化，带版本对比。

Parameters:

urls - 已注册信息列表，总不为空，含义同RegistryService.lookup(URL)的返回值。