脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 软件编程 → java → spring cloud gateway配置uri

spring cloud gateway中配置uri三种方式

 更新时间：2023年08月18日 09:31:04   作者：qq_41482600  
gateway 组件是SpringCloud 组件中的网关组件,主要是解决路由转发的问题,跟nginx有点类似,区别是nginx多用在前端上,gateway用在后端上,本文给大家介绍的非常详细,需要的朋友参考下吧

spring cloud gateway中配置uri

gateway中配置uri配置有三种方式:

  • websocket方式：uri: ws://localhost:9000
  • http方式: uri: http://localhost:8130/
  • lb注册中心配置方式（注册的服务名称）: uri: lb://monitor-ms

gateway的lb方式识别的服务名称命名规则：

"[a-zA-Z]([a-zA-Z]|\\d|\\+|\\.|-)*:.*"

SpringCloud GateWay 使用说明

前言：

gateway 组件是SpringCloud 组件中的网关组件，主要是解决路由转发的问题；跟nginx有点类似，区别是nginx多用在前端上，gateway用在后端上。当然gateway的功能不止路由转发，还可以用来：

1.针对所有请求做统一鉴权、限流、熔断、日志；

2.协议转化，针对后端多种协议可以在网关层统一处理后以http对外服务；

3.统一错误代码处理（跟springboot统一错误处理配置一样）；

一、配置说明

gateway的配置文件是其使用的核心。

