SpringCloud之Zuul

1.为什么需要网关

  想象这么一个场景,如果我们有成千上万的微服务,客户端如果一个一个的去连接,显然这么做是不现实的,这个时候网关就出现了~如下图右边所示,所有的请求都必须要经过网关,然后由网关将请求路由到其他的微服务。


网关的重要性

  既然网关作为所有请求的入口,那么它必须具备哪些要素呢?

2.网关的要素

  2.1.稳定性,高可用

  服务网关作为请求的入口,它必须7*24小时可用,网关瘫痪,系统全挂,所以稳定性和高可用性是网关的第一也是最重要的要素

  2.2.性能、并发性

  所有的请求都经过网关,所以压力非常巨大,并发要求极高

  2.3.安全性

  防止外部的恶意访问!

  2.4.扩展性

  理论上网关适合处理所有的非业务场景处理,例如:协议转发,防刷、流量监控、日志

3.常用的网关方案

  3.1Nginx + lua

  Nginx适合高并发的处理

  3.2Kong

  这款软件是基于Nginx+Lua的,而且比Nginx的配置更简单,但是这款软件是要收费的

  3.3Tyk

  开源的轻量级网关,这是go语言开发的

  3.4Spring cloud zuul

  本篇文章的主角!虽然是主角,但是它的性能还是无法和Nginx比,但是据说zuul2.0提升了性能,我们用SpringCloud,用zuul会更加方便和简单。

4.Zuul

  Zuul的本质就是:路由+过滤器=Zuul,它的核心就是一系列的过滤器。Zuul提供了四种过滤器API他们是:
  前置(Pre)
  路由(Route)
  后置(Post)
  错误(Error)
  Zuul的架构图如下所示,我们可以看到过滤器之间没有直接通信的,他们之间有一个RequestContext上下文。


Zuul的架构图

我们接下来看一下请求的生命周期:请求首先到达的是前置过滤器,对请求路由前的前置加工,比如对参数校验我们就放在这个filter中。routing Filter就是将请求路由到Origin Server中去,当请求处理完后会由post filter做处理。图的右下角还有一个error filter,当三种过滤器发生错误出现异常后,就会到达这个error filter。左下角还有一个custom filter,这个filter其实可以放到Prefilter这里,也可以放到post filter。


请求生命周期

4.1代码与实战

4.1.1pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.imooc</groupId>
    <artifactId>api-gateway</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>api-gateway</name>
    <description>Demo project for Spring Boot</description>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.6.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
        <spring-cloud.version>Finchley.SR2</spring-cloud.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-config</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-zuul</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

4.1.2

main函数

@SpringBootApplication
@EnableZuulProxy
public class ApiGatewayApplication {
    public static void main(String[] args) {
        SpringApplication.run(ApiGatewayApplication.class, args);
    }
}

4.1.3关于路由的转发排除和自定义

zuul默认的路由就是:服务名/真正的访问路径
在yaml配置文件中的相关配置项

zuul: 
  routes:
  # /myProduct/product/list -> /product/product/list
    aaaaaa:
      path: /myProduct/**
      serviceId: product
      sensitiveHeaders:
  #简洁写法
#    product: /myProduct/**
  #排除某些路由
  ignored-patterns:
    - /**/product/listForOrder 
management:
  security:
    enabled: false  

4.1.4Cookie

当zuul进行路由转发请求的时候,cookie默认是不转发的,所以需要配置sensitiveHeaders这个配置项。为什么就说要改这个配置项就能成功呢?我们可以通过源码来分析,在zuulProperties源码中,我们可以看到private Set<String> sensitiveHeaders = new LinkedHashSet(Arrays.asList("Cookie", "Set-Cookie", "Authorization"));这么一行代码,也就是说请求头中的这些信息,zuul是会全部过滤掉的。

zuul:
  #全部服务忽略敏感头(全部服务都可以传递cookie)
  sensitive-headers: 
  routes:
