From e7c396d15918177aeb80fa7ce94d607b5ca0c490 Mon Sep 17 00:00:00 2001 From: "william.liangf" Date: Sun, 1 Apr 2012 10:27:34 +0000 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=B3=A8=E9=87=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit git-svn-id: http://code.alibabatech.com/svn/dubbo/trunk@1499 1a56cb94-b969-4eaa-88fa-be21384802f2 --- .../java/com/alibaba/dubbo/registry/NotifyListener.java | 3 ++- .../java/com/alibaba/dubbo/registry/RegistryService.java | 8 ++++---- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/dubbo-registry/dubbo-registry-api/src/main/java/com/alibaba/dubbo/registry/NotifyListener.java b/dubbo-registry/dubbo-registry-api/src/main/java/com/alibaba/dubbo/registry/NotifyListener.java index 977eb57df..d386412c3 100644 --- a/dubbo-registry/dubbo-registry-api/src/main/java/com/alibaba/dubbo/registry/NotifyListener.java +++ b/dubbo-registry/dubbo-registry-api/src/main/java/com/alibaba/dubbo/registry/NotifyListener.java @@ -33,8 +33,9 @@ public interface NotifyListener { * 通知需处理契约：
* 1. 总是以服务接口为维度全量通知，即不会通知一个服务的部分数据，用户不需要对比上一次通知结果 * 2. 允许不同类型的数据分开通知，比如：providers, consumers, routes, overrides，允许只通知其中一种类型，但该类型的数据必须是全量的，不是增量的。 - * 3. 如果一种类型的数据为空，需通知一个noprovider, noconsumer, noroute, nooverride协议的标识性URL数据。 + * 3. 如果一种类型的数据为空，需通知一个empty协议并带category参数的标识性URL数据。 * 4. 通知者(即注册中心实现)需保证通知的顺序，比如：单线程推送，队列串行化，带版本对比。 + * * @param urls 含义同{@link com.alibaba.dubbo.registry.RegistryService#register(URL)}的url参数。 */ void notify(List urls); diff --git a/dubbo-registry/dubbo-registry-api/src/main/java/com/alibaba/dubbo/registry/RegistryService.java b/dubbo-registry/dubbo-registry-api/src/main/java/com/alibaba/dubbo/registry/RegistryService.java index 3d95f5c4c..ccfa2d234 100644 --- a/dubbo-registry/dubbo-registry-api/src/main/java/com/alibaba/dubbo/registry/RegistryService.java +++ b/dubbo-registry/dubbo-registry-api/src/main/java/com/alibaba/dubbo/registry/RegistryService.java @@ -67,7 +67,7 @@ public interface RegistryService { * 4. 当URL设置了check=false时，订阅失败后不报错，在后台定时重试
* 5. 允许URI相同但参数不同的URL并存，不能覆盖。
* - * @param url 服务查询键值对，如：subscribe://10.20.153.10/com.alibaba.foo.BarService?version=1.0.0&application=kylin + * @param url 服务查询键值对，如：consumer://10.20.153.10/com.alibaba.foo.BarService?version=1.0.0&application=kylin * @param listener 服务变更事件监听器 */ void subscribe(URL url, NotifyListener listener); @@ -75,7 +75,7 @@ public interface RegistryService { /** * 取消订阅服务. * - * @param url 服务查询键值对，如：subscribe://10.20.153.10/com.alibaba.foo.BarService?version=1.0.0&application=kylin + * @param url 服务查询键值对，如：consumer://10.20.153.10/com.alibaba.foo.BarService?version=1.0.0&application=kylin * @param listener 服务变更事件监听器 */ void unsubscribe(URL url, NotifyListener listener); @@ -83,8 +83,8 @@ public interface RegistryService { /** * 查询服务列表，与订阅服务相同，拉模式，只返回一次结果。 * - * @param url 服务查询键值对，如：subscribe://10.20.153.10/com.alibaba.foo.BarService?version=1.0.0&application=kylin - * @return 服务列表 + * @param url 服务查询键值对，如：consumer://10.20.153.10/com.alibaba.foo.BarService?version=1.0.0&application=kylin + * @return 服务列表，含义同{@link com.alibaba.dubbo.registry.RegistryService#register(URL)}的url参数。 */ List lookup(URL url); -- GitLab