com.fr.decision.fun.GlobalRequestFilterProvider

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;
import java.util.Map;

/**
 * 全局的过滤器，该接口的实现必须重启服务器才能生效
 */
public interface GlobalRequestFilterProvider extends Mutable, Comparable<GlobalRequestFilterProvider> {

    String MARK_STRING = "GlobalRequestFilterProvider";

    int CURRENT_LEVEL = 1;

    /**
     * 过滤器的名字
     *
     * @return 过滤器名字
     */
    String filterName();


    /**
     * 匹配的地址
     *
     * @return 匹配的地址集合
     */
    String[] urlPatterns();

    /**
     * 外部的过滤器类名，需要把相应的jar包放到web服务器的classpath中
     * @return 类名
     */
    String externalFilterClassName();

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

    /**
     * 过滤器的初始化参数
     * @return 参数集合
     * @since 2019-01-02
     */
    Map<String, String> initializationParameters();

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

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

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