转载

使用SpringCloudZuul实现过滤器或拦截器功能案例

Spring Cloud的API网关不但可以实现类似NGINX+Lua强大的路由分发，实现动静页面的分流，更重要可以实现对所有发往后端微服务请求的拦截。Zuul主要有四种类型的过滤器，我们可以为特定的url模式添加任意数量的过滤器。

“pre” 预过滤器 - 在路由分发一个请求之前调用。
“post” 后过滤器 - 在路由分发一个请求后调用。
“route” 路由过滤器 - 用于路由请求分发。
“error” 错误过滤器 - 在处理请求时发生错误时调用

上图显示这几种过滤器的前后调用顺序，第一个是pre过滤器然后是Route过滤器，最后响应是post过滤器。

下面我们开始演示这几种过滤器的开发，Springcloud的开发三板斧就是pom.xml、application配置和元注解三种，首先pom.xml如下：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-zuul</artifactId>
</dependency>

下面是自己实现这四种过滤器，只要实现com.netflix.zuul.ZuulFilter接口，然后实现方法filterType，返回字符串为这四种类型pre post route error。

@Override
public String filterType() {
    return "pre;//关键在这里，四种类型定义
}

比如实现pre类型预处理器代码：

public class PreFilter extends ZuulFilter {

    @Override
    public String filterType() {
        return "pre";
    }

    @Override
    public int filterOrder() {
        return 0;
    }

    @Override
    public boolean shouldFilter() {
        return true;
    }

    @Override
    public Object run() {
        RequestContext ctx = RequestContext.getCurrentContext();
        HttpServletRequest request = ctx.getRequest();

        System.out.println(
                "Pre Filter: Request Method : " + request.getMethod() + " " +
                        "Request URL : " + request.getRequestURL().toString());

        return null;
    }

}

这里虽然类名PreFilter，其实是可以任意取名的，在run方法中我们定义了该过滤器应该做的事情。

其他几种也是类似这样建立，这里省去，可见文后的源码。

下面我们来运行调试验证，首先还是启动Producer服务，当然也可以启动注册服务器，这取决于你只使用URL路径分发还是服务ID分发。这部分设置见上篇

运行我们的Zuul应用，然后访问http://localhost:8080/producer/articles

控制台输出如下：

Pre Filter: Request Method : GET Request URL : http://localhost:8080/producer/articles

Route: Using Route Filter

Post：Using Post Filter

过滤器作用比较大，一般用来作为安全拦截，当然最好不要侵入业务，否则这里变成一个业务服务网关，当然你也可以美其名曰“中台”，其实像ESB消息总线等复杂业务侵入式的中台都是多余的。微服务倡导智能终端哑管道理念，哑管道就是管道必须简单，是个哑巴，不要太智能。

由于Zuul充当我们所有微服务的代理，我们可以使用Zuul服务来实现一些跨领域的问题，如安全性，速率限制等。一个常见的用例是将Authentication头转发给所有下游服务。

通常在微服务中，我们将使用OAuth服务进行身份验证和授权。一旦客户端通过身份验证，OAuth服务将生成一个令牌，该令牌应包含在发送给其他微服务的请求中，以便客户端无需单独为每个服务进行身份验证。我们可以使用Zuul过滤器来实现这样的功能。当然实际中会使用JWT令牌格式。

本文源码用Idea打开：百度网盘