Spring Cloud入门：API网关服务（Spring Cloud Gateway）

文章实例使用的Spring Cloud版本为Finchley.SR1，Spring Boot版本为2.0.4。

1 Spring Cloud Gateway

在微服务架构中，网关作为服务的一个统一入口，所有的外部客户端访问都需要经过它来调度和过滤，可以实现的功能包括动态路由、负载均衡、授权认证、限流等。
Spring Cloud Gateway是Spring官方基于Spring 5.0，Spring Boot 2.0和Project Reactor等技术开发的网关，旨在为微服务架构提供一种简单而有效的统一的API路由管理方式，并为他们提供横切关注点，例如：安全，监控/指标和弹性。
本篇将示例搭建一个简单的网关服务。

2 构建网关

2.1 新建Spring Boot项目，引入相关依赖

		org.springframework.boot
		spring-boot-starter-parent
		2.0.4.RELEASE
		
	

	
		UTF-8
		UTF-8
		1.8
	

	
		
			org.springframework.boot
			spring-boot-starter
		

		
			org.springframework.boot
			spring-boot-starter-test
			test
		

		
			org.springframework.boot
			spring-boot-starter-actuator
		

		
			org.springframework.cloud
			spring-cloud-starter-netflix-eureka-client
		

		
			org.springframework.cloud
			spring-cloud-starter-gateway
		

		
			org.springframework.cloud
			spring-cloud-starter-netflix-hystrix
		
	

	
		
			
				org.springframework.cloud
				spring-cloud-dependencies
				Finchley.SR1
				pom
				import
			
		
	

2.2 application.properties配置

spring.application.name=api-gateway
server.port=8888
#注册中心
eureka.client.serviceUrl.defaultZone=http://localhost:1002/eureka/,http://localhost:1003/eureka/

#实例默认通过使用域名形式注册到注册中心:false
eureka.instance.prefer-ip-address=true

#实例名
eureka.instance.instance-id=${spring.cloud.client.ip-address}:${server.port}

#是否与服务注册于发现组件进行结合，通过 serviceId 转发到具体的服务实例
#默认为false，设为true便开启通过服务中心的自动根据 serviceId 创建路由的功能
#其中微服务应用名默认大写访问
spring.cloud.gateway.discovery.locator.enabled=true

2.3 添加Filter，实现简单的授权认证

@Configuration
public class TokenFilter implements GlobalFilter, Ordered {

    @Override
    public int getOrder() {
        return -100;
    }

    @Override
    public Mono filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        String token = exchange.getRequest().getQueryParams().getFirst("token");
       //url不含token参数时返回401状态码
        if (token == null || token.isEmpty()) {
            exchange.getResponse().setStatusCode(HttpStatus.UNAUTHORIZED);
            return exchange.getResponse().setComplete();
        }
        return chain.filter(exchange);
    }
}

2.4 入口程序添加@SpringCloudApplication注解并启动

@SpringCloudApplication
public class ApiGatewayApplication {

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

}

启动应用，访问 localhost:8888/EUREKA-CLIENT/hello ，可以看到页面401状态码，而携带了token参数再次请求后，则可以看到正常返回了结果（注意服务名为大写）。