#aaaa的名字可以随便写,但是path不要乱写
    aaaaaa:
      path: /myProduct/**
      serviceId: product
      sensitiveHeaders:

4.1.5动态路由

动态路由需要两个配置来配合,一个就是我上一篇文章写的config,还有一个就是我们需要一个配置项:

@Component
public class ZuulConfig {

    @ConfigurationProperties("zuul")
    @RefreshScope
    public ZuulProperties zuulProperties() {
        return new ZuulProperties();
    }
}

  过滤器典型应用场景有以下,对于前置过滤有限流、鉴权、参数校验调整。对于后置过滤器可以做统计与日志记录。

5.Zuul的综合使用

先看一个图:


系统架构图

5.1过滤器

  我们先通过Zuul的PreFilter和PostFilter实现两个功能:如果用户在访问后台微服务时没有提供token值,我们则拒绝访问。第二个功能时,当我们处理完请求快要返回应答时,在response中请求头中放入一个信息。
我们先看看Prefilter的实现:

@Component
public class TokenFilter extends ZuulFilter {
    @Override
    public String filterType() {
        return PRE_TYPE;
    }

    @Override
    public int filterOrder() {
        return PRE_DECORATION_FILTER_ORDER - 1;
    }

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

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

        //这里从url参数里获取, 也可以从cookie, header里获取
        String token = request.getParameter("token");
        if (StringUtils.isEmpty(token)) {
            requestContext.setSendZuulResponse(false);
            requestContext.setResponseStatusCode(HttpStatus.UNAUTHORIZED.value());
        }
        return null;
    }
}

  注意代码里面的PRE_DECORATION_FILTER_ORDER,这个ORDER是Zuul原生提供的,也是我们在自定义Filter时,官方比较建议使用的一个ORDER。在接下来看看RUN方法,我们看到里面使用了RequestContext来获取request对象,并从request中获取token值,如果token为null,我们就会设置ZuulResponse为false,同时设置应答码为401。
  接下来我们看看PostFilter的代码:

@Component
public class addResponseHeaderFilter extends ZuulFilter{
    @Override
    public String filterType() {
        return POST_TYPE;
    }

    @Override
    public int filterOrder() {
        return SEND_RESPONSE_FILTER_ORDER - 1;
    }

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

    @Override
    public Object run() {
        RequestContext requestContext = RequestContext.getCurrentContext();
        HttpServletResponse response = requestContext.getResponse();
        response.setHeader("X-Foo", UUID.randomUUID().toString());
        return null;
    }
}

  我们在请求头中放入了X-Foo的属性。在filterOrder方法里面我们使用了另外一个官方比较推荐的Order。

5.2限流

  限流应该在请求被转发之前调用,而且可以说应该是所用调用中最前端的逻辑。常用的限流算法就是令牌桶算法:


令牌桶算法

  就是说我们往一个桶里面按照一定的速率放令牌,如果桶满了,就把多余的令牌丢掉,当请求到达系统的时候,如果能够从桶中获得令牌,就让请求被执行,同时同种减少一个令牌,如果桶中没有令牌了,那么就拒绝请求。我们看一下在Zuul中如何实现。

@Component
public class RateLimitFilter extends ZuulFilter{

    private static final RateLimiter RATE_LIMITER = RateLimiter.create(100);

    /**
     * to classify a filter by type. Standard types in Zuul are "pre" for pre-routing filtering,
     * "route" for routing to an origin, "post" for post-routing filters, "error" for error handling.
     * We also support a "static" type for static responses see  StaticResponseFilter.
     * Any filterType made be created or added and run by calling FilterProcessor.runFilters(type)
     *
     * @return A String representing that type
     */
    @Override
    public String filterType() {
        return PRE_TYPE;
    }

    /**
     * filterOrder() must also be defined for a filter. Filters may have the same  filterOrder if precedence is not
     * important for a filter. filterOrders do not need to be sequential.
     *
     * @return the int order of a filter
     */
    @Override
    public int filterOrder() {
        return SERVLET_DETECTION_FILTER_ORDER - 1;
    }

    /**
     * a "true" return from this method means that the run() method should be invoked
     *
     * @return true if the run() method should be invoked. false will not invoke the run() method
     */
    @Override
    public boolean shouldFilter() {
        return true;
    }

    /**
     * if shouldFilter() is true, this method will be invoked. this method is the core method of a ZuulFilter
     *
     * @return Some arbitrary artifact may be returned. Current implementation ignores it.
     */
    @Override
    public Object run() {
        if (!RATE_LIMITER.tryAcquire()) {
            throw new RateLimitException();
        }

        return null;
    }
}

  这里我们直接使用了google的令牌桶算法,当然感兴趣的同学可以试试网上配合redis等数据库来完成限流的方案,这里我们就使用谷歌提供的算法。我们的filterOrder使用了最高优先级的order,因为限流必须要在最前面使用。同时我们每秒钟往桶里面放100个令牌,每次来一个请求,我们就拿走一个令牌。

