SpringCloud入门（六）之Zuul

一，概述

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

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

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

注意：Zuul服务最终还是会注册进Eureka

代理+路由+过滤三大功能

二，路由基本配置

2.1 pom.xml

新建Module模块servicecloud-zuul-gateway-9527，在pom.xml中加入Zuul坐标：

<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>
  <parent>
    <groupId>com.lmc</groupId>
    <artifactId>servicecloud</artifactId>
    <version>0.0.1-SNAPSHOT</version>
  </parent>
  <artifactId>servicecloud-zuul-gateway-9527</artifactId>
  
  <dependencies>
  	<!-- 自己定义的api -->
   <dependency>
     <groupId>com.lmc</groupId>
     <artifactId>servicecloud-api</artifactId>
     <version>${project.version}</version>
   </dependency>

   <dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-web</artifactId>
   </dependency>

   <!-- 修改后立即生效，热部署 -->
   <dependency>
     <groupId>org.springframework</groupId>
     <artifactId>springloaded</artifactId>
   </dependency>
   <dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-devtools</artifactId>
   </dependency>
   
   <!-- Zuul相关 -->
   <dependency>
     <groupId>org.springframework.cloud</groupId>
     <artifactId>spring-cloud-starter-eureka</artifactId>
   </dependency>

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

   <!-- Ribbon相关 -->
   <dependency>
     <groupId>org.springframework.cloud</groupId>
     <artifactId>spring-cloud-starter-ribbon</artifactId>
   </dependency>

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

   <!-- feign相关 -->
   <dependency>
     <groupId>org.springframework.cloud</groupId>
     <artifactId>spring-cloud-starter-feign</artifactId>
   </dependency>
  </dependencies>
</project>

2.2 application.yml

新增application.yml配置文件：

server: 
  port: 9527
 
spring: 
  application:
    name: servicecloud-zuul-gateway
 
eureka: 
  client: 
    service-url: 
      defaultZone: http://eureka7001.com:7001/eureka,http://eureka7002.com:7002/eureka,http://eureka7003.com:7003/eureka  
  instance:
    instance-id: gateway-9527.com
    prefer-ip-address: true 

info:
  app.name: lmc-cloud
  company.name: www.lmc.com
  build.artifactId: $project.artifactId$
  build.version: $project.version$

2.3 启动类

创建启动类，增加@EnableZeelProxy注解：

package com.lmc.springcloud;

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

@SpringBootApplication
@EnableZuulProxy
public class Zuul_9527_StartSpringCloudApp {

	public static void main(String[] args) {
		// TODO Auto-generated method stub
		SpringApplication.run(Zuul_9527_StartSpringCloudApp.class, args);
	}

}

2.4 测试

启动：

1. 启动三个eureka集群
2. 启动一个服务提供类servicecloud-provider-dept-8001
3. 启动路由

访问：

• 不使用路由：http://localhost:8001/dept/get/2
• 使用路由：http://myzuul.com:9527/servicecloud-dept/dept/get/2

三，路由访问映射处理

3.1 代替服务名

由于在访问路径URL中会暴露服务提供者名称servicecloud-dept，为了保证安全性，我们可以使用代替名称来取代servicecloud-dept访问：

#以前访问
#http://myzuul.com:9527/servicecloud-dept/dept/get/2
 
zuul: 
   routes: 
      mydept.serviceId: servicecloud-dept  #服务ID名称
      mydept.path: /mydept/**  #取代服务ID名称
 
#现在访问
#http://myzuul.com:9527/mydept/dept/get/1

3.2 关闭服务名

但此时原路径的访问依然是成功，要关闭还需再进行配置：

zuul: 
  ignored-services: servicecloud-dept 	#忽略的服务名称
  routes: 
    mydept.serviceId: servicecloud-dept #服务ID名称
    mydept.path: /mydept/**  			#取代服务ID名称

如果要忽略所有服务名称，可使用*代替：

zuul: 
  ignored-services: "*"					#忽略所有服务名称
  routes: 
    mydept.serviceId: servicecloud-dept #服务ID名称
    mydept.path: /mydept/**  			#取代服务ID名称

3.3 使用前缀

如果要对访问使用前缀，要加入prefix配置：

zuul: 
  prefix: /lmc							#统一前缀
  ignored-services: "*"					#忽略所有服务名称
  routes: 
    mydept.serviceId: servicecloud-dept #服务ID名称
    mydept.path: /mydept/**  			#取代服务ID名称
 

所以现在访问就变成了：http://myzuul.com:9527/lmc/mydept/dept/get/1