修改注释

git-svn-id: http://code.alibabatech.com/svn/dubbo/trunk@1499 1a56cb94-b969-4eaa-88fa-be21384802f2

dubbo-registry/dubbo-registry-api/src/main/java/com/alibaba/dubbo/registry/NotifyListener.java

@@ -33,8 +33,9 @@ public interface NotifyListener {
      * 通知需处理契约：<br>
      * 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<URL> urls);

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时，订阅失败后不报错，在后台定时重试<br>
      * 5. 允许URI相同但参数不同的URL并存，不能覆盖。<br>
      * 
-     * @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<URL> lookup(URL url);