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<String, Activate> cachedActivates = new ConcurrentHashMap<String, Activate>();
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<T> 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<T> getActivateExtension(URL url, String[] values)
/**
*
* 相当于调用 getActivateExtension(url, url.getParameter(key).split(","), null); 不是有group?为什么相当于这个方法??
* </pre>
* 在所有的激活中,@Activate的group参数等于这个参数group
* @param url url
* @param key 扩展点的名字
* @param group 指定的gruop
* @return 激活的扩展集合
* @see #getActivateExtension(com.alibaba.dubbo.common.URL, String[], String)
*/
public List<T> 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<T> getActivateExtension(URL url, String[] values, String group) {
List<T> exts = new ArrayList<T>();
List<String> names = values == null ? new ArrayList<String>(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<String, Activate> 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<T> usrs = new ArrayList<T>();
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
默认过滤器
需要被@Activate标识
如果需要在服务暴露时装载,那么group="provider"
如果需要在服务引用的时候装载,那么group="consumer"
如果想被暴露和引用时同时被装载,那么group={"consumer", "provider"}
如果需要url中有某个特定的值才被加载,那么value={"token", "bb"}
那么就需要配置一个token, value数组与URL中的某一个属性相同就行了
普通自定义过滤器
需要配置在url上 比如 <dubbo:provider filter="myFilter" />
过滤器扩展类上可以有@Activate也可以没有(自定义的就不要加了)
去掉某个过滤器
在filter属性上使用-号标识需要去掉的过滤器 比如:<dubbo:provider filter="-monitor" />
Activate注解的更多相关文章
- dubbo @Activate 注解使用和实现解析
Activate注解表示一个扩展是否被激活(使用),可以放在类定义和方法上, dubbo用它在spi扩展类定义上,表示这个扩展实现激活条件和时机. 先看下定义: @Documented @Retent ...
- dubbo系列七、dubbo @Activate 注解使用和实现解析
一.用法 Activate注解表示一个扩展是否被激活(使用),可以放在类定义和方法上,dubbo用它在spi扩展类定义上,表示这个扩展实现激活条件和时机. @Activate(group = Cons ...
- Spring Boot 中如何使用 Dubbo Activate 扩展点
摘要: 原创出处 www.bysocket.com 「泥瓦匠BYSocket 」欢迎转载,保留摘要,谢谢! 『 公司的核心竞争力在于创新 – <启示录> 』 继续上一篇:< Spri ...
- Dubbo扩展点应用之一filter及@Activate自激活使用
与很多框架一样,Dubbo也存在拦截(过滤)机制,可以通过该机制在执行目标程序前后执行我们指定的代码.Dubbo中Filter只是Dubbo提供的可自定义扩展的扩展点之一.通过该扩展点地理解,可以触类 ...
- Spring Dubbo 开发笔记(一)——概述
概述: Spring Dubbo 是我自己写的一个基于spring-boot和dubbo,目的是使用Spring boot的风格来使用dubbo.(即可以了解Spring boot的启动过程又可以学习 ...
- Spring Dubbo 开发笔记
第一节:概述 Spring-Dubbo 是我自己写的一个基于spring-boot和dubbo,目的是使用Spring boot的风格来使用dubbo.(即可以了解Spring boot的启动过程又可 ...
- spring-boot整合dubbo:Spring-boot-dubbo-starter
为什么要写这个小工具 如果你用过Spring-boot来提供dubbo服务,相信使用中有很多"不爽"的地方.既然使用spring boot,那么能用注解的地方绝不用xml配置,这才 ...
- dubbo源码—SPI
Java中的SPI SPI,Service Provider Interface,java中提供的一种使程序可扩展的方式,系统定义好接口规范,供其他服务提供方实现,服务提供方将自己jar包META-I ...
- Dubbo中SPI扩展机制解析
dubbo的SPI机制类似与Java的SPI,Java的SPI会一次性的实例化所有扩展点的实现,有点显得浪费资源. dubbo的扩展机制可以方便的获取某一个想要的扩展实现,每个实现都有自己的name, ...
随机推荐
- 微信小程序开发步骤简述
1.登陆微信的开发这平台 2.找到小程序开发选项进入,填写注册自己的小程序信息 3.下载相应的开发者工具 4.通过开发者工具把自己的项目代码上传,上传时会让你填写自己小程序的appid这样项目代码就和 ...
- Linux 基于WEB开源的系统管理工具webmin
Webmin是目前功能最强大的基于Web的Unix系统管理工具.管理员通过浏览器访问Webmin的各种管理功能并完成相应的管理动作.目前Webmin支持绝大多数的Unix系统,这些系统除了各种版本的l ...
- OpenJudge计算概论-分数求和
/*====================================================== 1006:分数求和 总时间限制: 1000ms 内存限制: 65536kB 描述 输入 ...
- 001-http-总览、文件配置、常用http client、http连接池
一.概述 http请求项目搭建:地址:https://github.com/bjlhx15/common-study.git 中的common-http 主要针对post请求中的,form表单[app ...
- 013-多线程-基础-Fork/Join框架、parallelStream讲解
一.概述 Fork/Join框架是Java7提供了的一个用于并行执行任务的框架, 是一个把大任务分割成若干个小任务,最终汇总每个小任务结果后得到大任务结果的框架. 它同ThreadPoolExecut ...
- QML加载gif
AnimatedImage { anchors.fill: parent source: "qrc:/img/timg.gif" }
- 采购订单审批与撤销审批BAPI
*"---------------------------------------------------------------------- *"*"本地接口: *& ...
- PPT做交互效果
1 做交互效果(点击一个按钮,弹出某个框或者跳转到某个页面)其实就是若干个PPT页面,利用给按钮增加超链接或者动作 达到点击一个按钮 跳转到另外一个PPT的效果. 2 选择一个形状组件(或者其他组件) ...
- Jquery生成二维码(微信中长按图片识别二维码功能)
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title> ...
- fastadmin 后台view data-source关联报500错误问题
data-source 关联模型通过id关联被关联表的name字段,没有name字段就报500