Dubbo3 調(diào)用攔截拓展

擴(kuò)展說明

服務(wù)提供方和服務(wù)消費(fèi)方調(diào)用過程攔截，Dubbo 本身的大多功能均基于此擴(kuò)展點(diǎn)實(shí)現(xiàn)，每次遠(yuǎn)程方法執(zhí)行，該攔截都會被執(zhí)行，請注意對性能的影響。

約定：

• 用戶自定義 filter 默認(rèn)在內(nèi)置 filter 之后。
• 特殊值 default，表示缺省擴(kuò)展點(diǎn)插入的位置。比如：filter="xxx,default,yyy"，表示 xxx 在缺省 filter 之前，yyy 在缺省 filter 之后。
• 特殊符號 -，表示剔除。比如：filter="-foo1"，剔除添加缺省擴(kuò)展點(diǎn) foo1。比如：filter="-default"，剔除添加所有缺省擴(kuò)展點(diǎn)。
• provider 和 service 同時配置的 filter 時，累加所有 filter，而不是覆蓋。比如：<dubbo:provider filter="xxx,yyy"/> 和 <dubbo:service filter="aaa,bbb" />，則 xxx,yyy,aaa,bbb 均會生效。如果要覆蓋，需配置：<dubbo:service filter="-xxx,-yyy,aaa,bbb" />

擴(kuò)展接口

org.apache.dubbo.rpc.Filter

擴(kuò)展配置

<!-- 消費(fèi)方調(diào)用過程攔截 -->
<dubbo:reference filter="xxx,yyy" />
<!-- 消費(fèi)方調(diào)用過程缺省攔截器，將攔截所有reference -->
<dubbo:consumer filter="xxx,yyy"/>
<!-- 提供方調(diào)用過程攔截 -->
<dubbo:service filter="xxx,yyy" />
<!-- 提供方調(diào)用過程缺省攔截器，將攔截所有service -->
<dubbo:provider filter="xxx,yyy"/>

已知擴(kuò)展

• org.apache.dubbo.rpc.filter.EchoFilter
• org.apache.dubbo.rpc.filter.GenericFilter
• org.apache.dubbo.rpc.filter.GenericImplFilter
• org.apache.dubbo.rpc.filter.TokenFilter
• org.apache.dubbo.rpc.filter.AccessLogFilter
• org.apache.dubbo.rpc.filter.CountFilter
• org.apache.dubbo.rpc.filter.ActiveLimitFilter
• org.apache.dubbo.rpc.filter.ClassLoaderFilter
• org.apache.dubbo.rpc.filter.ContextFilter
• org.apache.dubbo.rpc.filter.ConsumerContextFilter
• org.apache.dubbo.rpc.filter.ExceptionFilter
• org.apache.dubbo.rpc.filter.ExecuteLimitFilter
• org.apache.dubbo.rpc.filter.DeprecatedFilter

擴(kuò)展示例

Maven 項(xiàng)目結(jié)構(gòu)：

src
 |-main
    |-java
        |-com
            |-xxx
                |-XxxFilter.java (實(shí)現(xiàn)Filter接口)
    |-resources
        |-META-INF
            |-dubbo
                |-org.apache.dubbo.rpc.Filter (純文本文件，內(nèi)容為：xxx=com.xxx.XxxFilter)

XxxFilter.java：

package com.xxx;
 
import org.apache.dubbo.rpc.Filter;
import org.apache.dubbo.rpc.Invoker;
import org.apache.dubbo.rpc.Invocation;
import org.apache.dubbo.rpc.Result;
import org.apache.dubbo.rpc.RpcException;
 
public class XxxFilter implements Filter {
    public Result invoke(Invoker<?> invoker, Invocation invocation) throws RpcException {
        // before filter ...
        Result result = invoker.invoke(invocation);
        // after filter ...
        return result;
    }
}

META-INF/dubbo/org.apache.dubbo.rpc.Filter：

xxx=com.xxx.XxxFilter