1、Zuul簡介

zuul 是netflix開源的一個API Gateway 服務器, 本質上是一個web servlet應用。

請參考官方文檔：
https://springcloud.cc/spring-cloud-dalston.html#_router_and_filter_zuul

Zuul的主要功能是路由轉發和過濾器。路由功能是微服務的一部分，比如／api/user轉發到到user服務，/api/shop轉發到到shop服務。zuul默認和Ribbon結合實現了負載均衡的功能。

2、新建模塊

2.1 pom文件

<?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.cntaiping.tpa</groupId>
    <artifactId>zuul</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>
    <name>zuul</name>
    <description>Demo project for Spring Boot</description>

    <parent>
        <groupId>com.cntaiping.tpa</groupId>
        <artifactId>cloud</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>

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

2.2 application.properties

eureka.client.serviceUrl.defaultZone=http://localhost:8800/eureka/
server.port=8400
spring.application.name=service-zuul
#表示只要訪問以/api-a/開頭的多層目錄都可以路由到 id為compute-service的服務上
zuul.routes.consumer-feign=/api-a/**
zuul.routes.consumer-hystrix=/api-b/**

服務消費者也可以作為服務提供者。
以/api-a/ 開頭的請求都轉發給consumer-feign服務；以/api-b/開頭的請求都轉發給consumer-hystrix服務；

2.3 Application類

package com.cntaiping.tpa.zuul;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.SpringCloudApplication;
import org.springframework.cloud.netflix.zuul.EnableZuulProxy;

/**
 * @SpringCloudApplication注解
 * 整合了@SpringBootApplication、@EnableEurekaClient、@EnableCircuitBreaker
 * 主要目的還是簡化配置
 */
@EnableZuulProxy
@SpringCloudApplication
public class ZuulApplication {

    public static void main(String[] args) {
        SpringApplication.run(ZuulApplication.class, args);
    }

}

2.4 運行效果

從執行結果可以說明zuul起到了路由的作用

3、過濾器

可以通過zuul提供的過濾器，進行一些請求過濾，比如安全驗證。
停止模塊，增加過濾器類如下。

package com.cntaiping.tpa.zuul.filter;

import com.netflix.zuul.ZuulFilter;
import com.netflix.zuul.context.RequestContext;
import com.netflix.zuul.exception.ZuulException;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Component;

import javax.servlet.http.HttpServletRequest;

@Component
public class TokenFilter extends ZuulFilter {

    private static Logger log = LoggerFactory.getLogger(TokenFilter.class);

   /**
    返回一個字符串代表過濾器的類型，
    pre：路由之前
    routing：路由之時
    post： 路由之后
    error：發送錯誤調用
   */
    @Override
    public String filterType() {
        return "pre";
    }

    /**
      過濾的順序
   */
    @Override
    public int filterOrder() {
        return 0;
    }

    /**
      這里可以寫邏輯判斷，是否要過濾，本文true,永遠過濾。
    */
    @Override
    public boolean shouldFilter() {
        return true;
    }

    /**
      過濾器的具體邏輯。
   */
    @Override
    public Object run() throws ZuulException {
        RequestContext ctx = RequestContext.getCurrentContext();
        HttpServletRequest request = ctx.getRequest();
        log.info(String.format("%s >>> %s", request.getMethod(), request.getRequestURL().toString()));
        Object accessToken = request.getParameter("token");
        if(accessToken == null) {
            log.warn("token is empty");
            ctx.setSendZuulResponse(false);
            ctx.setResponseStatusCode(401);
            try {
                ctx.getResponse().getWriter().write("token is empty");
            }catch (Exception e){}
            return null;
        }
        log.info("ok");
        return null;
    }
}

重新運行模塊

http://localhost:8400/api-a/hello?name=chengyq&token=111