Spring Cloud系列（五）：服务网关Zuul
在前面的篇章都是一个服务消费者去调用一个服务提供者，但事实上我们的系统基本不会那么简单，如果真的是那么简单的业务架构我们也没必要用Spring Cloud，直接部署一个Spring Boot应用就够了。所以当我们的服务消费者有很多个，比如说在一个电商系统里，会员中心是一个微服务，商品详情又是一个微服务，订单又是一个微服务，支付又是一个等等，在这么多的微服务中，每个系统都需要自己的url，这种情况我们需要一个组件来集中管理和分发这些请求，把不同url转发给不同的微服务去处理。Zuul就可以很好地完成这件事，但是Zuul可以做的远不止是路由功能。先看一下官方对Zuul的简介：
Routing is an integral part of a microservice architecture. For example,
/may be mapped to your web application,/api/usersis mapped to the user service and/api/shopis mapped to the shop service. Zuul is a JVM-based router and server-side load balancer from Netflix.Netflix uses Zuul for the following:
- Authentication
- Insights
- Stress Testing
- Canary Testing
- Dynamic Routing
- Service Migration
- Load Shedding
- Security
- Static Response handling
- Active/Active traffic management
Zuul’s rule engine lets rules and filters be written in essentially any JVM language, with built-in support for Java and Groovy.
内容来源：https://cloud.spring.io/spring-cloud-netflix/reference/html/#router-and-filter-zuul
Zuul提供的功能有很多，这里限于篇幅先介绍路由和过滤功能。
一、路由
1.1、创建新的module
新建一个新的module，名称为zuul，选择Eureka Discovery Client和Zuul两个依赖，如下：
<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>
1.2、修改配置文件
在application.properties中添加以下配置
server.port=8033
spring.application.name=server-zuul
eureka.client.serviceUrl.defaultZone=http://localhost:8761/eureka/
zuul.routes.api-ribbon.service-id=consumer-ribbon
zuul.routes.api-ribbon.path=/api-ribbon/*
zuul.routes.api-feign.service-id=consumer-feign
zuul.routes.api-feign.path=/api-feign/*
另外在启动类加上@EnableEurekaClient和@EnableZuulProxy注解
解释一下上面的zuul的配置，zuul配置路由时zuul.routes.XXX.service-id指定的是XXX服务的服务名，这里指定的是消费者的应用名，比如我们的两个服务消费者的应用名分别是consumer-ribbon和consumer-feign，而zuul.routes.XXX.path指定是映射路径，配置之后的请求地址就可以直接是zuul的地址+端口+url。举个例子，比如zuul的主机是localhost，端口是8033，那么当我们所有url为localhost:8033/api-ribbon/的请求就会被映射到consumer-ribbon服务，所有url为localhost:8033/api-feign/的请求就会被映射到consumer-feign。
1.3、启动&测试
依次启动注册中心、服务提供者、ribbon消费者、feign消费者和zuul，访问http://localhost:8033/api-ribbon/index?uid=ribbon，可以看到返回了
服务8770的消息：用户ribbon调用了此服务
访问http://localhost:8033/api-feign/index?uid=ribbon也能看到同样的信息，这说明我们的路由功能已经生效了。
二、过滤
我们可以对某些请求进行一些过滤的工作，比如对分发给ribbon这个服务的请求都进行参数校验，要求所有这个服务的请求都要带上token。
在zuul的module新建一个CustomFilter继承ZuulFilter
@Component
public class CustomFilter extends ZuulFilter {
private Logger logger = LoggerFactory.getLogger(getClass());
@Override
public String filterType() {
return "pre";
}
@Override
public int filterOrder() {
return 0;
}
@Override
public boolean shouldFilter() {
return true;
}
@Override
public Object run() throws ZuulException {
RequestContext ctx = RequestContext.getCurrentContext();
HttpServletRequest request = ctx.getRequest();
logger.info("request uri:" + request.getRequestURI());
String uri = request.getRequestURI();
String token = request.getParameter("token");
if (uri.startsWith("/api-ribbon") && StringUtils.isEmpty(token)) {
ctx.setSendZuulResponse(false);
ctx.setResponseStatusCode(401);
ctx.setResponseBody("Token must not be empty.");
}
return null;
}
}
需要重写的这四个方法：
-
filterType：返回过滤的类型，允许的有四个值：
- pre：路由前
- routing：路由时
- post：路由后
- error：发送错误调用
-
filterOrder：过滤顺序。这个方法返回一个整型数值，其实表示的是过滤的优先级，当有多个过滤器存在时，数字越大，优先级越高。
-
shouldFilter：返回一个布尔类型的值，它和run方法一起使用，返回true时会执行run方法，否则不执行。可以把这个方法理解问某种过滤规则的开关。
-
run：该方法是核心方法，过滤的具体规则在这个方法实现。虽然该方法要求返回一个对象，但是现在的实现往往会忽略，直接返回null就可以了。
上面的代码就是先获取路由前的请求uri和请求参数token的值，如果请求的是ribbon服务，就需要token参数，否则不需要。
依次启动注册中心、服务提供者、ribbon消费者、feign消费者和zuul，然后当访问http://localhost:8033/api-ribbon/index?uid=ribbon时会返回
Token must not be empty.
再访问http://localhost:8033/api-feign/index?uid=ribbon即会返回
服务8770的消息：用户ribbon调用了此服务
这说明我们的过滤器已经生效了
三、总结
以上就是Zuul的简单介绍，更多功能可以自行探索。下一篇介绍配置中心。
源码已经上传到github：https://github.com/spareyaya/spring-cloud-demo/tree/master/chapter5
