com.fr.decision.fun.EmbedRequestFilterProvider

一、特殊名词介绍

无

二、背景、场景介绍

该接口是继RequestPreHandleProvider接口之后，对请求预处理场景需要的一个补充和完善的接口。提供了与过滤器（javax.servlet.Filter）几乎同等的效果，可以直接在插件代码中使用，不必要配置web.xml。

该接口可以热加载。

三、接口介绍

EmbedRequestFilterProvider.java

package com.fr.decision.fun;

import com.fr.stable.fun.mark.Mutable;

import javax.servlet.FilterChain;
import javax.servlet.FilterConfig;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

/**
 * 内置的Servlet的过滤器
 */
public interface EmbedRequestFilterProvider extends Mutable {

    String MARK_STRING = "EmbedRequestFilterProvider";

    int CURRENT_LEVEL = 2;

    /**
     * 初始化过滤器
     * 注：该接口生效必须重启服务器
     * @param filterConfig 过滤器配置
     */
    void init(FilterConfig filterConfig);

    /**
     * 过滤servlet
     * @param req http请求
     * @param res http响应
     */
    void filter(HttpServletRequest req, HttpServletResponse res) throws IOException, ServletException;


    /**
     * 销毁过滤器
     */
    void destroy();
}

四、支持版本

产品线	版本	支持情况
FR	10.0	支持
BI	5.1	支持
BI	5.1.2	支持
BI	5.1.3	支持

五、插件注册

plugin.xml

<extra-decision>
    <EmbedRequestFilterProvider class="your class name"/>
</extra-decision>

六、原理说明

平台服务初始化模块（DecisionServletInitializer）在启动时，会向ServletContext中注入一个filter，同时监听插件的启动和停止，动态缓存所有插件中的EmbedRequestFilterProvider接口实例，在filter执行时依次执行插件中的EmbedRequestFilterProvider接口实例。