5.3Zuul鉴权和添加用户服务

  我们假设这样一个场景,对于/order/create请求只能买家访问,/order/finish 只能卖家访问,/product/list 都可访问,如何让Zuul来做这样的鉴权?也就是让zuul判断登录用户究竟是买家还是卖家,我们可以看看下面的AuthFilter:

@Component
public class AuthFilter extends ZuulFilter {

    @Autowired
    private StringRedisTemplate stringRedisTemplate;

    @Override
    public String filterType() {
        return PRE_TYPE;
    }

    @Override
    public int filterOrder() {
        return PRE_DECORATION_FILTER_ORDER - 1;
    }

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

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

        /**
         * /order/create 只能买家访问(cookie里有openid)
         * /order/finish 只能卖家访问(cookie里有token, 并且对应的redis中值)
         * /product/list 都可访问
         */
        if ("/order/order/create".equals(request.getRequestURI())) {
            Cookie cookie = CookieUtil.get(request, "openid");
            if (cookie == null || StringUtils.isEmpty(cookie.getValue())) {
                requestContext.setSendZuulResponse(false);
                requestContext.setResponseStatusCode(HttpStatus.UNAUTHORIZED.value());
            }
        }

        if ("/order/order/finish".equals(request.getRequestURI())) {
            Cookie cookie = CookieUtil.get(request, "token");
            if (cookie == null
                    || StringUtils.isEmpty(cookie.getValue())
                    || StringUtils.isEmpty(stringRedisTemplate.opsForValue().get(String.format(RedisConstant.TOKEN_TEMPLATE, cookie.getValue())))) {
                requestContext.setSendZuulResponse(false);
                requestContext.setResponseStatusCode(HttpStatus.UNAUTHORIZED.value());
            }
        }

        return null;
    }
}

  在run方法逻辑中我们判断了用户的请求路径,做了相应的鉴权,但是我们可以看到这其中存在问题,如果以后我们要对买家的逻辑或者卖家的逻辑做更改,怎么办?都在这一个Filter里面修改吗?不现实,所以我们决定将这个Filter拆分。
  对于卖家的Filter:

@Component
public class AuthSellerFilter extends ZuulFilter {

    @Autowired
    private StringRedisTemplate stringRedisTemplate;

    @Override
    public String filterType() {
        return PRE_TYPE;
    }

    @Override
    public int filterOrder() {
        return PRE_DECORATION_FILTER_ORDER - 1;
    }

    @Override
    public boolean shouldFilter() {
        RequestContext requestContext = RequestContext.getCurrentContext();
        HttpServletRequest request = requestContext.getRequest();

        if ("/order/order/finish".equals(request.getRequestURI())) {
            return true;
        }

        return false;
    }

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

        /**
         * /order/finish 只能卖家访问(cookie里有token, 并且对应的redis中值)
         */

        Cookie cookie = CookieUtil.get(request, "token");
        if (cookie == null
                || StringUtils.isEmpty(cookie.getValue())
                || StringUtils.isEmpty(stringRedisTemplate.opsForValue().get(String.format(RedisConstant.TOKEN_TEMPLATE, cookie.getValue())))) {
            requestContext.setSendZuulResponse(false);
            requestContext.setResponseStatusCode(HttpStatus.UNAUTHORIZED.value());
        }

