Gateway 入门使用

本文详细介绍如何使用Spring Boot和Spring Cloud创建API网关,包括工程搭建、依赖添加、启动类及YAML配置,实现动态路由到Eureka注册的服务。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

1、创建一个springboot工程名字gateway
2、pom.xml中添加依赖:

	<dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-gateway</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>
    </dependencies>

3、启动类配置:

@SpringBootApplication
@EnableDiscoveryClient
public class GatewayStarter {

    public static void main(String[] args) {
        SpringApplication.run(GatewayStarter.class, args);
    }

}

4、applicaiont.yml配置信息,主要配置路由:

server:
  port: 10010
eureka:
  client:
    service-url:
      defaultZone: http://127.0.0.1:10086/eureka
  instance:
    prefer-ip-address: true
spring:
  application:
    name: api-gateway
  cloud:
    gateway:
      routes:#路由配置
        - id: user-service-route
          #uri: http://127.0.0.1:9992
          uri: lb://demo-provider#动态路由
          predicates:
           - Path=/user/**


5、测试

### Spring Cloud Gateway 入门教程 #### 1. Spring Cloud Gateway 的基本概念 Spring Cloud Gateway 是基于 Spring Framework 5、Project Reactor 和 Spring Boot 2 构建的一个高性能网关框架,它提供了非阻塞式的 API 支持[^2]。作为微服务架构中的重要组成部分,它的主要功能是对 HTTP 请求进行路由转发并提供过滤能力。 #### 2. 工作原理概述 Spring Cloud Gateway 的工作流程可以分为以下几个部分: - **路由匹配**:通过预定义的路由规则来决定请求应该被发送到哪个目标服务。 - **过滤器执行**:在请求到达目标服务之前以及返回客户端之后,可以通过一系列的过滤器对请求和响应进行处理[^1]。 #### 3. 路由配置详解 路由是 Spring Cloud Gateway 中的核心概念之一,其配置通常包括以下几项: - `id`:唯一标识符用于区分不同的路由规则。 - `uri`:指定目标服务地址。 - `predicates`:一组断言函数用来判断当前请求是否满足条件。 - `filters`:应用在此路由上的过滤逻辑列表。 下面是一个简单的 YAML 配置例子展示如何设置一个基本路由: ```yaml spring: cloud: gateway: routes: - id: example_route uri: http://example.org predicates: - Path=/example/** filters: - AddRequestHeader=foo, bar ``` 上述代码片段展示了如何创建一条名为 `example_route` 的路径映射,并向所有符合条件的请求头添加键值对 `foo:bar`[^4]。 #### 4. 网关过滤器的作用与分类 网关过滤器允许开发者以特定的方式修改进入系统的 HTTP 请求或者离开系统的 HTTP 响应。按照作用范围划分,它们可分为局部过滤器(Local Filters)和全局过滤器(Global Filters)。其中前者仅应用于单一路由上而后者则影响整个应用程序内的每一个请求/回应周期。 #### 5. 自定义谓词(Predicate) 除了内置的标准外,Spring Cloud Gateway还支持用户自行扩展新的谓词类以便更灵活地控制流量行为模式[^5]。这使得我们可以针对特殊需求设计专属解决方案而不局限于现有选项集之内. --- ### 实践案例分享 假设我们需要实现这样一个场景——当访问 `/api/v1/users/{userId}` 接口时如果参数 userId 小于等于零就拒绝该次调用,则可通过如下方式完成: ```java @Bean public RouteLocator customRouteLocator(RouteLocatorBuilder builder){ return builder.routes() .route(r -> r.path("/api/v1/users/**") .and().args("userId", (arg)->Integer.parseInt(arg)<0 ) .filter((exchange, chain) -> ServerResponse.status(HttpStatus.BAD_REQUEST).build()) .uri("lb://USER-SERVICE")) .build(); } ``` 此段程序利用了复合型 Predicates 来组合多个简单条件形成复杂查询表达式的同时也引入了一个错误处理器 Filter 当检测失败时候立即中断链路并向外部反馈状态码信息。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值