过滤器（Filter）用于对请求的预处理，比如权限处理，日志处理，特殊编码的解码处理。目前，在苍穹中已经有一些标准的过滤器，如线程生命周期管理，鉴权管理等。

如果标准的过滤器不能满足我们的需求时，在苍穹中我们如何自定义过滤器呢，让我们来一起看看~

1 解决方案

在苍穹中，我们可以自行编写过滤器，并通过配置让编写的过滤器生效，这样就可以实现自己的过滤器啦！

下面让我们来动手实验一下吧！

Step1.编写过滤器类

首先，编写过滤器类。

在示例中，我们的过滤器类为kd.bos.filter. MyFilter, 打印出每个请求的request path。

package kd.bos.filter;
import ……..;
public class MyFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        String requestURI = httpRequest.getRequestURI();
        System.out.println(requestURI);
        chain.doFilter(request, response);
    }
}

Step2.编写属性配置文件

然后，编写该过滤器的属性配置文件。

例如在工程中如下目录创建的配置文件：

src\main\resources\kd\bos\filter\myfilter.xml，其中src\main\resources为我们工程的source folder，kd\bos\filter为配置文件的包路径，配置内容如下：

<web-app>
    <filter>
        <filter-name>myFilter</filter-name>
        <filter-class>kd.bos.filter.MyFilter</filter-class>
       <filter-order>1</filter-order>
        <filter-mapping>
            <url-pattern>*</url-pattern>
        </filter-mapping>
    </filter>
</web-app>

下表为上述配置项的说明：

上传图片

Step3.将过滤器类和配置说明打包

接下来需要把代码进行打包并部署到测试环境中。将所在工程制作为jar包，并添加到应用的zip包中，上传到appstore。重启应用，开发环境只需成功构建工程即可。

不过在部署前，我们还得做一项检查：配置文件是否正常打包到jar包中。在示例中jar中对应目录kd\bos\filter下应该有配置文件myfilter.xml。

Step4.在MC中配置让过滤器生效

这一步告诉苍穹我们增加了一个自定义过滤器：

在MC中增加配置项，key为固定值：KFilterConfigFiles.config ，值为配置文件的全路径：kd.bos.filter.myfilter.xml，然后发布生效。

在开发环境中，可以在启动类中添加环境变量快速验证：

System.setProperty("KFilterConfigFiles.config", " kd.bos.filter.myfilter.xml ");

Step5.验证

一切准备就绪后，我们来看看最后的效果。

访问主页http://localhost:8080/ierp（默认8080端口），控制台上就打印出了所有的请求路径：

自定义过滤器是不是很简单呢，现在你可以根据需要，添加自己的过滤器了。例如需要在响应头中添加特殊标签，或者需要验证请求头中特殊的验证码等等。

2 常见问题

Q：为什么我在开发环境调试后ok，在测试环境不生效呢？

A：这种情况需要做下述检查：

首先检查部署到测试环境的包中是否有我们添加的配置xml，其包路径是否正常；

其次检查配置项KFilterConfigFiles.config是否在运行环境生效，方法为在monitor中系统属性中，查找改关键字；

最后，在运行态，web请求在web节点，检查包是否正确部署到web节点。

好了，本期内容就到这里了。如有疑问，欢迎来邮件咨询，邮箱地址为：edmund_he@kingdee.com。

#往期推荐#

# 1分钟了解苍穹自定义文件存储服务

# 还在为大数据量搜索慢而烦恼？那就试试它吧！

# 什么？竟然还有人不知道苍穹Monitor

# 为了这份线程池使用指南，我鸽了隔壁女神的约会

# 看完这份攻略，“苍穹分布式锁”拿捏得稳稳的

# 苍穹分布式ID，你知多少？

更多精彩内容，“码”上了解！↓

若无满意“过滤器”，轻轻松松自定义

若无满意“过滤器”，轻轻松松自定义

恭喜您！