        return null;
    }
}

  我们使用了shouldFilter对路径先做判断,如果返回true再执行run方法。再来看看买家的Filter逻辑:

@Component
public class AuthBuyerFilter extends ZuulFilter {

    @Autowired
    private StringRedisTemplate stringRedisTemplate;

    @Override
    public String filterType() {
        return PRE_TYPE;
    }

    @Override
    public int filterOrder() {
        return PRE_DECORATION_FILTER_ORDER - 1;
    }

    @Override
    public boolean shouldFilter() {
        RequestContext requestContext = RequestContext.getCurrentContext();
        HttpServletRequest request = requestContext.getRequest();

        if ("/order/order/create".equals(request.getRequestURI())) {
            return true;
        }

        return false;
    }

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

        /**
         * /order/create 只能买家访问(cookie里有openid)
         */
        Cookie cookie = CookieUtil.get(request, "openid");
        if (cookie == null || StringUtils.isEmpty(cookie.getValue())) {
            requestContext.setSendZuulResponse(false);
            requestContext.setResponseStatusCode(HttpStatus.UNAUTHORIZED.value());
        }

        return null;
    }
}

  这样我们就将鉴权的Filter拆分的更细更加合理

5.4跨域

  当我们做前后端分离的时候,我们知道,发起ajax请求如果不是同源的话会引起跨域问题。那么我们的Zuul在解决跨域问题的时候,其实也就是在解决Spring的跨域问题,有的同学认为我们可以在被调用的类或者方法上增加@CrossOrigin注解来解决,但是我们的类和方法成千上万,这样做会大大增加成本。这里我们使用另外一个方法,也就是在Zuul里面增加CorsFilter过滤器。一个简单的配置类就可以搞定

@Configuration
public class CorsConfig {

    @Bean
    public CorsFilter corsFilter() {
        final UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        final CorsConfiguration config = new CorsConfiguration();

        config.setAllowCredentials(true);//允许coockie跨域
        config.setAllowedOrigins(Arrays.asList("*")); //http:www.a.com
        config.setAllowedHeaders(Arrays.asList("*"));//允许的请求头
        config.setAllowedMethods(Arrays.asList("*"));//允许的请求方法
        config.setMaxAge(300l);//多长时间内不用再检查是否跨域

        source.registerCorsConfiguration("/**", config);
        return new CorsFilter(source);
    }
}

  关于Zuul的知识我们就讲解到这里,但是这里我还是要写一段相对比较悲观的话,Zuul和Eureka一样也是不会再被维护的范畴了,后续的文章中我们将会讲解Spring-cloud-Gateway,它是目前为止Zuul的完美替代

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,033评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,725评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,473评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,846评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,848评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,691评论 1 282
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,053评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,700评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,856评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,676评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,787评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,430评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,034评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,990评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,218评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,174评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,526评论 2 343

推荐阅读更多精彩内容

  • 注意:本文的前提是基于zuul的1.3.X版本来解析的,2.0版本采用了netty作为底层框架重新设计了整个zuu...
    wangxiaowu241阅读 13,614评论 0 5
  • 1. Zuul 介绍 Zuul 是 Spring Cloud 微服务体系中担任很重要的角色--服务网关,是基于JV...
    alexqdjay阅读 1,369评论 0 3
  • 考虑一个问题,外部的应用如何来访问内部各种各样的微服务呢?在微服务架构中,后端服务往往不直接开放给调用端,而是通过...
    weisen阅读 2,093评论 1 9
  • 学习是一个深入的过程,不停的反复的研究,不能浮于表面,要深入原理。 之前我们了解到springcloud zuul...
    二月_春风阅读 48,260评论 6 22
  • 因为各种原因,很久没有更新日志。最近较忙,很难抽出时间。坚持阅读没有放弃。阅读可能短时间不会显现出很好的效果,但是...
    卓海阅读 100评论 0 0