该项目提供了一个用于在 Spring 上构建 API 网关的库。Spring Cloud Gateway 旨在提供一种简单而有效的方法来路由到 API,并为它们提供横切关注点,例如:安全性、监控/指标和弹性。
特征
Spring Cloud 网关功能:
- 基于 Spring Framework 和 Spring Boot 构建
- 与 Spring WebFlux 和 Spring Web MVC 兼容
- 能够匹配任何请求属性的路由。
- 谓词和筛选条件特定于路由。
- Spring Cloud Circuit Breaker 集成。
- Spring Cloud DiscoveryClient 集成
- 易于编写的谓词和过滤器
- 请求速率限制
- 路径重写
Spring Cloud 网关服务器 WebFlux 入门
@SpringBootApplication
public class DemogatewayApplication {
@Bean
public RouteLocator customRouteLocator(RouteLocatorBuilder builder) {
return builder.routes()
.route("path_route", r -> r.path("/get")
.uri("https://httpbin.org"))
.route("host_route", r -> r.host("*.myhost.org")
.uri("https://httpbin.org"))
.route("rewrite_route", r -> r.host("*.rewrite.org")
.filters(f -> f.rewritePath("/foo/(?<segment>.*)", "/${segment}"))
.uri("https://httpbin.org"))
.route("circuit_breaker_route", r -> r.host("*.circuitbreaker.org")
.filters(f -> f.circuitBreaker(c -> c.setName("slowcmd")))
.uri("https://httpbin.org"))
.route("circuit_breaker_fallback_route", r -> r.host("*.circuitbreakerfallback.org")
.filters(f -> f.circuitBreaker(c -> c.setName("slowcmd").setFallbackUri("forward:/circuitbrekerfallback")))
.uri("https://httpbin.org"))
.route("limit_route", r -> r
.host("*.limited.org").and().path("/anything/**")
.filters(f -> f.requestRateLimiter(c -> c.setRateLimiter(redisRateLimiter())))
.uri("https://httpbin.org"))
.build();
}
}
要运行您自己的网关服务器 WebFlux,请使用依赖项。spring-cloud-starter-gateway
Spring Cloud Gateway Server Web MVC 入门
import static org.springframework.cloud.gateway.server.mvc.handler.GatewayRouterFunctions.route;
import static org.springframework.cloud.gateway.server.mvc.filter.BeforeFilterFunctions.*;
import static org.springframework.cloud.gateway.server.mvc.predicate.GatewayRequestPredicates.*;
//...
@SpringBootApplication
public class DemogatewayApplication {
@Bean
public RouterFunction<ServerResponse> customRoutes() {
// @formatter:off
return route("path_route")
.GET("/get", http())
.before(uri("https://httpbin.orb"))
.build().and(route("host_route")
.route(host("*.myhost.org"), http())
.before(uri("https://httpbin.orb"))
.build().and(route("rewrite_route")
.route(host("*.rewrite.org"), http())
.before(uri("https://httpbin.orb"))
.before(rewritePath("/foo/(?<segment>.*)", "/${segment}"))
.build().and(route("circuitbreaker_route")
.route(host("*.circuitbreaker.org"), http())
.before(uri("https://httpbin.orb"))
.filter(circuitBreaker("slowcmd"))
.build().and(route("circuitbreaker_fallback_route")
.route(host("*.circuitbreakerfallback.org"), http())
.before(uri("https://httpbin.orb"))
.filter(circuitBreaker(c -> c.setId("slowcmd").setFallbackUri("forward:/fallback")))
.build().and(route("limit_route")
.route(host("*.limited.org").and(path("/anything/**")), http())
.before(uri("https://httpbin.orb"))
.filter(rateLimit(c -> c.setCapacity(10).setPeriod(Duration.ofSeconds(1)).setKeyResolver(request ->
request.headers().firstHeader("X-TokenId"))))
.build())))));
// @formatter:on
}
}
要运行您自己的网关服务器 WebMVC,请使用依赖项。spring-cloud-starter-gateway-mvc