Spring-Cloud-Gateway源码分析系列 | Spring-Cloud-Gateway之GatewayProperties初始化加载

扫码关注公众号:Java 技术驿站

发送:vip
将链接复制到本浏览器,永久解锁本站全部文章

【公众号:Java 技术驿站】 【加作者微信交流技术,拉技术群】

推荐 Spring Boot/Cloud 视频:

在Spring-Cloud-Gateway初始化时我们在GatewayAutoConfiguration配置中看到了有初始化加载GatewayProperties实例的配置,接下来学习下GatewayProperties都加载了哪些信息

GatewayAutoConfiguration中我看到加载GatewayProperties如下:

        //加载配置beans
        // ConfigurationProperty beans
        @Bean
        public GatewayProperties gatewayProperties() {
            return new GatewayProperties();
        }

GatewayProperties的代码如下:

    /**
     * 网关配置信息加载
     * 从appliccation.yml中解析前缀为spring.cloud.gateway的配置
     * @author Spencer Gibb
     */
    @ConfigurationProperties("spring.cloud.gateway")
    @Validated
    public class GatewayProperties {

        /**
         * 路由定义列表
         * 加载配置key=spring.cloud.gateway.routes 列表
         * List of Routes
         */
        @NotNull
        @Valid
        private List<RouteDefinition> routes = new ArrayList<>();

        /**
         * 默认的过滤器定义列表
         * 加载配置 key = spring.cloud.gateway.default-filters 列表
         * List of filter definitions that are applied to every route.
         */
        private List<FilterDefinition> defaultFilters = new ArrayList<>();

        /**
         * 网媒体类型列表
         * 加载配置 key = spring.cloud.gateway.streamingMediaTypes 列表
         * 默认包含{text/event-stream,application/stream+json}
         */
        private List<MediaType> streamingMediaTypes = Arrays.asList(MediaType.TEXT_EVENT_STREAM,
                MediaType.APPLICATION_STREAM_JSON);
    }          

由GatewayProperties代码可以看出其包含如下配置信息

  • spring.cloud.gateway.routes:网关路由定义配置,列表形式
  • spring.cloud.gateway.default-filters: 网关默认过滤器定义配置,列表形式
  • spring.cloud.gateway.streamingMediaTypes:网关网络媒体类型,列表形式

同时,我们看到代码中的routes其实RouteDefinition集合,defaultFilters是FilterDefinition集合,在Spring-Cloud-Gateway之route数据模型我们已经分析了这两个数据模型所有的字段含义以及类型了。通过数据模型以及代码可以看出配置中可以包含的具体信息。

  • spring.cloud.gateway.routes
    id:路由ID 编号,唯一
    uri: 路由指向的URI
    order: 顺序
    predicates:谓语数组,列表形式
  • spring.cloud.gateway.default-filters
    name:过滤器定义名称
    args: 参数

接下来看下Spring-Cloud-Gateway给的样例工程(spring-cloud-gateway-sample)中的配置

    spring:
      cloud:
        gateway:
          default-filters:
          - PrefixPath=/httpbin
          - AddResponseHeader=X-Response-Default-Foo, Default-Bar
          routes:
          - id: websocket_test
            uri: ws://localhost:9000
            order: 9000
            predicates:
            - Path=/echo
          - id: default_path_to_httpbin
            uri: ${test.uri}
            order: 10000
            predicates:
            - Path=/**
  • 备注
    default-filters下配置PrefixPath=/httpbin字符串,可以查看FilterDefinition中构造函数,它接收一个text字符串解析字符传并创建实例信息。同样predicates配置与其一致。
    字符传格式:name=param1,param2,param3…。

如下:

        public FilterDefinition(String text) {
            int eqIdx = text.indexOf("=");
            if (eqIdx <= 0) {
                setName(text);
                return;
            }
            setName(text.substring(0, eqIdx));

            String[] args = tokenizeToStringArray(text.substring(eqIdx+1), ",");

            for (int i=0; i < args.length; i++) {
                this.args.put(NameUtils.generateName(i), args[i]);
            }
        }

上面的配置可以很容易的知道最终加载出来GatewayProperties实例中都包含哪些信息。

弄懂了配置的具体加载以及初始化会加深对网关整体流程的理解,合理的使用配置文件定义我们自己的需求,快速的根据配置定位,了解服务的详细情况

专家推荐

“随着微服务架构的发展,Spring Cloud 使用得越来越广泛。驰狼课堂 Spring Boot 快速入门,Spring Boot 与Spring Cloud 整合,docker+k8s,大型电商商城等多套免费实战教程可以帮您真正做到快速上手,将技术点切实运用到微服务项目中。”


来源:[]()

赞(0) 打赏
版权归原创作者所有,任何形式的转载请联系博主:daming_90:Java 技术驿站 » Spring-Cloud-Gateway源码分析系列 | Spring-Cloud-Gateway之GatewayProperties初始化加载

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