本文采用Spring cloud本文为2.1.8RELEASE,version=Greenwich.SR3
[toc]
本文基于前两篇文章eureka-server、eureka-client、eureka-ribbon、eureka-feign和spring-gataway的实现。
参考
Spring Cloud Gateway内部已经提供非常多的过滤器filter,Hystrix Gateway Filter、Prefix PathGateway Filter等。感兴趣的小伙伴可以直接阅读Spring Cloud Gateway官网相关文档或直接阅读源码。但是很多情况下自带的过滤器并不能满足我们的需求,所以自定义过滤器就显得的非常重要。本文主要介绍全局过滤器(Global Filter)和局部过滤器(Gateway Filter)。
自定义过滤器需要实现GatewayFilter和Ordered。其中GatewayFilter主要是用来实现自定义的具体逻辑,Ordered中的getOrder()方法是来给过滤器设定优先级别的,值越大优先级别越低。
package spring.cloud.demo.spring.gateway.filter; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; import org.springframework.cloud.gateway.filter.GatewayFilter; import org.springframework.cloud.gateway.filter.GatewayFilterChain; import org.springframework.core.Ordered; import org.springframework.web.server.ServerWebExchange; import reactor.core.publisher.Mono; public class MyGatewayFilter implements GatewayFilter, Ordered { private static final Log log = LogFactory.getLog(MyGatewayFilter.class); private static final String TIME = "Time"; @Override public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) { exchange.getAttributes().put(TIME, System.currentTimeMillis()); return chain.filter(exchange).then( Mono.fromRunnable(() -> { Long start = exchange.getAttribute(TIME); if (start != null) { log.info("exchange request uri:" + exchange.getRequest().getURI() + ", Time:" + (System.currentTimeMillis() - start) + "ms"); } }) ); } @Override public int getOrder() { return Ordered.LOWEST_PRECEDENCE; } }
我们在请求过来到达的时候,往ServerWebExchange中放了一个属性TIME,属性的值为当前时间的毫秒数,然后请求结束后,又会将请求的时间数取出来来和当前时间数做差,得到耗时时间数。
如何区分“pre”和“post”?
package spring.cloud.demo.spring.gateway.config; import org.springframework.cloud.gateway.route.RouteLocator; import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import spring.cloud.demo.spring.gateway.filter.MyGatewayFilter; /** * @auther: fujie.feng * @DateT: 2019-10-12 */ @Configuration public class RoutesConfig { @Bean public RouteLocator routeLocator(RouteLocatorBuilder routeLocatorBuilder){ return routeLocatorBuilder.routes().route(r -> r.path("/ribbon/**") .filters(f -> f.stripPrefix(1) .filter(new MyGatewayFilter()) //增加自定义filter .addRequestHeader("X-Response-Default-Foo", "Default-Bar")) .uri("lb://EUREKA-RIBBON") .order(0) .id("ribbon-route") ).build(); } }
启动eureka-server、eureka-client、eureka-ribbon、spring-gateway相关服务,访问 http://localhost :8100/ribbon/sayHello地址,页面显示结果如下:
这时我打开控制台可以看到日志输出为:
package spring.cloud.demo.spring.gateway.filter; import org.apache.commons.lang.StringUtils; import org.springframework.cloud.gateway.filter.GatewayFilterChain; import org.springframework.cloud.gateway.filter.GlobalFilter; import org.springframework.core.Ordered; import org.springframework.http.HttpStatus; import org.springframework.web.server.ServerWebExchange; import reactor.core.publisher.Mono; /** * 全局过滤器 * 校验token */ public class MyGlobalFilter implements GlobalFilter, Ordered { private static final String TOKEN = "token"; @Override public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) { String parm = exchange.getRequest().getQueryParams().getFirst(TOKEN); if (StringUtils.isBlank(parm)) { exchange.getResponse().setStatusCode(HttpStatus.UNAUTHORIZED); return exchange.getResponse().setComplete(); } return chain.filter(exchange); } @Override public int getOrder() { return 1; } }
将MyGlobalFilter添加到Bean中
package spring.cloud.demo.spring.gateway.filter; import org.apache.commons.lang.StringUtils; import org.springframework.cloud.gateway.filter.GatewayFilterChain; import org.springframework.cloud.gateway.filter.GlobalFilter; import org.springframework.core.Ordered; import org.springframework.http.HttpStatus; import org.springframework.web.server.ServerWebExchange; import reactor.core.publisher.Mono; /** * 全局过滤器 * 校验token */ public class MyGlobalFilter implements GlobalFilter, Ordered { private static final String TOKEN = "token"; @Override public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) { String parm = exchange.getRequest().getQueryParams().getFirst(TOKEN); if (StringUtils.isBlank(parm)) { exchange.getResponse().setStatusCode(HttpStatus.UNAUTHORIZED); return exchange.getResponse().setComplete(); } return chain.filter(exchange); } @Override public int getOrder() { return 1; } }
这里只是简单模拟,如果感兴趣的小伙伴可以自己尝试将所有参数取出来并解析(可以利用反射来实现)。
重启动服务,访问 http://localhost :8100/ribbon/sayHello,显示如下:
我可以看到显示访问是不生效的,我们在请求中加如token=xxx,显示如下:
这是看到正常返回。日志输出入下:
2019-10-21 16:20:00.478 INFO 15322 --- [ctor-http-nio-2] c.netflix.config.ChainedDynamicProperty : Flipping property: EUREKA-RIBBON.ribbon.ActiveConnectionsLimit to use NEXT property: niws.loadbalancer.availabilityFilteringRule.activeConnectionsLimit = 2147483647 2019-10-21 16:20:00.480 INFO 15322 --- [ctor-http-nio-2] c.n.l.DynamicServerListLoadBalancer : DynamicServerListLoadBalancer for client EUREKA-RIBBON initialized: DynamicServerListLoadBalancer:{NFLoadBalancer:name=EUREKA-RIBBON,current list of Servers=[eureka1.server.com:8901],Load balancer stats=Zone stats: {defaultzone=[Zone:defaultzone; Instance count:1; Active connections count: 0; Circuit breaker tripped count: 0; Active connections per server: 0.0;] },Server stats: [[Server:eureka1.server.com:8901; Zone:defaultZone; Total Requests:0; Successive connection failure:0; Total blackout seconds:0; Last connection made:Thu Jan 01 08:00:00 CST 1970; First connection made: Thu Jan 01 08:00:00 CST 1970; Active Connections:0; total failure count in last (1000) msecs:0; average resp time:0.0; 90 percentile resp time:0.0; 95 percentile resp time:0.0; min resp time:0.0; max resp time:0.0; stddev resp time:0.0] ]}ServerList:org.springframework.cloud.netflix.ribbon.eureka.DomainExtractingServerList@40585976 2019-10-21 16:20:01.293 INFO 15322 --- [ctor-http-nio-8] s.c.d.s.gateway.filter.MyGatewayFilter : exchange request uri:http://localhost:8100/sayHello?token=xxx, Time:23ms 2019-10-21 16:20:01.467 INFO 15322 --- [erListUpdater-0] c.netflix.config.ChainedDynamicProperty : Flipping property: EUREKA-RIBBON.ribbon.ActiveConnectionsLimit to use NEXT property: niws.loadbalancer.availabilityFilteringRule.activeConnectionsLimit = 2147483647
引用官网原文:The GlobalFilter interface has the same signature as GatewayFilter. These are special filters that are conditionally applied to all routes. (This interface and usage are subject to change in future milestones). 说明GlobalFilter在未来的版本中会又一些变化。
至此,自定义filter的两种方式就简单的实现完成了。同样的方式可以在feign做测试。
在前一片文章中,配置文件中有这样一段配置:
filters: - StripPrefix=1 - AddResponseHeader=X-Response-Default-Foo, Default-Bar
StripPrefix和AddResponseHeader这两个配置实际上是两个Filter的过滤器工厂(GatewayFilterFactory),接下来将介绍过滤器工厂的使用,相对来说这种方式更加灵活。
package spring.cloud.demo.spring.gateway.factory; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; import org.springframework.cloud.gateway.filter.GatewayFilter; import org.springframework.cloud.gateway.filter.factory.AbstractGatewayFilterFactory; import reactor.core.publisher.Mono; import java.util.Arrays; import java.util.List; /** * 自定义过滤器工厂 */ public class MyGatewayFilterFactory extends AbstractGatewayFilterFactory<MyGatewayFilterFactory.Config> { private static final Log log = LogFactory.getLog(MyGatewayFilterFactory.class); private static final String PARAMS = "myParams"; private static final String START_TIME = "startTime"; public MyGatewayFilterFactory() { super(Config.class); } @Override public List<String> shortcutFieldOrder() { return Arrays.asList(PARAMS); } @Override public GatewayFilter apply(Config config) { return ((exchange, chain) -> { exchange.getAttributes().put(START_TIME, System.currentTimeMillis()); return chain.filter(exchange).then( Mono.fromRunnable(() -> { Long startTime = exchange.getAttribute(START_TIME); if (startTime == null) { return; } StringBuilder sb = new StringBuilder(); sb.append("exchange request uri:" + exchange.getRequest().getURI() + ","); sb.append("Time:" + (System.currentTimeMillis() - startTime) + "ms."); if (config.isMyParams()) { sb.append("params:" + exchange.getRequest().getQueryParams()); } log.info(sb.toString()); }) ); }); } /** * 配置参数类 */ public static class Config { private boolean myParams; public boolean isMyParams() { return myParams; } public void setMyParams(boolean myParams) { this.myParams = myParams; } } }
注意:当我们继承AbstractGatewayFilterFactory的时候,要把自定义的Config类传给父类,否者会报错。
package spring.cloud.demo.spring.gateway.config; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import spring.cloud.demo.spring.gateway.factory.MyGatewayFilterFactory; @Configuration public class FilterFactory { @Bean public MyGatewayFilterFactory myGatewayFilterFactory() { return new MyGatewayFilterFactory(); } }
server: port: 8100 spring: application: name: spring-gateway cloud: gateway: discovery: locator: enabled: true # 开启通过服务中心的自动根据 serviceId 创建路由的功能 default-filters: - My=true routes: - id: ribbon-route uri: lb://EUREKA-RIBBON order: 0 predicates: - Path=/ribbon/** filters: - StripPrefix=1 #去掉前缀,具体实现参考StripPrefixGatewayFilterFactory - AddResponseHeader=X-Response-Default-Foo, Default-Bar - id: feign-route uri: lb://EUREKA-FEIGN order: 0 predicates: - Path=/feign/** filters: - StripPrefix=1 - AddResponseHeader=X-Response-Default-Foo, Default-Bar eureka: instance: hostname: eureka1.server.com lease-renewal-interval-in-seconds: 5 lease-expiration-duration-in-seconds: 10 client: service-url: defaultZone: http://eureka1.server.com:8701/eureka/,http://eureka2.server.com:8702/eureka/,http://eureka3.server.com:8703/eureka/
default-filters:- My=true 主要增加了这个配置。
访问 http://localhost :8100/ribbon/sayHello?token=xxx,显示如果下:
日志输出结果:
2019-10-21 17:40:20.191 INFO 18059 --- [ctor-http-nio-2] c.netflix.config.ChainedDynamicProperty : Flipping property: EUREKA-RIBBON.ribbon.ActiveConnectionsLimit to use NEXT property: niws.loadbalancer.availabilityFilteringRule.activeConnectionsLimit = 2147483647 2019-10-21 17:40:20.192 INFO 18059 --- [ctor-http-nio-2] c.n.l.DynamicServerListLoadBalancer : DynamicServerListLoadBalancer for client EUREKA-RIBBON initialized: DynamicServerListLoadBalancer:{NFLoadBalancer:name=EUREKA-RIBBON,current list of Servers=[eureka1.server.com:8901],Load balancer stats=Zone stats: {defaultzone=[Zone:defaultzone; Instance count:1; Active connections count: 0; Circuit breaker tripped count: 0; Active connections per server: 0.0;] },Server stats: [[Server:eureka1.server.com:8901; Zone:defaultZone; Total Requests:0; Successive connection failure:0; Total blackout seconds:0; Last connection made:Thu Jan 01 08:00:00 CST 1970; First connection made: Thu Jan 01 08:00:00 CST 1970; Active Connections:0; total failure count in last (1000) msecs:0; average resp time:0.0; 90 percentile resp time:0.0; 95 percentile resp time:0.0; min resp time:0.0; max resp time:0.0; stddev resp time:0.0] ]}ServerList:org.springframework.cloud.netflix.ribbon.eureka.DomainExtractingServerList@46c172ce 2019-10-21 17:40:20.583 INFO 18059 --- [ctor-http-nio-7] s.c.d.s.g.f.MyGatewayFilterFactory : exchange request uri:http://localhost:8100/ribbon/sayHello?token=xxx,Time:582ms.params:{token=[xxx]} 2019-10-21 17:40:21.181 INFO 18059 --- [erListUpdater-0] c.netflix.config.ChainedDynamicProperty : Flipping property: EUREKA-RIBBON.ribbon.ActiveConnectionsLimit to use NEXT property: niws.loadbalancer.availabilityFilteringRule.activeConnectionsLimit = 2147483647
过滤器工厂的顶级的接口是GatewayFilterFactory,我们可以直接继承它们的两个抽象类AbstractGatewayFilterFactory 和 AbstractNameValueGatewayFilterFactory来简化开发。区别在于AbstractGatewayFilterFactory是接受一个参数,AbstractNameValueGatewayFilterFactory是接收两个参数,例如:- AddResponseHeader=X-Response-Default-Foo, Default-Bar
本文介绍了GatewayFilter、GlobalFilter和GatewayFilterFactory的简单使用方式,相信小伙伴们对Spring Cloud Gateway有了简单的了解。
gitHub地址
<center><font color=red>《Srping Cloud 2.X小白教程》目录</font></center>
本文由博客一文多发平台 OpenWrite 发布!