SpringCloudGateway网关

最新推荐文章于 2024-06-12 20:53:12 发布

村口莫同学

最新推荐文章于 2024-06-12 20:53:12 发布

阅读量181

点赞数

分类专栏：分布式文章标签：分布式

本文链接：https://blog.csdn.net/Marikty/article/details/118616281

版权

分布式专栏收录该内容

8 篇文章 0 订阅

订阅专栏

1、基础简述

1.1 什么是SpringCloudGateway？

Spring Cloud Gateway是Spring官网基于Spring 5.0、 Spring Boot 2.0、Project Reactor等技术开发的网关服务。
Spring Cloud Gateway基于Filter链提供网关基本功能：安全、监控／埋点、限流等。
Spring Cloud Gateway为微服务架构提供简单、有效且统一的API路由管理方式。
Spring Cloud Gateway是替代Netflix Zuul的一套解决方案。

Spring Cloud Gateway组件的核心是一系列的过滤器，通过这些过滤器可以将客户端发送的请求转发（路由）到对应的微服务。 Spring Cloud Gateway是加在整个微服务最前沿的防火墙和代理器，隐藏微服务结点IP端口信息，从而加强安全保护。Spring Cloud Gateway本身也是一个微服务，需要注册到Eureka服务注册中心。

网关的核心功能是：过滤和路由

1.2 Gateway加入后的架构

在这里插入图片描述

不管是来自于客户端（PC或移动端）的请求，还是服务内部调用。一切对服务的请求都可经过网关，然后再由网关来实现鉴权、动态路由等等操作。Gateway就是我们服务的统一入口。

1.3 核心概念

路由（route） 路由信息的组成：由一个ID、一个目的URL、一组断言工厂、一组Filter组成。如果路由断言为真，说明请求URL和配置路由匹配。
断言（Predicate） Spring Cloud Gateway中的断言函数输入类型是Spring 5.0框架中的ServerWebExchange。Spring Cloud Gateway的断言函数允许开发者去定义匹配来自于HTTP Request中的任何信息比如请求头和参数。
过滤器（Filter） 一个标准的Spring WebFilter。 Spring Cloud Gateway中的Filter分为两种类型的Filter，分别是Gateway Filter和Global Filter。过滤器Filter将会对请求和响应进行修改处理

2、入门案例

需求：通过网关微服务系统xxx将包含有 /user 的请求路由到 http://127.0.0.1:9091/user/用户id

2.1 引入依赖

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

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

2.2 编写启动类

@SpringBootApplication
@EnableDiscoveryClient
public class GatewayApplication {
	public static void main(String[] args) {
		SpringApplication.run(GatewayApplication.class, args);
	}
}

2.3 application配置文件

server:
	port: 10010
spring:
	application:
		name: api-gateway
eureka:
	client:
		service-url:
			defaultZone: HTTP://127.0.0.1:10086/eureka
	instance:
		prefer-ip-address: true

需要用网关来代理 user-service 服务，先看一下控制面板中的服务状态：
在这里插入图片描述

ip为：127.0.0.1
端口为：9091

修改application配置文件，添加网关配置

server:
	port: 10010
spring:
	application:
		name: api-gateway