spring:
cloud:
gateway:
routes:
- id: table-service
uri: lb://table-service
predicates:
- Path=/table-service/**
filters:
- StripPrefix=1

字段说明：

id：自定义路由的ID；

uri：目标服务器地址，同时支持 URI(http://ip:port/route) 和 lb(lb://应用注册服务名) 方式，推荐使用lb方式；

predicates：路由条件，根据匹配结果决定是否执行该请求路由；

filters：过滤规则，包含 pre 和 post 过滤，其中 StripPrefix=1 表示根据请求时去掉URL路径的第一个前缀。

二、路由条件配置说明

即predicates 配置项，支持多种规则：

1. 指定时间规则匹配路由

时间的书写必须是ZoneDateTime格式。

spring:
cloud:
gateway:
routes:
- id: table-service
uri: lb://table-service
predicates:
- After=2022-07-20T10:25:00.000+08:00[Asia/Shanghai]

有三种规则：

After：指定时间之后转发到该服务；

Before：指定时间之前转发到该服务；

Between：两个时间之前转发到该服务，两个时间之间用逗号隔开；

2. Cookie 匹配路由

spring:
cloud:
gateway:
routes:
- id: table-service
uri: lb://table-service
predicates:
- Cookie=cho,123

上述配置表示请求时Cookie 必须携带 cho=123 键值对才能转发到该服务；逗号前表示键值，逗号后表示该键对应的值，该值是个正则表达式。

3. Header 匹配路由

spring:
cloud:
gateway:
routes:
- id: table-service
uri: lb://table-service
predicates:
- Header=cho,123

上述配置表示请求时header 必须携带 cho=123 键值对才能转发到该服务；逗号前表示键值，逗号后表示该键对应的值，该值是个正则表达式。

4. Host 匹配路由

spring:
cloud:
gateway:
routes:
- id: table-service
uri: lb://table-service
predicates:
- Host=127.0.0.1,localhost

上述配置表示请求时Host 必须携带 127.0.0.1,localhost 中的任何一个值才能转发到该服务；匹配多值时用逗号隔开，并且支持星号（*）做域名通配符。

5. 请求方法匹配路由

spring:
cloud:
gateway:
routes:
- id: table-service
uri: lb://table-service
predicates:
- Method=POST,GET

上述配置表示请求时只有 GET 和 POST 方法才能转发到该服务；匹配多值时用逗号隔开。

6. 请求路径匹配路由

spring:
cloud:
gateway:
routes:
- id: table-service
uri: lb://table-service
predicates:
- Path=/table/**

该方式是使用最多的。/* 表示单层路径匹配，/** 表示多层路径匹配。

三、过滤配置说明

即filters 配置项，支持多种配置：

1. AddRequestParameters GatewayFilter Factory

spring:
cloud:
gateway:
routes:
- id: table-service
uri: lb://table-service
predicates:
- Path=/table/**
filters:
- AddRequestParameter=foo,bar

上述配置会对走该路由的所有请求都加上 foo=bar 参数。

2. AddResponseHeader GatewayFilter Factory

spring:
cloud:
gateway:
routes:
- id: table-service
uri: lb://table-service
predicates:
- Path=/table/**
filters:
- AddResponseHeader=foo,bar

上述配置会对走该路由的所有请求的返回都加上响应头foo=bar 。

3. RequestRateLimiter GatewayFilter Factory

spring:
cloud:
gateway:
routes:
- id: table-service
uri: lb://table-service
predicates:
- Path=/table/**
filters:
- name: RequestRateLimiter
args:
redis-rate-limiter.replenishRate: 10
redis-rate-limiter.burstCapacity: 20

这个过滤器是基于令牌桶实现的，replenishRate 表示令牌填充速度，burstCapacity 表示令牌桶容量；限流用的，需要集成redis才行。限流的使用略复杂，建议单独研究。

4. Retry GatewayFilter Factory

spring:
cloud:
gateway:
routes:
- id: table-service
uri: lb://table-service
predicates:
- Path=/table/**
filters:
- name: Retry
args:
retries: 3
status: 503

总共涉及4个参数：

retries：重试次数；

status：http 请求返回的状态码，上述配置表示服务端返回503时发起重试；

methods：指定请求类型才会发起重试；

series：配置错误码段，表示符合状态码才发起重试，默认SERVER_ERROR(5)，即 5xx 段状态码才会发起重试；如果 series 配置了错误码，但 status 缺省，则仍然匹配 series 进行重试。

四、自定义 Filter

自定义 filter 有两个，GlobalFilter 和 GatewayFilter ；GlobalFilter 对全局生效，GatewayFilter 只对配置了的才生效。

1. 自定义GlobalFilter

可以存在多个GlobalFilter，执行顺序由 getOrder() 控制，值越小执行越靠前。

@Slf4j
@Service
public class GatewayGlobalFilter implements GlobalFilter, Ordered {
@Override
public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
ServerHttpRequest request = exchange.getRequest();
ServerHttpResponse response = exchange.getResponse();
log.info("pre action..."); //请求到路由前的操作...
return chain.filter(exchange).then(Mono.fromRunnable(() -> {
log.info("post action..."); //请求返回后的操作...
}));
}
@Override
public int getOrder() {
return 0;
}
}

2. 自定义 gatewayFilter

@Slf4j
@Service
public class CustomGatewayFilterFactory extends AbstractGatewayFilterFactory<CustomGatewayFilterFactory.CustomConfig> {
public CustomGatewayFilterFactory() {
super(CustomConfig.class);
}
@Override
public GatewayFilter apply(CustomConfig config) {
return ((exchange, chain) -> {
String name = config.getName();
log.info("config name:{}", name);
log.info("pre action...");
if (name.equals("123")) {                           // 使用config值的样例
return exchange.getResponse().setComplete();    // 不返回任何信息
}
return chain.filter(exchange).then(Mono.fromRunnable(() -> {
log.info("post action...");
}));
});
}
public static class CustomConfig {
private String name;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
}

上述对应的配置文件：

spring:
cloud:
gateway:
routes:
- id: table-service
uri: lb://table-service
predicates:
- Path=/table/**
filters:
- name: Custom
args:
name: 123

几点注意：

1. 类名一般遵循以 GatewayFilterFactory 结尾，所以默认情况下过滤器 name 会采用该自定义类名的前缀，这里配置 name=Custom；或者类名完全不遵循上述规则，，配置时name为类全名；

2. 在 apply 方法中，同时包含 Pre 和 Post 过滤；在 then 方法中是请求执行结束之后的处置；

3. CustomConfig 是一个配置类，其属性值可在配置文件 args 下一层进行配置；

3. 补充

以下是请求不满足条件时的json 返回。

// msg 是个 json 字符串
DataBuffer bodyDataBuffer =response.bufferFactory().wrap(msg.getBytes(StandardCharsets.UTF_8));
return response.writeWith(Mono.just(bodyDataBuffer));

五、整个 demo

1. 本地起一个eureka的注册中心（也可以用nacos等其他的注册中心）

端口：9099

本片代码不是该博客核心，忽略。

2. 起一个gateway的client注册到eureka

依赖：

<?xml version="1.0" encoding="UTF-8"?>
<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>
<groupId>org.example</groupId>
<artifactId>eureka-gateway</artifactId>
<version>1.0.0</version>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.4.5</version>
<relativePath/>
</parent>
<dependencies>
<!--在springboot的pom文件中，该依赖已经集成了springMVC等web启动器，不需要再添加spring-boot-starter-web 依赖了-->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-gateway</artifactId>
</dependency>
<!--eureka-client依赖-->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</dependency>
</dependencies>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>2020.0.2</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
</project>

启动类：

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

配置文件：

server:
port: 8999
spring:
application:
name: gateway-service
cloud:
gateway:
routes:
- id: table-service
uri: lb://table-service
predicates:
- Path=/table-service/**
filters:
- StripPrefix=1
- id: table-service
uri: lb:ws://table-service    #这是websocket转发的配置
predicates:
- Path=/table-socket/**
filters:
- StripPrefix=1
eureka:
instance:
lease-expiration-duration-in-seconds: 10
lease-renewal-interval-in-seconds: 5
prefer-ip-address: true
instance-id: ${spring.cloud.client.ip-address}:${server.port}
client:
service-url:
defaultZone: http://user:passwd@localhost:9099/eureka/

到此这篇关于spring cloud gateway中配置uri三种方式的文章就介绍到这了,更多相关spring cloud gateway配置uri内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

相关文章

  • Java如何跳过https的ssl证书验证详解

    Java如何跳过https的ssl证书验证详解

    这篇文章主要介绍了Java跳过https的ssl证书验证的解决思路，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，下面我们来深入学习下吧
    2019-06-06
  • JVM详解之汇编角度理解本地变量的生命周期

    JVM详解之汇编角度理解本地变量的生命周期

    这篇文章主要介绍了JVM详解之汇编角度理解本地变量的生命周期,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
    2020-07-07
  • Future cancel迷惑性boolean入参解析

    Future cancel迷惑性boolean入参解析

    这篇文章主要为大家介绍了Future cancel迷惑性boolean入参解析，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
    2023-02-02
  • Java String源码contains题解重复叠加字符串匹配

    Java String源码contains题解重复叠加字符串匹配

    这篇文章主要为大家介绍了Java String源码contains题解重复叠加字符串匹配示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
    2022-11-11
  • mybatis foreach 属性及其三种使用情况详解

    mybatis foreach 属性及其三种使用情况详解

    这篇文章主要介绍了mybatis foreach 属性及其三种使用情况详解，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
    2022-01-01
  • SpringBoot2.0整合Shiro框架实现用户权限管理的示例

    SpringBoot2.0整合Shiro框架实现用户权限管理的示例

    这篇文章主要介绍了SpringBoot2.0整合Shiro框架实现用户权限管理的示例，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2019-08-08
  • 带你快速搞定java多线程

    带你快速搞定java多线程

    这篇文章主要介绍了java多线程编程实例，分享了几则多线程的实例代码，具有一定参考价值，加深多线程编程的理解还是很有帮助的，需要的朋友可以参考下
    2021-07-07
  • Maven引入本地Jar包并打包进War包中的方法

    Maven引入本地Jar包并打包进War包中的方法

    本篇文章主要介绍了Maven引入本地Jar包并打包进War包中的方法，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
    2017-11-11
  • Java判断本机IP地址类型的方法

    Java判断本机IP地址类型的方法

    Java判断本机IP地址类型的方法，需要的朋友可以参考一下
    2013-03-03
  • Java操作透明图片并保持背景透明的实现

    Java操作透明图片并保持背景透明的实现

    这篇文章主要介绍了Java操作透明图片并保持背景透明的实现，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
    2021-11-11

最新评论