介绍

Zuul 包含了对请求的路由和过滤两个最重要的功能：

其中路由功能服务将外部请求转发到具体的微服务实例上，是实现外部访问统一入口的基础。而过滤的功能则负责对请求的处理过程进行干预，是实现请求校验、服务聚合等功能的基础。

Zuul 和 Eureka 进行整合，将 Zuul 自身注册为 Eureka 服务治理下的应用，同时从 Eureka 中获得其它微服务的消息，之后的微服务访问都是通过 Zuul 转发。

Zuul 提供了代理、路由、过滤三大功能。

使用

路由转发

1、新建名为 "microservicecloud-zuul-gateway-9527" 的子工程，依赖如下：

<!-- pom.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">
    <parent>
        <artifactId>microservicecloud</artifactId>
        <groupId>zze.springcloud</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>microservicecloud-zuul-gateway-9527</artifactId>

    <dependencies>
        <!--Eureka 客户端依赖  ps : Zuul 也要注册到 Eureka-->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-eureka</artifactId>
        </dependency>
        <!--Zuul 依赖-->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-zuul</artifactId>
        </dependency>
        <!--监控-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>
        <!--Hystrix-->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-hystrix</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-config</artifactId>
        </dependency>
        <dependency>
            <groupId>zze.springcloud</groupId>
            <artifactId>microservicecloud-api</artifactId>
            <version>${project.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jetty</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
        </dependency>
        <!--热部署-->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>springloaded</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
        </dependency>
    </dependencies>
</project>

2、配置如下：

# application.yml
server:
  port: 9527

spring:
  application:
    name: microservicecloud-zuul-gateway-9527

eureka:
  client:
    service-url:
      defaultZone: http://www.eurekaserver1.com:7001/eureka,http://www.eurekaserver2.com:7002/eureka,http://www.eurekaserver3.com:7003/eureka
  instance:
    instance-id: microservicecloud-zuul-gateway-9527
    prefer-ip-address: true

3、新建主启动类，使用注解开启 Zuul 代理：

// zze.springcloud.Application_9527
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.zuul.EnableZuulProxy;

@SpringBootApplication
@EnableZuulProxy  // 开启 Zuul 代理
public class Application_9527 {

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

4、测试：

1、启动 7001、7002、7003 Eureka 集群
2、启动 "microservicecloud-provider-dept-8001" Provider 服务
3、启动 "microservicecloud-zuul-gateway-9527" Zuul 代理服务
4、访问 http://localhost:8001/dept/list 正常返回数据
5、访问 http://localhost:9527/microservicecloud-provider-dept/dept/list 通过 Zuul 转发获取到 microservicecloud-provider-dept 服务的数据

即 Zuul 完成了路由转发
转发规则为：Zuul服务地址/注册到Eureka的服务名称/对应服务访问路径 
Zuul服务地址：localhost:9527 
注册到Eureka的服务名称：microservicecloud-provider-dept
对应服务访问路径：/dept/list

配置路由映射

修改 "microservicecloud-zuul-gateway-9527" 子工程的配置文件，新增服务映射关系：

# 路由映射配置
zuul:
  routes:
    dept.serviceId: microservicecloud-provider-dept
    dept.path: /mydept/** # 访问路径匹配该规则的请求都会被转发到 microservicecloud-provider-dept 服务

重启 Zuul 服务，此时也可以通过“localhost:9527/mydept/dept/list”访问到 microservicecloud-provider-dept 服务，并且原来“localhost:9527/microservicecloud-provider-dept/dept/list”微服务全名这种方式也不受影响能正常访问。

如果要忽略原来通过微服务全名方式转发的方式，那么可以添加如下配置：

zuul.ignored-services: microservicecloud-provider-dept # microservicecloud-provider-dept 为忽略的服务名称，还可通过 * 代指所有的服务名称，即禁用所有服务以服务名称方式访问转发

还可以添加统一前缀，只需要添加如下属性：

zuul.prefix: /zze # 此时访问路径就变为 localhost:9527/zze/mydept/dept/list