#------------------网关配置-------------------------
	cloud:
		gateway:
			routes:
				# 路由id，可以随意写
				- id: user-service-route
					# 代理的服务地址
					uri: HTTP://127.0.0.1:9091
					# 路由断言，可以配置映射路径
					predicates:
						- Path=/user/**
#---------------------------------------------------
eureka:
	client:
		service-url:
			defaultZone: HTTP://127.0.0.1:10086/eureka
	instance:
		prefer-ip-address: true

将符合 Path 规则的一切请求，都代理到 uri 参数指定的地址。本例中，将路径中包含有 /user/** 开头的请求，代理到http://127.0.0.1:9091

即：http://localhost:10010/user/7 -> http://localhost:9091/user/7

3、面向服务的路由

在这里插入图片描述

在刚才的路由规则中，把路径对应的服务地址写死了！如果同一服务有多个实例的话，这样做显然不合理。应该根据服务的名称，去Eureka注册中心查找服务对应的所有实例列表，然后进行动态路由！

3.1 通过服务名称获取

修改application.yml 文件如下：

server:
	port: 10010
spring:
	application:
		name: api-gateway
#------------------网关配置-------------------------
	cloud:
		gateway:
			routes:
				# 路由id，可以随意写
				- id: user-service-route
					# 代理的服务地址
					# uri: HTTP://127.0.0.1:9091
					uri: lb://user-service
					# 路由断言，可以配置映射路径
					predicates:
						- Path=/user/**
#---------------------------------------------------
eureka:
	client:
		service-url:
			defaultZone: HTTP://127.0.0.1:10086/eureka
	instance:
		prefer-ip-address: true

路由配置中uri所用的协议为lb时（以uri: lb://user-service为例），gateway将使用LoadBalancerClient把user-service通过eureka解析为实际的主机和端口，并进行ribbon负载均衡。

4 路由前缀

客户端的请求地址与微服务的服务地址如果不一致的时候，可以通过配置路径过滤器实现路径前缀的添加和去除。（主要也还是为了隐藏真实微服务地址）

提供服务的地址：http://127.0.0.1:9091/user/8

添加前缀：对请求地址添加前缀路径之后再作为代理的服务地址；

http://127.0.0.1:10010/8 --> http://127.0.0.1:9091/user/8 添加前缀路径/user

去除前缀：将请求地址中路径去除一些前缀路径之后再作为代理的服务地址；

http://127.0.0.1:10010/api/user/8 --> http://127.0.0.1:9091/user/8 去除前缀路径/api

4.1 添加前缀

在gateway中可以通过配置路由的过滤器PrefixPath，实现映射路径中地址的添加；

server:
	port: 10010
spring:
	application:
		name: api-gateway
#------------------网关配置-------------------------
	cloud:
		gateway:
			routes:
				# 路由id，可以随意写
				- id: user-service-route
					# 代理的服务地址
					uri: lb://user-service
					# 路由断言，可以配置映射路径
					predicates:
						- Path=/**
				 	filters:
				 		#添加请求路径的前缀
				 		- PrefixPath=/user
#---------------------------------------------------
eureka:
	client:
		service-url:
			defaultZone: HTTP://127.0.0.1:10086/eureka
	instance:
		prefer-ip-address: true

通过 PrefixPath=/xxx 来指定了路由要添加的前缀。也就是：

PrefixPath=/user http://localhost:10010/8 --> http://localhost:9091/user/8
PrefixPath=/user/abc http://localhost:10010/8 --> http://localhost:9091/user/abc/8

4.2 去除前缀

在gateway中可以通过配置路由的过滤器StripPrefix，实现映射路径中地址的去除；

server:
	port: 10010
spring:
	application:
		name: api-gateway
#------------------网关配置-------------------------
	cloud:
		gateway:
			routes:
				# 路由id，可以随意写
				- id: user-service-route
					# 代理的服务地址
					uri: lb://user-service
					# 路由断言，可以配置映射路径
					predicates:
						- Path=/api/user/**
				 	filters:
				 		#标识过滤1个路径，2表示两个路径，以此类推
				 		- StripPrefix=1
#---------------------------------------------------
eureka:
	client:
		service-url:
			defaultZone: HTTP://127.0.0.1:10086/eureka
	instance:
		prefer-ip-address: true

通过 StripPrefix=1 来指定了路由要去掉的前缀个数。如：路径 /api/user/1 将会被代理到 /user/1 。也就是：

StripPrefix=1 http://localhost:10010/api/user/8 --》http://localhost:9091/user/8
StripPrefix=2 http://localhost:10010/api/user/8 --》http://localhost:9091/8

5、过滤器

5.1 简介

Gateway作为网关的其中一个重要功能，就是实现请求的鉴权。而这个动作往往是通过网关提供的过滤器来实现的。前面的路由前缀章节中的功能也是使用过滤器实现的。

Gateway自带过滤器有几十个，常见自带过滤器有：

过滤器名称	说明
AddRequestHeader	对匹配上的请求加上Header
AddRequestParameters	对匹配上的请求路由添加参数
AddResponseHeader	对从网关返回的响应添加Heade
StripPrefix	对匹配上的请求路径去除前缀
PrefixPath	对匹配上的请求路径添加前缀

在这里插入图片描述

5.2 配置全局默认过滤器

这些自带的过滤器可以和使用路由前缀章节中的用法类似，也可以将这些过滤器配置成不只是针对某个路由；而是可以对所有路由生效，也就是配置默认过滤器：

server:
	port: 10010
spring:
	application:
		name: api-gateway
#------------------网关配置-------------------------
	cloud:
		gateway:
			routes:
				# 路由id，可以随意写
				- id: user-service-route
					# 代理的服务地址
					uri: lb://user-service
					# 路由断言，可以配置映射路径
					predicates:
						- Path=/api/user/**
				 	filters:
				 		#标识过滤1个路径，2表示两个路径，以此类推
				 		- StripPrefix=1
			# 默认过滤器，对所有路由都生效
			default-filters:
				- AddResponseHeader=X-Response-Foo, Bar
				- AddResponseHeader=abc-myname,lxs
#---------------------------------------------------
eureka:
	client:
		service-url:
			defaultZone: HTTP://127.0.0.1:10086/eureka
	instance:
		prefer-ip-address: true

上述配置后，再访问 http://localhost:10010/api/user/7 的话；那么可以从其响应中查看到如下信息：
在这里插入图片描述

过滤器类型：Gateway实现方式上，有两种过滤器；

局部过滤器：通过 spring.cloud.gateway.routes.filters 配置在具体路由下，只作用在当前路由上；如果配置spring.cloud.gateway.default-filters 上会对所有路由生效也算是全局的过滤器；但是这些过滤器的实现上都是要实现GatewayFilterFactory接口。
全局过滤器：不需要在配置文件中配置，作用在所有的路由上；== 实现 GlobalFilter 接口即可==。

5.3 执行生命周期

Spring Cloud Gateway 的 Filter 的生命周期也类似Spring MVC的拦截器有两个：“pre” 和 “post”。“pre”和 “post” 分别会在请求被执行前调用和被执行后调用。
在这里插入图片描述

5.4 使用场景

常见的应用场景如下：

请求鉴权：一般 GatewayFilterChain 执行filter方法前，如果发现没有访问权限，直接就返回空。
异常处理：一般 GatewayFilterChain 执行filter方法后，记录异常并返回。
服务调用时长统计： GatewayFilterChain 执行filter方法前后根据时间统计。

6、自定义过滤器

命名规则：xxxGatewayFilterFactiry (类) --> xxx=参数 (配置)

6.1 自定义局部过滤器

需求：
在过滤器（MyParamGatewayFilterFactory）中将http://localhost:10010/api/user/8?name=lxs中的参数name的值获取到并输出到控制台；并且参数名是可变的，也就是不一定每次都是name；需要可以通过配置过滤器的时候做到配置参数名。

在application.yml中对某个路由配置过滤器，该过滤器可以在控制台输出配置文件中指定名称的请求参数的值。

1）编写过滤器

@Component
public class MyParamGatewayFilterFactory extends
AbstractGatewayFilterFactory<MyParamGatewayFilterFactory.Config> {
	static final String PARAM_NAME = "param";
	
	public MyParamGatewayFilterFactory() {
		super(Config.class);
	}
	
	public List<String> shortcutFieldOrder() {
	 //与config配置属性名称相对应
	 return Arrays.asList(PARAM_NAME);
	}

	public static class Config{
		//自动对应在配置过滤器的时候指定的参数名
		private String param;
			public String getParam() {
			return param;
		}
		public void setParam(String param) {
			this.param = param;
		}
	}
	
	@Override
	public GatewayFilter apply(Config config) {
		return (exchange, chain) -> {
			// http://localhost:10010/api/user/8?name=lxs config.param ==> name
			//获取请求参数中param对应的参数名 的参数值
			ServerHTTPRequest request = exchange.getRequest();
			if(request.getQueryParams().containsKey(config.param)){
				request.getQueryParams().get(config.param).
				forEach(value -> System.out.printf("------------局部过滤器--------%s = %s-
				-----", config.param, value));
			}
			//放行，执行请求
			return chain.filter(exchange);
		};
	}
	
}

2）修改配置文件

server:
	port: 10010
spring:
	application:
		name: api-gateway
#------------------网关配置-------------------------
	cloud:
		gateway:
			routes:
				# 路由id，可以随意写
				- id: user-service-route
					# 代理的服务地址
					uri: lb://user-service
					# 路由断言，可以配置映射路径
					predicates:
						- Path=/api/user/**
				 	filters:
				 		#标识过滤1个路径，2表示两个路径，以此类推
				 		- StripPrefix=1
				 		#自定义过滤器
				 		- MyParam=name
			# 默认过滤器，对所有路由都生效
			default-filters:
				- AddResponseHeader=X-Response-Foo, Bar
				- AddResponseHeader=abc-myname,lxs
#---------------------------------------------------
eureka:
	client:
		service-url:
			defaultZone: HTTP://127.0.0.1:10086/eureka
	instance:
		prefer-ip-address: true

测试访问：http://localhost:10010/api/user/7?name=xxx 检查后台是否输出name和xxx；
但是若访问 http://localhost:10010/api/user/7?name2=xxx则是不会输出的

6.2 自定义全局过滤器

需求：编写全局过滤器，在过滤器中检查请求中是否携带token请求头。如果token请求头存在则放行；如果token为空或者不存在则设置返回的状态码为：未授权也不再执行下去。

在gateway工程编写全局过滤器类MyGlobalFilte

@Component
public class MyGlobalFilter implements GlobalFilter, Ordered {
	@Override
	public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
		System.out.println("--------------全局过滤器MyGlobalFilter------------------");
		String token = exchange.getRequest().getHeaders().getFirst("token");
		if(StringUtils.isBlank(token)){
			//设置响应状态码为未授权
			exchange.getResponse().setStatusCode(HTTPStatus.UNAUTHORIZED);
			//结束过滤器链
			return exchange.getResponse().setComplete();
		}
		return chain.filter(exchange);
	}
	
	@Override
	public int getOrder() {//值越小越先执行
		return 1;
	}
}

访问 http://localhost:10010/api/user/7
在这里插入图片描述
访问 http://localhost:10010/api/user/7?token=abc

7、Gateway跨域配置

一般网关都是所有微服务的统一入口，必然在被调用的时候会出现跨域问题。

跨域：在js请求访问中，如果访问的地址与当前服务器的域名、ip或者端口号不一致则称为跨域请求若不解决则不能获取到对应地址的返回结果。

如：从在http://localhost:9090中的js访问 http://localhost:9000的数据，因为端口不同，所以也是跨域请求。

在访问Spring Cloud Gateway网关服务器的时候，出现跨域问题的话；可以在网关服务器中通过配置解决，允许哪些服务是可以跨域请求的；具体配置如下：

server:
	port: 10010
spring:
	application:
		name: api-gateway
#------------------网关配置-------------------------
	cloud:
		gateway:
			routes:
				# 路由id，可以随意写
				- id: user-service-route
					# 代理的服务地址
					uri: lb://user-service
					# 路由断言，可以配置映射路径
					predicates:
						- Path=/api/user/**
				 	filters:
				 		#标识过滤1个路径，2表示两个路径，以此类推
				 		- StripPrefix=1
				 		#自定义过滤器
				 		- MyParam=name
			# 默认过滤器，对所有路由都生效
			default-filters:
				- AddResponseHeader=X-Response-Foo, Bar
				- AddResponseHeader=abc-myname,lxs
			globalcors:
				corsConfigurations:
					'[/**]':
						#allowedOrigins:* # 这种写法或者下面的都可以，*表示全部
						allowedOrigins:
							- "http://docs.spring.io"
						allowedMethods:
							- GET
#---------------------------------------------------
eureka:
	client:
		service-url:
			defaultZone: HTTP://127.0.0.1:10086/eureka
	instance:
		prefer-ip-address: true

村口莫同学

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
SpringCloudGateway网关

1、基础简述1.1 什么是SpringCloudGateway？1.2 Gateway加入后的架构1.3 核心概念2、入门案例2.1 引入依赖2.2 编写启动类2.3 application配置文件3、面向服务的路由3.1 通过服务名称获取4 路由前缀4.1 添加前缀4.2 去除前缀5、过滤器5.1 简介5.2 配置全局默认过滤器5.3 执行生命周期5.4 使用场景6、自定义过滤器6.1 自定义局部过滤器6.2 自定义全局过滤器7、Gateway跨域配置1、基础简述1.1 什么是SpringCloud.
复制链接

扫一扫

专栏目录