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项目，引入相关依赖

<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>2.0.4.RELEASE</version>
		<relativePath/>
	</parent>

	<properties>
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
		<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
		<java.version>1.8</java.version>
	</properties>

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

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

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

		<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-gateway</artifactId>
		</dependency>

		<dependency>
			<groupId>org.springframework.cloud</groupId>
			<artifactId>spring-cloud-starter-netflix-hystrix</artifactId>
		</dependency>
	</dependencies>

	<dependencyManagement>
		<dependencies>
			<dependency>
				<groupId>org.springframework.cloud</groupId>
				<artifactId>spring-cloud-dependencies</artifactId>
				<version>Finchley.SR1</version>
				<type>pom</type>
				<scope>import</scope>
			</dependency>
		</dependencies>
	</dependencyManagement>

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<Void> 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参数再次请求后，则可以看到正常返回了结果（注意服务名为大写）。