spring cloud gateway 深入了解 - Predicate

文章来源

spring cloud gateway 通过谓词（Predicate）来匹配来自用户的请求

为了方便，使用postman测试不同的谓词的效果

路径谓词（Predicate）—— 最简单的谓词

• 配置如下

spring:
  cloud:
    gateway:
      routes:
        # 匹配指定路径的路由
      - id: path_route
        uri: http://www.baidu.com
        predicates:
        - Path=/baidu/**
        filters:
        - StripPrefix=1

• Path谓词配置的- Path=/baidu/**的作用是：匹配所有请求路径以http://localhost:8888/baidu开头的用户请求
• 用postman请求http://localhost:8888/baidu，返回百度网页的HTML，效果如图

 

cookie谓词

• 配置如下

spring:
  cloud:
    gateway:
      routes:
        # 匹配指定cookie的路由
      - id: cookie_route
        uri: http://www.taobao.com
        predicates:
        - Cookie=chocolate, value

• Cookie谓词配置的- Cookie=chocolate, value的作用是：匹配请求中存在cookiechocolate=value的所有请求
  • 注意：- Cookie=chocolate, value中的value是正则表达式
• 用postman随便请求一个urlhttp://localhost:8888/1111111，只要存在cookiechocolate=value，都网关都会匹配到对应路由，最后返回淘宝的HTML，效果如图

请求头谓词

• 配置如下

spring:
  cloud:
    gateway:
      routes:
        # 匹配指定请求头的路由
      - id: header_route
        uri: http://www.jd.com/
        predicates:
        - Header=X-Request-Id, \d+

• Header谓词配置的- Header=X-Request-Id, \d+的作用是：匹配请求头中存在符合条件“key为X-Request-Id，value为数字”的所有请求
  • 注意：Header=X-Request-Id, \d+，第二个参数是正则表达式，如\d+
• 用postman随便请求一个urlhttp://localhost:8888/2222222，只要请求头中符合key为X-Request-Id，value为数字，都网关都会匹配到对应路由，最后返回京东的HTML，效果如图

 

请求参数谓词

• 配置如下

spring:
  cloud:
    gateway:
      routes:
        # 匹配指定请求参数的路由
      - id: cookie_route
        uri: http://tmall.com/
        predicates:
        - Query=param1,value

• 上面请求参数谓词- Query=param1,value的含义是： 匹配所有含有请求参数param1且它的值符合正则表达式value的请求

  • 注意：- Query=param1,value中的value是正则表达式
  • 注意：- Query=param1,value中的value可以省略
    • 即可变成- Query=param1，这是匹配所有请求参数含有param1的请求并且不筛选值

• 效果如下

 

其他谓词

• host谓词匹配对应的host，如下匹配www.somehost.org 或 beta.somehost.org等

spring:
  cloud:
    gateway:
      routes:
      - id: host_route
        uri: http://example.org
        predicates:
        - Host=**.somehost.org

Method方法谓词匹配如get，post等请求的方法

spring:
  cloud:
    gateway:
      routes:
      - id: method_route
        uri: http://example.org
        predicates:
        - Method=GET

• RemoteAddr为ip地址谓词，匹配对应ip地址

spring:
  cloud:
    gateway:
      routes:
      - id: remoteaddr_route
        uri: http://example.org
        predicates:
        - RemoteAddr=192.168.1.1/24

• After、Before、Between等时间谓词，分别匹配在某时之后，之前，和某段时间内的请求

谓词组合

• 不同谓词之间可以组合使用。它们同时存在于同一个路由时，请求必须同时满足所有的谓词条件才被这个路由匹配。
• 注意：一个请求满足多个路由的谓词条件时，请求只会被首个成功匹配的路由转发
• 配置如下

spring:
  cloud:
    gateway:
      routes:
        # 匹配指定请求参数和请求头的路由
      - id: compose_route
        uri: http://www.oschina.net/
        predicates:
        - Query=param2
        - Header=Header-Route,value

• 　效果如下