阅读 228

spring-cloud-gateway静态路由

为什么引入 API 网关

使用 API 网关后的优点如下:

  • 易于监控。可以在网关收集监控数据并将其推送到外部系统进行分析。
  • 易于认证。可以在网关上进行认证,然后再将请求转发到后端的微服务,而无须在每个微服务中进行认证。
  • 减少了客户端与各个微服务之间的交互次数。

基本环境见 spring-cloud-gateway 简介, 项目中 provider1 的 maven 配置在此做下更正

pom.xml

<?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">
    <parent>
        <artifactId>spring-cloud-learning</artifactId>
        <groupId>cn.idea360</groupId>
        <version>1.0</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>idc-provider1</artifactId>

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

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

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

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-openfeign</artifactId>
        </dependency>
    </dependencies>
    <build>
        <finalName>${project.artifactId}</finalName>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>${spring-boot.version}</version>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>
复制代码

静态路由基本实现

静态路由比较简单,这里做简单实现。

更改路由模块 application.yml 配置,更改后的配置文件如下:

server:
  port: 2000
spring:
  application:
    name: idc-gateway
  redis:
    host: localhost
    port: 6379
    timeout: 6000ms  # 连接超时时长(毫秒)
    jedis:
      pool:
        max-active: 1000  # 连接池最大连接数(使用负值表示没有限制)
        max-wait: -1ms      # 连接池最大阻塞等待时间(使用负值表示没有限制)
        max-idle: 10      # 连接池中的最大空闲连接
        min-idle: 5       # 连接池中的最小空闲连接
  cloud:
    consul:
      host: localhost
      port: 8500
    gateway:
      discovery:
        locator:
          enabled: true # gateway可以通过开启以下配置来打开根据服务的serviceId来匹配路由,默认是大写
      routes:
        - id: provider1  # 路由 ID,保持唯一
          uri: lb://idc-provider1 # uri指目标服务地址,lb代表从注册中心获取服务
          predicates: # 路由条件。Predicate 接受一个输入参数,返回一个布尔值结果。该接口包含多种默认方法来将 Predicate 组合成其他复杂的逻辑(比如:与,或,非)
            - Path=/p/**
          filters:
            - StripPrefix=1 # 过滤器StripPrefix,作用是去掉请求路径的最前面n个部分截取掉。StripPrefix=1就代表截取路径的个数为1,比如前端过来请求/test/good/1/view,匹配成功后,路由到后端的请求路径就会变成http://localhost:8888/good/1/view
        - id: provider2  # 路由 ID,保持唯一
          uri: lb://idc-provider2 # uri指目标服务地址,lb代表从注册中心获取服务
          predicates: # 路由条件。Predicate 接受一个输入参数,返回一个布尔值结果。该接口包含多种默认方法来将 Predicate 组合成其他复杂的逻辑(比如:与,或,非)
            - Path=/p2/**
          filters:
            - StripPrefix=1 # 过滤器StripPrefix,作用是去掉请求路径的最前面n个部分截取掉。StripPrefix=1就代表截取路径的个数为1,比如前端过来请求/test/good/1/view,匹配成功后,路由到后端的请求路径就会变成http://localhost:8888/good/1/view
复制代码

测试

执行以下请求测试路由 1

curl http://localhost:2000/p/provider1/1
复制代码

结果 返回 2001 。说明成功路由到了 provider1 服务。

执行以下请求测试路由 2

curl http://localhost:2000/p2/provider2
复制代码

返回 {"port":"2002"} 。说明成功路由到了 provider2 服务。

Predicate 断言条件

1 通过请求参数匹配

Query Route Predicate 支持传入两个参数,一个是属性名一个为属性值,属性值可以是正则表达式。

...
        - id: provider1
          uri: lb://idc-provider1
          predicates:
            - Path=/p/**
            - Query=username
          filters:
            - StripPrefix=1
复制代码

这样配置,只要请求中包含 username 属性的参数即可匹配路由。否则 404

测试

curl http://localhost:2000/p/provider1/1?username=admin
复制代码

经过测试发现只要请求汇总带有 username 参数即会匹配路由,不带 username 参数则不会匹配。

还可以将 Query 的值以键值对的方式进行配置,这样在请求过来时会对属性值和正则进行匹配,匹配上才会走路由。

        - id: provider1
          uri: lb://idc-provider1
          predicates:
            - Path=/p/**
            - Query=username, ad.
          filters:
            - StripPrefix=1
复制代码

这样只要当请求中包含 username 属性并且参数值是以 admin 开头的长度为三位的字符串才会进行匹配和路由。

测试

curl http://localhost:2000/p/provider1/1?username=adm
复制代码

测试可以返回页面代码,将 username 的属性值改为 admin 再次访问就会报 404,证明路由需要匹配正则表达式才会进行路由。

2 通过 Header 属性匹配

Header Route Predicate 和 Cookie Route Predicate 一样,也是接收 2 个参数,一个 header 中属性名称和一个正则表达式,这个属性值和正则表达式匹配则执行。

        - id: provider1
          uri: lb://idc-provider1
          predicates:
            - Path=/p/**
            - Header=token, \d+
          filters:
            - StripPrefix=1
复制代码

测试

curl http://localhost:2000/p/provider1/1 -H "token:11"
复制代码

则返回页面代码证明匹配成功。将参数-H "token:11"改为-H "token:spring"再次执行时返回 404 证明没有匹配。

3 通过 Cookie 匹配

Cookie Route Predicate 可以接收两个参数,一个是 Cookie name ,一个是正则表达式,路由规则会通过获取对应的 Cookie name 值和正则表达式去匹配,如果匹配上就会执行路由,如果没有匹配上则不执行。

        - id: provider1
          uri: lb://idc-provider1
          predicates:
            - Path=/p/**
            - Cookie=sessionId, test
          filters:
            - StripPrefix=1
复制代码

使用 curl 测试,命令行输入:

curl http://localhost:2000/p/provider1/1 --cookie "sessionId=test"
复制代码

则会返回页面代码,如果去掉--cookie "sessionId=test",后台会报 404 错误。

4 通过 Host 匹配

Host Route Predicate 接收一组参数,一组匹配的域名列表,这个模板是一个 ant 分隔的模板,用.号作为分隔符。它通过参数中的主机地址作为匹配规则。

        - id: provider1
          uri: lb://idc-provider1
          predicates:
            - Path=/p/**
            - Host=**.baidu.com
          filters:
            - StripPrefix=1
复制代码

使用 curl 测试,命令行输入:

curl http://localhost:2000/p/provider1/1 -H "Host: www.baidu.com"
curl http://localhost:2000/p/provider1/1 -H "Host: md.baidu.com"
复制代码

经测试以上两种 host 均可匹配到 host_route 路由,去掉 host 参数则会报 404 错误。

5 通过请求方式匹配

可以通过是 POST、GET、PUT、DELETE 等不同的请求方式来进行路由。

        - id: provider1
          uri: lb://idc-provider1
          predicates:
            - Path=/p/**
            - Method=GET
          filters:
            - StripPrefix=1
复制代码

使用 curl 测试,命令行输入:

curl http://localhost:2000/p/provider1/1
复制代码

测试返回页面代码,证明匹配到路由,我们再以 POST 的方式请求测试。

curl -X POST http://localhost:2000/p/provider1/1
复制代码

返回 404 没有找到,证明没有匹配上路由

6 通过请求路径匹配

Path Route Predicate 接收一个匹配路径的参数来判断是否走路由。

        - id: provider1
          uri: lb://idc-provider1
          predicates:
            - Path=/p/{segment}
            - Method=POST
          filters:
            - StripPrefix=1
复制代码

如果请求路径符合要求,则此路由将匹配,例如:/foo/1 或者 /foo/bar。

7 通过请求 ip 地址进行匹配

Predicate 也支持通过设置某个 ip 区间号段的请求才会路由,RemoteAddr Route Predicate 接受 cidr 符号(IPv4 或 IPv6 )字符串的列表(最小大小为 1),例如 192.168.124.5/16 (其中 192.168.124.5 是 IP 地址,16 是子网掩码)。

        - id: provider1
          uri: lb://idc-provider1
          predicates:
            - Path=/p/**
            - RemoteAddr=192.168.124.5/16
          filters:
            - StripPrefix=1
复制代码

可以将此地址设置为本机的 ip 地址进行测试。

curl http://192.168.124.5:2000/p/provider1/1
复制代码

如果请求的远程地址是 192.168.124.5,则此路由将匹配。

8 组合使用

各种 Predicates 同时存在于同一个路由时,请求必须同时满足所有的条件才被这个路由匹配。

一个请求满足多个路由的断言条件时,请求只会被首个成功匹配的路由转发

结语

本篇到此结束,欢迎大家关注公众号【当我遇上你】。