前言:
刚刚写了篇博文: Dubbo透传traceId/logid的一种思路, 对dubbo的filter机制有了一个直观的理解. 同时对filter也多了一些好奇心, 好奇filter链是如何组织的, 它的顺序是否支持调整. 带着这些疑问, 同时也是趁热打铁, 让我们一起来简单梳理下.
写下疑惑:
其实网上有一篇文章: Dubbo Filter详解, 写的非常好, 基本上把Dubbo的Filter链的组织, 顺序性, 自定义顺序的方式, 说的很清楚了. 这边请允许我再做一次知识的搬运工, ^_^.
同时让我引入几个疑问, 带着疑问去解读代码, 可能效果更好.
1. 注解@Activate是否是Dubbo Filter必须的, 其上的group和order分别扮演什么样的角色?
让我们贴一下ConsumerContextFilter的类定义
@Activate(
group = {"consumer"},
order = -10000
)
public class ConsumerContextFilter implements Filter { }
2. Filter的顺序是否可以调整, 如何实现?
这里面又可以分好几个小问题, 比如默认的filter是按什么标准排序的, 如何调整自定义filter和自带filter的顺序, 甚至去掉自带filter.
在Dubbo透传TraceId的实践中, 就发现自定义的filter是在系统自带filter后执行的, 但是我想调整顺序, 却发现无从入手, T_T.
源码解读:
Dubbo的Filter链构造的入口是在ProtocolFilterWrapper类里.
public class ProtocolFilterWrapper implements Protocol {
private static <T> Invoker<T> buildInvokerChain(final Invoker<T> invoker, String key, String group) {
final Invoker last = invoker;
// *) 获得所有激活的Filter（已经排好序的）
List filters = ExtensionLoader.getExtensionLoader(Filter.class)
.getActivateExtension(invoker.getUrl(), key, group);
if(filters.size() > 0) {
// *) 以非常规的方式--闭包, 构建了filter链
for(int i = filters.size() - 1; i >= 0; --i) {
final Filter filter = (Filter)filters.get(i);
last = new Invoker() {
public Class<T> getInterface() {
return invoker.getInterface();
}
public URL getUrl() {
return invoker.getUrl();
}
public boolean isAvailable() {
return invoker.isAvailable();
}
public Result invoke(Invocation invocation) throws RpcException {
return filter.invoke(last, invocation);
}
public void destroy() {
invoker.destroy();
}
public String toString() {
return invoker.toString();
}
};
}
}
return last;
}
}
而在具体的获取激活的filter列表的代码时
public List<T> getActivateExtension(URL url, String[] values, String group) {
ArrayList exts = new ArrayList();
// 所有用户自己配置的filter信息（有些Filter是默认激活的，有些是配置激活的，这里这里的names就指的配置激活的filter信息）
Object names = values == null?new ArrayList(0):Arrays.asList(values);
String name;
// 配置指定的项包含'-default'时, 则不加载默认的filter链组, 反之则加载
if(!((List)names).contains("-default")) {
this.getExtensionClasses();
Iterator usrs = this.cachedActivates.entrySet().iterator();
while(usrs.hasNext()) {
Entry i = (Entry)usrs.next();
name = (String)i.getKey();
Activate ext = (Activate)i.getValue();
// group的取值范围限于provider/consumer, 标明作用的场景
if(this.isMatchGroup(group, ext.group())) {
Object ext1 = this.getExtension(name);
// 这里以Filter为例：三个判断条件的含义依次是：
// 1.用户配置的filter列表中不包含当前ext
// 2.用户配置的filter列表中不包含当前ext的加-的key
// 3.如果用户的配置信息（url中体现）中有可以激活的配置key并且数据不为0,false,null，N/A，也就是说有正常的使用
if(!((List)names).contains(name) && !((List)names).contains("-" + name) && this.isActive(ext, url)) {
exts.add(ext1);
}
}
}
// 根据Activate注解上的order排序, 有点类似css的zindex属性, 数值越小排在前面
Collections.sort(exts, ActivateComparator.COMPARATOR);
}
// 进行到此步骤的时候Dubbo提供的原生的Filter已经被添加完毕了，下面处理用户自己扩展的Filter
ArrayList var11 = new ArrayList();
for(int var12 = 0; var12 < ((List)names).size(); ++var12) {
name = (String)((List)names).get(var12);
// 该项不是 剔除项(以'-'开头)时, 进入添加环节
if(!name.startsWith("-") && !((List)names).contains("-" + name)) {
// 可以通过default关键字替换Dubbo原生的Filter链，主要用来控制调用链顺序
if("default".equals(name)) {
if(var11.size() > 0) {
// 加入用户自己定义的扩展Filter
exts.addAll(0, var11);
var11.clear();
}
} else {
Object var13 = this.getExtension(name);
var11.add(var13);
}
}
}
if(var11.size() > 0) {
exts.addAll(var11);
}
return exts;
}
通过简单的配置'-'可以手动剔除Dubbo原生的Filter，通过default代表Dubbo原生的Filter子链, 通过配置指定从而实现filter链的顺序控制. 这大概这段代码可以解读出的核心思想.
默认filter链, 先执行原生filter, 再依次执行自定义filter, 继而回溯到原点.
Dubbo原生的filter定义在META-INF/dubbo/internal/com.alibaba.dubbo.rpc.filter文件中, 具体如下:
echo=com.alibaba.dubbo.rpc.filter.EchoFilter
generic=com.alibaba.dubbo.rpc.filter.GenericFilter
genericimpl=com.alibaba.dubbo.rpc.filter.GenericImplFilter
token=com.alibaba.dubbo.rpc.filter.TokenFilter
accesslog=com.alibaba.dubbo.rpc.filter.AccessLogFilter
activelimit=com.alibaba.dubbo.rpc.filter.ActiveLimitFilter
classloader=com.alibaba.dubbo.rpc.filter.ClassLoaderFilter
context=com.alibaba.dubbo.rpc.filter.ContextFilter
consumercontext=com.alibaba.dubbo.rpc.filter.ConsumerContextFilter
exception=com.alibaba.dubbo.rpc.filter.ExceptionFilter
executelimit=com.alibaba.dubbo.rpc.filter.ExecuteLimitFilter
deprecated=com.alibaba.dubbo.rpc.filter.DeprecatedFilter
compatible=com.alibaba.dubbo.rpc.filter.CompatibleFilter
timeout=com.alibaba.dubbo.rpc.filter.TimeoutFilter
monitor=com.alibaba.dubbo.monitor.support.MonitorFilter
validation=com.alibaba.dubbo.validation.filter.ValidationFilter
cache=com.alibaba.dubbo.cache.filter.CacheFilter
trace=com.alibaba.dubbo.rpc.protocol.dubbo.filter.TraceFilter
future=com.alibaba.dubbo.rpc.protocol.dubbo.filter.FutureFilter
解答疑惑:
通过源码的解读, 我们来尝试回答一下开头设定的两个问题.
1. 注解@Activate是否是Dubbo Filter必须的, 其上的group和order分别扮演什么样的角色?
对于Dubbo原生自带的filter, 注解@Activate是必须, 其group用于provider/consumer的站队, 而order值是filter顺序的依据. 但是对于自定义filter而言, 注解@Activate没被用到, 其分组和顺序, 完全由用户手工配置指定. 如果自定义filter添加了@Activate注解, 并指定了group了, 则这些自定义filter将升级为原生filter组.
2. Filter的顺序是否可以调整, 如何实现?
可以调整, 通过'-'符号可以去除某些filter, 而default代表默认激活的原生filter子链, 通过重排default和自定义filter的顺序, 达到实现顺序控制的目的.
案例实战:
让我们来构建几个case, 来看看如何配置能满足.
假定自定义filter的对象为filter1, filter2
case 1: 其执行顺序为, 原生filter子链->filter1->filter2
<dubbo:reference filter="filter1,filter2"/>
case 2: 其执行顺序为, filter1->filter2->原生filter子链
<dubbo:reference filter="filter1,filter2,default"/>
case 3: 其执行顺序为, filter1->原生filter子链->filter2, 同时去掉原生的TokenFilter(token)
<dubbo:service filter="filter1,default,filter2,-token"/>
总结:
回过头来看, Dubbo越来越像一个精品, 其设计的filter机制(分组/顺序控制), 非常的巧妙, 值得拜读和学习.