Activate注解

Activate注解

被该注解修饰的接口，扩展类可能会被加载

ProtocolFilterWrapper.buildInvokerChain

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE, ElementType.METHOD})
public @interface Activate {
    /**
     * 激活当前扩展类的条件之一， 该group参数将会与ExtensionLoader#getActivateExtension方法传入的gruop参数进行匹配
     * @return 要匹配的组名
     * @see ExtensionLoader#getActivateExtension(URL, String, String)
     */
    String[] group() default {};

    /**
       当URL中出现该value值时激活扩展类
       例如：@Activate("cache, validation")注释在一个接口上，当URL中有cache或者validation参数时激活
     * @return URL对应的参数的keys
     * @see ExtensionLoader#getActivateExtension(URL, String)
     * @see ExtensionLoader#getActivateExtension(URL, String, String)
     */
    String[] value() default {};

    /**
     * 排序信息，可选
     * @return 在当前扩展类执行之前的扩展类
     */
    String[] before() default {};

    /**
     * 排序信息，可选
     * @return 在当前扩展类执行之后的扩展类
     */
    String[] after() default {};

    /**
     * 当前类执行的权重，越小越先执行
     */
    int order() default 0;
}

它有两个设置的过滤条件，group，value 都是数组类型。用来指定这个扩展类在什么条件下激活。

下面以com.alibaba.dubbo.rpc.filter接口的几个扩展来说明

//如MonitorFilter  这个类是在下下面第四个方法的第一部分解析的
@Activate(group = {Constants.PROVIDER, Constants.CONSUMER})
public class MonitorFilter implements Filter {
}
表示如果过滤器使用方（通过group指定）传递了group = Constants.PROVIDER 或者Constants.CONSUMER则该Filter激活

//再看这个扩展  这个类是在下下面第四个方法的第一部分解析的
@Activate(group = Constants.PROVIDER, value = Constants.TOKEN_KEY)
public class TokenFilter implements Filter {
}
如果过滤器使用方（通过group指定）指定group=Constants.PROVIDER并且URL中有参数Constants.TOKEN_KEY，那么激活这个Filter

​ dubbo中在加载配置文件时会将@Activate修饰的类(实现类)添加到cachedActivates中，在这儿ExtensionLoader#loadClass

/** key: 扩展名, value: 具体扩展对象 */
private final Map cachedActivates = new ConcurrentHashMap();

Activate activate = clazz.getAnnotation(Activate.class);
if (activate != null) {
  // param1: 扩展名 param2: 具体的实现类
    cachedActivates.put(names[0], activate);
}

然后ExtensionLoader提供了4个方法来具体使用cachedActivates，返回要激活使用的扩展类。

 /**
 * 相当于调用 getActivateExtension(url, key, null);
 * 从URL中获取扩展点的名字，然后在所有的激活中（@Activate修饰的类），获取扩展对象
 * @param url url
 * @param key  用于从URL中获取扩展点的名字（即：扩展点名字的key）
 * @return 激活的扩展集合
 * @see #getActivateExtension(com.alibaba.dubbo.common.URL, String, String)
 */
public List getActivateExtension(URL url, String key)

  /**
 *   相当于调用  getActivateExtension(url, values, null);
 * 在所有的激活中 values指定的扩展
 * @param url    url
 * @param values 扩展点名字数组
 * @return extension list which are activated
 * @see #getActivateExtension(com.alibaba.dubbo.common.URL, String[], String)
 */
public List getActivateExtension(URL url, String[] values)
  
  /**
 * 
 * 相当于调用 getActivateExtension(url, url.getParameter(key).split(","), null); 不是有group？为什么相当于这个方法？？
 * 

* 在所有的激活中，@Activate的group参数等于这个参数group * @param url url * @param key 扩展点的名字 * @param group 指定的gruop * @return 激活的扩展集合 * @see #getActivateExtension(com.alibaba.dubbo.common.URL, String[], String) */ public List getActivateExtension(URL url, String key, String group) /** * 获取激活扩展 * @param url url * @param values 扩展点的名字数组 * @param group group * @return 满足条件的扩展集合 * @see com.alibaba.dubbo.common.extension.Activate */ public List getActivateExtension(URL url, String[] values, String group) { List exts = new ArrayList(); List names = values == null ? new ArrayList(0) : Arrays.asList(values); // URL中没有server.filter=-default(这代表去掉所有默认过滤器) if (!names.contains(Constants.REMOVE_VALUE_PREFIX + Constants.DEFAULT_KEY)) { getExtensionClasses(); //cachedActivates里放的map结构 接口实现扩展名:其上的Activate对象 //遍历所有Activate注解对象 for (Map.Entry entry : cachedActivates.entrySet()) { //spi 扩展类在配置文件中的key String name = entry.getKey(); Activate activate = entry.getValue(); //如果有group匹配 if (isMatchGroup(group, activate.group())) { //获取扩展类 T ext = getExtension(name); //1、name不在 values 指定之列 //2、并且没排除name， //3、如果扩展类的Activate有value值，并且activate的value 在url有对应参数 if (!names.contains(name) && !names.contains(Constants.REMOVE_VALUE_PREFIX + name) && isActive(activate, url)) { exts.add(ext); } } } //排序Activate 具体实现在ActivateComparator里，实现了Comparator 接口compare方法 Collections.sort(exts, ActivateComparator.COMPARATOR); } //下面这部分是直接获取values扩展名中对应的扩展类 List usrs = new ArrayList(); for (int i = 0; i < names.size(); i++) { String name = names.get(i); // 过滤掉'-'开头的扩展类 if (!name.startsWith(Constants.REMOVE_VALUE_PREFIX) && !names.contains(Constants.REMOVE_VALUE_PREFIX + name)) { //如果name为default，则将默认的过滤器添加到集合的开始 if (Constants.DEFAULT_KEY.equals(name)) { if (usrs.size() > 0) { exts.addAll(0, usrs); usrs.clear(); } } else { //通过扩展名，加载扩展添加到结果集 T ext = getExtension(name); usrs.add(ext); } } } if (usrs.size() > 0) { exts.addAll(usrs); } //返回符合条件的激活扩展 return exts; }

关于最后一个获取扩展的方法，可以这样理解：

names(=values) 是URL中指定的激活(去掉激活)的值, service.filter=-default 就去掉了所有默认的filter（包括自定义让dubbo扫描的）

registry://192.168.1.7:9090/com.alibaba.service1?server.filter=-defalut,value1 去掉默认的，添加value1
registry://192.168.1.7:9090/com.alibaba.service1?server.filter=value1,-value2 去掉value2，添加value1

关于激活的过滤器我们总结一下：

都需要在扩展类的配置文件中标识 过滤器名=xxx.xxx.xxx.xxxFilter

1. 默认过滤器

   需要被@Activate标识

   如果需要在服务暴露时装载，那么group="provider"

   如果需要在服务引用的时候装载，那么group="consumer"

   如果想被暴露和引用时同时被装载，那么group={"consumer", "provider"}

   如果需要url中有某个特定的值才被加载，那么value={"token", "bb"}

   ​ 那么就需要配置一个token, value数组与URL中的某一个属性相同就行了

2. 普通自定义过滤器

   需要配置在url上 比如

   过滤器扩展类上可以有@Activate也可以没有（自定义的就不要加了）

3. 去掉某个过滤器

   在filter属性上使用-号标识需要去掉的过滤器 比如:

   ​

转载于:https://www.cnblogs.com/qiaozhuangshi/p/11007032.html