Spring WebFlux：响应式编程

已于 2024-06-09 10:40:07 修改
阅读量1.6k 收藏 16
点赞数 44
分类专栏： Spring java 微服务 文章标签： spring java WebFlux 响应式编程 WebClient
于 2024-05-14 20:47:42 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/yuanchun05/article/details/138869523
版权
微服务 同时被 3 个专栏收录
29 篇文章 1 订阅
订阅专栏
java
18 篇文章 4 订阅
订阅专栏
Spring
5 篇文章 0 订阅
订阅专栏

在软件开发领域，随着互联网应用的规模和复杂性不断增加，传统的编程模型逐渐暴露出一些局限性，尤其是在面对高并发、大规模数据流处理等场景时。为了应对这些挑战，响应式编程（Reactive Programming）应运而生，它提供了一种更为高效、灵活的编程范式，以适应不断变化的系统需求。

1.Spring WebFlux 简介

WebFlux提供了一个非阻塞、异步的Web框架，允许开发者构建高性能、可伸缩的 Web 应用程序，特别适合处理大量并发连接，如在微服务架构和云环境中。

WebFlux是Spring Framework 5引入的一个重要组件，它代表了Spring对于响应式编程（Reactive Programming）的支持。

在这里插入图片描述

1.1.异步非阻塞

异步非阻塞是一种编程模式，它允许程序在等待某个操作完成时继续执行其他任务。这种模式是基于事件循环，可以在单个线程上处理多个I/O操作，大幅提高了系统的吞吐量和伸缩性。

  • 服务器端处理: WebFlux 使用 Netty 或 Undertow 这类非阻塞服务器，它们能够处理大量连接而不阻塞线程。这意味着服务器可以在单个线程中同时处理多个请求，提高了资源利用率和吞吐量。
  • 数据库访问: 通过使用 R2DBC（ Reactive Relational Database Connectivity）或其他支持响应式编程的数据库客户端，可以在数据库查询中实现异步操作，从而避免线程等待数据库响应造成的阻塞。
  • 异步API调用: 在处理外部服务调用时，可以利用 WebClient 进行异步HTTP请求，WebClient 是完全非阻塞的，能够在等待响应的同时处理其他任务。

1.2.响应式流（Reactive Streams）

响应式流是一个规范，它定义了异步流处理的接口和行为。

1.2.1.响应式编程

响应式编程是一种编程范式，是一种异步的、事件驱动的编程范式，它特别适用于构建能够处理实时数据流的应用程序。在这种模型中，数据和事件作为流进行处理，允许开发者以声明式的方式构建复杂的异步逻辑。

Spring WebFlux 遵循这一规范，使用 Publisher 作为响应式流的源头，Subscriber 作为流的消费者。这种模型允许开发者以声明式的方式处理异步数据流，同时保持了流的控制和背压管理。

  • 数据流处理: Spring WebFlux 集成了 Reactor 库，使用 Flux 和 Mono 类型来处理数据流。Flux 表示0到N个元素的异步序列，Mono 表示0或1个元素的异步结果，两者都支持背压策略，能够智能调整数据生产速度以匹配消费者的处理能力。
  • 事件驱动编程: 应用程序可以轻松地处理各种事件，如消息队列中的消息、WebSocket连接上的事件等，通过响应式流模型，可以高效地处理这些事件而不会阻塞主线程。

1.2.2.背压管理

背压是响应式流中的一个重要概念，用于控制生产者和消费者之间的数据流速率。Project Reactor 提供了多种背压策略，帮助开发者处理数据流过载的问题。

1.2.3.Project Reactor

Project Reactor 用于创建和操作响应式流的一组丰富的API。

Project Reactor 是一个基于Java 8的响应式编程库，由Pivotal团队开发，专为配合Spring框架使用而设计。

响应式类型：Mono 和 Flux
  • Mono：代表0到1个元素的响应式类型，适合表示单个结果或无结果的异步操作。
  • Flux：代表0到N个元素的响应式类型，用于表示多个结果的异步序列。
操作符与响应式数据流

Project Reactor 提供了大量操作符，用于处理响应式流中的元素。这些操作符包括：

  • Map：将流中的每个元素应用一个函数，并发布结果。
  • Filter：根据条件过滤流中的元素。
  • FlatMap：将流中的每个元素转换为另一个流，并将结果流合并为一个流。
  • SwitchIfEmpty：如果源流为空，则切换到备选的Mono或Flux。

1.2.4.与传统Spring MVC的比较

Spring MVC是一个基于Servlet API的Web框架，它采用阻塞I/O模型，每个请求/响应对都与一个线程绑定。这在并发量较低时表现良好，但在高并发场景下，线程资源的消耗会急剧增加。

相比之下，Spring WebFlux基于响应式流，它不依赖于Servlet API，可以在如Netty、Undertow等非Servlet服务器上运行。这种模型使得WebFlux能够以非阻塞的方式处理并发请求，有效利用资源，提高性能。

在这里插入图片描述

1.3.函数式编程

函数式编程是一种编程范式 , 它强调的是将任务看作一系列可组合的函数调用。通过声明式的方式定义处理流程，让代码更简洁、易读，也更适合处理复杂的异步逻辑。WebFlux采用函数式编程范式，利用Lambda表达式简化了编程模型，路由和请求处理采用函数式编程的方式进行定义，这与传统的基于注解的控制器方法截然不同。

  • 路由与处理: WebFlux 提供了函数式编程模型，允许开发者使用 Java 8 的 Lambda 表达式来定义路由规则和处理函数，使得代码更为简洁、可读性强。例如，可以使用 RouterFunctions.route() 方法来定义路由，使用 ServerResponse 来构建响应。
  • 链式操作与组合: 利用响应式类型 Flux 和 Mono 的丰富操作符，如 map(), filter(), flatMap() 等，可以轻松地构建复杂的异步数据处理流程，而无需显式管理回调或线程。

1.3.1.请求路由

使用 RouterFunction 定义请求路由

RouterFunction 是Spring WebFlux中用于定义请求路由的函数接口。通过实现 RouterFunction，可以精确控制请求的匹配和处理。

路由谓语和处理器

  • 路由谓语：用于匹配HTTP请求的特定属性，如路径、方法、头部等。

  • 处理器：一旦路由谓语匹配成功，处理器将负责处理请求并返回响应。

1.3.2.函数式端点

Spring WebFlux 还引入了函数式端点的概念，允许开发者以简单的函数形式处理请求和生成响应，这些函数通常返回 ServerResponse。

1.3.3.函数式编程与响应式流

函数式编程是响应式编程模型的一个重要组成部分。它提倡使用无副作用的函数、不可变数据结构，并且推崇声明式编程。这些原则与响应式流的概念相契合，响应式流强调数据流的声明式处理，以及在数据流中应用各种操作符来转换、过滤和组合数据。

2.Spring WebFlux 应用搭建

2.1 环境准备

项目依赖配置

基于Maven的Springboot项目，pom.xml文件中的依赖配置可能如下所示：

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

2.2 定义路由与处理器

2.2.1.创建 RouterFunction Bean

在Spring WebFlux中，使用RouterFunction来定义请求的路由。

首先，创建一个配置类，并在其中定义路由：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.reactive.function.server.RequestPredicates;
import org.springframework.web.reactive.function.server.RouterFunction;
import org.springframework.web.reactive.function.server.ServerResponse;
import static org.springframework.web.reactive.function.server.RouterFunctions.route;

@Configuration
public class WebFluxConfig {

    @Bean
    public RouterFunction<ServerResponse> route(MyHandler handler) {
        
        return RouterFunctions.route(GET("/hello"), handler::hello);
    }
}
  • RouterFunctions.route() 是用来创建路由规则的起点。
  • GET("/hello") 是来自RequestPredicates的静态方法，定义了一个谓词，用于匹配HTTP GET方法并且路径为"/hello"的请求。
  • handler::hello 是一个方法引用，指向MyHandler类中名为hello的方法。这意味着当匹配到上述HTTP请求条件时，会调用handler.hello()方法来处理请求，并期待它返回一个ServerResponse对象作为响应。
2.2.2.使用 HandlerFunction 处理请求

创建一个处理器类，它将包含处理请求的方法。这些方法可以返回Mono<ServerResponse>或Flux<ServerResponse>，这取决于它们处理的是单个响应还是响应流：

import org.springframework.http.MediaType;
import org.springframework.stereotype.Component;
import org.springframework.web.reactive.function.server.ServerRequest;
import org.springframework.web.reactive.function.server.ServerResponse;
import reactor.core.publisher.Mono;

@Component
public class MyHandler {

    public Mono<ServerResponse> hello(ServerRequest request) {
        String name = request.queryParam("name").orElse("World");
        String message = "Hello, " + name + "!";
        return ServerResponse.ok()
                .contentType(MediaType.TEXT_PLAIN)
                .body(Mono.just(message), String.class);
    }
}

hello的方法，用于处理HTTP请求并返回一个响应。

  • Mono<ServerResponse>：返回类型是一个Mono对象，这是Reactor库中的一个类，用于表示0到1个元素的异步序列。在这里，它最终会包含一个ServerResponse对象，即HTTP响应。使用Mono是为了支持非阻塞和响应式编程。

  • ServerRequest request：输入参数，表示接收到的HTTP请求信息。

提取查询参数:

String name = request.queryParam("name").orElse("World");

这行代码从ServerRequest对象中尝试获取名为"name"的查询参数。如果请求中包含了这个参数，比如http://example.com/hello?name=John，那么name变量就会被赋值为"John"；如果没有提供，则使用默认值"World"。

构建HTTP响应的：

  • ServerResponse.ok()：创建一个表示成功（HTTP状态码200 OK）的基础响应。
  • .contentType(MediaType.TEXT_PLAIN)：设置响应的内容类型为纯文本（PLAIN TEXT）。
  • .body(Mono.just(message), String.class)：指定响应体的内容。这里使用Mono.just(message)来包装问候消息字符串，表明响应体是一个包含单个元素的异步序列，其类型为String。这确保了整个处理过程是非阻塞的。

2.3 全局异常处理

全局异常处理是任何Web应用程序的重要部分

import org.springframework.core.Ordered;
import org.springframework.core.annotation.Order;
import org.springframework.core.io.buffer.DataBuffer;
import org.springframework.http.HttpStatus;
import org.springframework.http.server.reactive.ServerHttpResponse;
import org.springframework.stereotype.Component;
import org.springframework.web.server.ServerWebExchange;
import reactor.core.publisher.Mono;

@Component
@Order(Ordered.HIGHEST_PRECEDENCE)
public class GlobalExceptionHandler {

    public Mono<Void> handleException(ServerWebExchange exchange, Throwable ex) {
        ServerHttpResponse response = exchange.getResponse();
        response.setStatusCode(HttpStatus.INTERNAL_SERVER_ERROR);
        DataBuffer buffer = response.bufferFactory().wrap("{\"error\": \"Internal Server Error\"}".getBytes());
        return response.writeWith(Mono.just(buffer));
    }
}

这段代码定义了一个全局异常处理器，用于在Spring WebFlux应用中捕获未处理的异常，并向客户端返回统一的错误响应。下面是各部分的详细说明：

@Order(Ordered.HIGHEST_PRECEDENCE)

  • @Order注解用于指定组件的执行顺序，特别是当有多个相同类型的组件（比如多个异常处理器）需要按特定顺序执行时。Ordered.HIGHEST_PRECEDENCE是一个常量，值为Integer.MIN_VALUE，意味着这个异常处理器将具有最高优先级，会在所有其他相同类型的组件之前执行。换句话说，如果有其他异常处理器也能够处理相同的异常类型，但没有指定这么高的优先级，那么这个GlobalExceptionHandler将会优先处理异常。

handleException 方法

  • 参数：

    • ServerWebExchange exchange：封装了HTTP请求和响应的所有信息，是WebFlux处理请求时的核心对象。
    • Throwable ex：抛出的异常对象，即需要被处理的异常。

  • 功能：

    1. 设置响应状态码：首先通过exchange.getResponse()获取响应对象，并将其状态码设置为HttpStatus.INTERNAL_SERVER_ERROR（HTTP 500），表示服务器遇到了未知错误。

    2. 构建响应体：使用response.bufferFactory().wrap()方法创建一个包含错误信息的DataBuffer对象。这里的消息体内容为{"error": "Internal Server Error"}，表示发生了内部服务器错误。

    3. 写入响应体并完成响应：最后，通过response.writeWith(Mono.just(buffer))将构建好的错误信息缓冲区写入响应，并返回一个Mono<Void>表示这是一个无返回值的异步操作，完成响应的发送。

3.应用细节

3.1.RouterFunction

RouterFunction 是 Spring WebFlux 提供的一种用于定义和处理 HTTP 路由的功能性接口，它是构建响应式 Web 应用的基础组件之一。与传统的基于注解（如 @GetMapping, @PostMapping 等）的控制器相比，RouterFunction 提供了一种更为灵活和强大的方式来定义路由逻辑，特别适合函数式编程风格。下面详细介绍其用法：

3.1.1. 基本概念

  • RouterFunction: 表示一个路由处理逻辑，它将HTTP请求与相应的处理逻辑关联起来。一个RouterFunction可以匹配一个请求，返回下一个RouterFunction或一个处理结果（HandlerFunction）。
  • HandlerFunction: 表示一个处理逻辑，它接受一个ServerRequest并返回一个Mono<ServerResponse>。即，它负责处理请求并产生响应。

3.1.2. 创建 RouterFunction

创建 RouterFunction 通常涉及定义路由规则和处理逻辑。以下是一个简单的示例，展示如何定义一个路由来处理 GET 请求：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.reactive.function.server.RouterFunction;
import org.springframework.web.reactive.function.server.ServerResponse;

import static org.springframework.web.reactive.function.server.RequestPredicates.GET;
import static org.springframework.web.reactive.function.server.RouterFunctions.route;
import static org.springframework.web.reactive.function.server.ServerResponse.ok;
@Configuration
public class GreetingRouter {
    @Bean
    public  RouterFunction<ServerResponse> routingFunction() {
        return route(GET("/hello2"), request -> ok().bodyValue("Hello, Spring WebFlux!"));
    }
}

这段代码定义了一个简单的RouterFunction<ServerResponse>实例，用于处理一个HTTP GET请求到/hello路径的路由逻辑。

return route(GET("/hello"), request -> ok().bodyValue("Hello, Spring WebFlux!"));

  • route是RouterFunctions类中的一个静态方法，用于创建一个基础的路由定义。它接受两个参数：

    • 谓词（Predicate）：GET("/hello")是一个谓词，用于匹配HTTP请求的方法和路径。这里匹配所有GET方法并且路径为/hello的请求。
    • 处理器函数（HandlerFunction）：request -> ok().bodyValue("Hello, Spring WebFlux!")是一个Lambda表达式，代表了处理请求的具体逻辑。它接受一个ServerRequest对象作为输入，并返回一个Mono<ServerResponse>表示响应结果。

  • request -> ...：Lambda表达式定义了如何根据请求生成响应。

  • ok()：这是ServerResponse的静态工厂方法，用于创建一个表示成功（HTTP状态码200 OK）的响应。

  • .bodyValue("Hello, Spring WebFlux!")：此方法设置了响应体的内容为给定的字符串，并且指定了内容类型（默认情况下，如果没有显式指定，会根据内容推断）。

3.1.3. 注册 RouterFunction

要在 Spring Boot 应用中注册 RouterFunction，通常在配置类中声明为 @Bean，以便 Spring 自动发现并配置：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.reactive.function.server.RouterFunction;
import org.springframework.web.reactive.function.server.RouterFunctions;
import org.springframework.web.reactive.function.server.ServerResponse;

@Configuration
public class WebConfig {

    @Bean
    public RouterFunction<ServerResponse> routes(GreetingHandler handler) {
        return RouterFunctions.route(GET("/hello"), handler::sayHello);
    }
}

其中，GreetingHandler 是一个包含业务逻辑的 HandlerFunction。

3.1.4. 组合 RouterFunction

RouterFunction 可以组合起来形成复杂的路由结构。这使得路由配置更加模块化和可维护。

  • 谓词组合：可以使用 and, or 等逻辑运算符组合谓词，以实现更复杂的路由匹配逻辑。
    @Bean
    public RouterFunction<ServerResponse> route(MyHandler handler) {
        return RouterFunctions.route(GET("/haha")
                .and(accept(MediaType.TEXT_PLAIN)), handler::haha)

                .andRoute(GET("/reactor")
                .and(accept(MediaType.APPLICATION_JSON)), handler::reactorExample);
    }

    // 处理简单的文本请求
    public Mono<ServerResponse> haha(ServerRequest request) {
        return ServerResponse.ok()
                .contentType(MediaType.TEXT_PLAIN)
                .bodyValue("haha!");
    }

    // 处理复杂的响应式请求
    public Mono<ServerResponse> reactorExample(ServerRequest request) {
        return ServerResponse.ok()
                .contentType(MediaType.APPLICATION_JSON)
                .bodyValue("{'message': 'This is a reactive response!'}");
    }

3.1.5. 处理请求参数

RouterFunction 可以方便地处理请求参数，无论是路径参数、查询参数还是请求体。例如，处理带路径参数的请求：

public RouterFunction<ServerResponse> userRoutes(UserHandler handler) {
    return route(GET("/users/{id}"), handler::getUserById);
}

3.1.6. 错误处理

Spring WebFlux 支持全局或局部的错误处理，可以通过提供一个处理特定异常类型的 RouterFunction 实现：

3.1.6.1.自带异常处理
    @Bean
    public RouterFunction<ServerResponse> route(MyHandler handler) {
        return RouterFunctions.route()
                .GET("/greeting", handler::reactorExample)
                // 全局错误处理
                .onError(Exception.class, (exception, request) -> {
                    System.out.println("An exception occurred: " + exception.getMessage());
                    return ServerResponse.status(HttpStatus.INTERNAL_SERVER_ERROR)
                            .contentType(MediaType.TEXT_PLAIN)
                            .bodyValue("Oops! Something went wrong.");
                })
     
                .build();
    }
3.1.6.2.全局异常处理
    // 错误处理路由
    private RouterFunction<ServerResponse> errorRoute() {
        return RouterFunctions.route(RequestPredicates.all(),
                request -> ServerResponse.status(HttpStatus.BAD_REQUEST)
                        .contentType(MediaType.TEXT_PLAIN)
                        .bodyValue("这是一条用于未匹配请求的回退处理。"));
    }

RequestPredicates.all()，意味着这个谓词将匹配所有的HTTP请求，无论方法（GET、POST等）或路径是什么。

3.1.7. 高级用法

  • 过滤器与拦截器：可以插入自定义的过滤器或拦截器来处理请求的预处理或后处理逻辑。
  • 条件路由：基于环境、配置或其他条件动态选择路由。

3.2.请求接参

Spring WebFlux 完全支持接收 RESTful 风格的传参。RESTful 风格的接口通常通过URL路径、查询参数、请求头以及请求体来传递参数。在Spring WebFlux中，你可以使用函数式和注解两种方式来定义端点以接收这些参数。下面是几种常见的接收参数方式：

3.2.1. 路径变量（Path Variables）

在路由定义中，你可以使用 {variableName} 来标记路径变量，然后在处理器方法中通过 @PathVariable 注解接收它们。

@Bean
public RouterFunction<ServerResponse> userRoute(UserHandler handler) {
    return RouterFunctions.route(GET("/users/{id}"), handler::getUserById);
}

@Component
public class UserHandler {

    public Mono<ServerResponse> getUserById(ServerRequest request) {
        String id = request.pathVariable("id");
        // 处理逻辑...
    }
}

3.2.2. 查询参数（Query Parameters）

查询参数可以直接从 ServerRequest 中获取，或者使用 @RequestParam 注解。

public Mono<ServerResponse> searchUsers(ServerRequest request) {
    String keyword = request.queryParam("keyword").orElse("");
    // 处理逻辑...
}

或者使用 @RequestParam：

public Mono<ServerResponse> searchUsers(@RequestParam(name = "keyword", defaultValue = "") String keyword) {
    // 处理逻辑...
}

3.2.3. 请求体（Request Body）

对于POST、PUT等方法，你可能需要从请求体中读取数据。可以使用 @RequestBody 注解，并指定相应的对象类型来自动绑定JSON或表单数据。

public Mono<ServerResponse> createUser(@RequestBody UserDTO user) {
    // 处理逻辑...
}

3.2.4. 请求头（Request Headers）

请求头可以通过 ServerRequest.headers() 获取，或者使用 @RequestHeader 注解。

public Mono<ServerResponse> handleRequestWithHeader(@RequestHeader("Authorization") String authHeader) {
    // 处理逻辑...
}

3.3.响应内容

3.3.1.ServerResponse对象

在Spring WebFlux中，响应的返回内容通常是通过ServerResponse对象来构建和管理的，它代表了即将发送给客户端的HTTP响应。

3.3.1.1. 状态码(Status Code)

每个HTTP响应都会有一个状态码，用于表示请求的处理结果。在Spring WebFlux中，你可以通过如下方式设置状态码：

  • 使用静态方法，如ServerResponse.ok()表示200 OK，ServerResponse.created()表示201 Created等。
  • 或者直接指定状态码，如ServerResponse.status(HttpStatus.NOT_FOUND)表示404 Not Found。
3.3.1.2. 响应体(Body)

响应体是响应的主要内容，可以是文本、JSON、XML等各种格式的数据。构建响应体的方式有多种：

  • 直接值：使用.bodyValue("响应内容")，适合于简单的字符串或对象直接转换为响应体。
  • 流(Stream)：.body(fromPublisher(publisher, MediaType))，当响应内容来自一个publisher（如Flux或Mono）时，这种方式非常适合处理异步数据流。
  • 对象转换：结合.body(toEntity(object))或.bodyValue(object)结合Jackson等库自动将Java对象转换为JSON等格式的响应体。
3.3.1.3. 内容类型(Content-Type)

通过.contentType(MediaType)方法指定响应的内容类型，如MediaType.APPLICATION_JSON_UTF8表示JSON格式，MediaType.TEXT_PLAIN表示纯文本等。

3.3.1.4. 头部(Headers)

可以在响应中添加自定义头部信息，如.header("X-Custom-Header", "value")。

3.3.1.5. 构建响应

一旦定义好状态码、响应体、内容类型和头部等信息，通过.build()方法完成ServerResponse的构建。这一步是必要的，它将之前设置的所有配置整合成一个待发送的响应对象。

3.3.1.6.示例

假设我们要构建一个返回JSON格式数据的响应：

import org.springframework.http.MediaType;
import org.springframework.web.reactive.function.server.ServerResponse;
import reactor.core.publisher.Mono;

public Mono<ServerResponse> getUserInfo(ServerRequest request) {
    // 假设getUserDetails()是一个Mono<User>，User是自定义的Java对象
    Mono<User> userDetails = userService.getUserDetails(request.pathVariable("id"));

    return ServerResponse.ok()
            .contentType(MediaType.APPLICATION_JSON)
            .body(userDetails, User.class) // 自动转换User对象为JSON
            .switchIfEmpty(ServerResponse.notFound().build()); // 如果找不到用户，返回404
}

在这个例子中，我们首先指定了响应的状态码为200 OK，内容类型为JSON，然后将从数据库查询到的用户详情（User对象）转换为JSON响应体。如果查询结果为空（即用户不存在），则通过.switchIfEmpty()方法切换到返回404 Not Found的响应。

3.3.2.响应式类型

在响应式编程领域，尤其是在使用Spring WebFlux和Reactor框架时，Mono和Flux是两个核心的响应式类型，它们都是Reactor库提供的对Reactive Streams规范的实现。这两种类型都实现了Publisher接口，这意味着它们可以作为异步数据流的生产者，在响应式系统中扮演着至关重要的角色。

3.3.2.1. Mono

  • 概念：Mono代表0或1个元素的异步序列。换句话说，它要么发出一个元素，要么发出一个完成信号（表示没有元素），或者发出一个错误信号。这使得它非常适合用于表示单个结果或者空结果的场景，比如数据库查询返回单行记录，或者执行一个可能会失败的操作。

  • 典型用途：数据库查询的单一结果、网络请求的响应、计算单一值的操作等。

  • 操作符：Mono提供了丰富的操作符，如map、flatMap、zip、then等，用于处理单个数据流的变换、组合和错误处理。

    1. map

    • 功能：对Mono中的元素应用一个函数进行转换。

      Mono<String> monoStr = Mono.just("Hello");
Mono<Integer> monoLength = monoStr.map(String::length);
    2. flatMap

    • 功能：将Mono中的元素转换为另一个Mono或Flux，然后扁平化这个结果流，使其成为单一流。

      Mono<User> monoUser = ...; // 假设获取用户信息
Mono<Address> monoAddress = monoUser.flatMap(user -> getAddressForUser(user.getId()));
    3. then

    • 功能：忽略Mono中的元素，仅当前Mono完成时，执行下一个Mono。

      Mono<Void> saveUser = userRepository.save(newUser);
Mono<User> findUser = saveUser.then(userRepository.findById(newUser.getId()));
    4. zipWith

    • 功能：将两个Mono的输出按照某种方式结合（通常是元组），只有当两个Mono都成功时才会触发。

      Mono<User> monoUser = ...;
Mono<Order> monoOrder = ...;
Mono<Tuple2<User, Order>> combined = monoUser.zipWith(monoOrder);
3.3.2.2. Flux

  • 概念：Flux代表0到N个元素的异步序列。它可以发出任意数量的元素，包括无限数量，直到它完成或者遇到错误。这使得Flux非常适合处理集合、事件流或者任何可能有多次数据推送的场景。

  • 典型用途：处理列表或集合的数据、实时数据流（如WebSocket消息）、数据库查询的多行结果等。

  • 操作符：Flux同样提供了丰富的操作符，如map、filter、concatMap、buffer、window等，用于处理数据流的变换、过滤、合并、窗口化等操作。

    1. map

    • 功能：对流中的每个元素应用一个函数进行转换。

      Flux<String> names = Flux.fromIterable(Arrays.asList("Alice", "Bob", "Charlie"));
Flux<Integer> lengths = names.map(String::length);
    2. filter

    • 功能：根据条件从流中筛选元素。

      Flux<String> names = ...;
Flux<String> longNames = names.filter(name -> name.length() > 5);
    3. flatMap

    • 功能：将流中的每个元素转换为一个新的流，然后将这些流合并成一个单一的流。

      Flux<User> users = ...;
Flux<Order> orders = users.flatMap(user -> getOrderListForUser(user.getId()));
    4. buffer

    • 功能：将流中的元素收集到缓冲区中，达到一定条件（如数量或时间）后作为一个列表或数组发出。

      Flux<Integer> numbers = Flux.interval(Duration.ofMillis(100)).take(10);
Flux<List<Integer>> buffered = numbers.buffer(3); // 每3个元素打包一次
    5. concatMap

    • 功能：类似于flatMap，但保证按源流的顺序依次处理每个元素产生的流。

      Flux<User> users = ...;
Flux<Order> ordersSequential = users.concatMap(user -> getOrderListForUser(user.getId()));
3.3.3.3.共同特点

  • 响应式：Mono和Flux都是非阻塞的，支持背压（Backpressure），能够在数据生产者和消费者之间自动调节数据流动的速度，防止生产过快导致消费端处理不过来的情况。

  • 链式操作：两者都支持链式调用操作符，允许以声明式的方式构建复杂的异步数据处理流程，而无需显式地管理线程或回调。

  • 异步和事件驱动：它们的设计哲学鼓励编写异步和事件驱动的代码，提高了系统的可伸缩性和资源利用率。

3.3.3.4.转换关系

Mono和Flux之间可以通过操作符互相转换，例如，Mono可以通过flatMapMany转换为Flux，而多个Mono或Flux可以通过concat、merge等操作合并。

4.WebClient

WebClient是Spring Framework 5引入的一个非阻塞、响应式的HTTP客户端，它属于Spring WebFlux模块的一部分。它设计用于构建高性能、异步的Web服务客户端，特别适合用于处理大量的并发请求和与响应式服务交互。下面是对WebClient的详细讲解：

核心特性

  1. 非阻塞：WebClient基于非阻塞IO，这意味着它在等待数据时不会占用线程，从而能够高效地处理大量并发连接，减少资源消耗。

  2. 响应式：遵循Reactor项目中的响应式编程模型，使用Mono和Flux作为返回类型，便于处理异步数据流和背压机制。

  3. 链式调用：提供了一套流畅的API，允许通过链式调用来构建HTTP请求，易于理解和维护。

  4. 配置灵活：支持多种配置选项，包括基础URL、默认头、超时设置、SSL配置等。

  5. 内容协商：自动处理内容类型和编码，支持JSON、XML等多种数据格式的序列化和反序列化。

  6. 过滤器：允许添加自定义过滤器来修改请求或响应，实现日志记录、认证、重试逻辑等。

基本使用

创建WebClient实例
// 最简单的创建方式
WebClient client = WebClient.create();

// 配置化创建
WebClient client = WebClient.builder()
        .baseUrl("http://example.com")
        .defaultHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
        .build();
发送GET请求
Mono<String> response = client.get()
        .uri("/api/data")
        .retrieve() // 获取响应体
        .bodyToMono(String.class); // 将响应体转换为String类型
发送POST请求
Mono<String> response = client.post()
        .uri("/api/data")
        .body(BodyInserters.fromObject(someObject)) // 发送对象
        .retrieve()
        .bodyToMono(String.class);
处理响应
  • 使用.block()方法会阻塞当前线程直到响应到来，这通常只在测试或者非响应式环境中使用。
  • 在响应式环境中，应该通过订阅Mono或Flux来处理响应，或者将其与其它响应式流进行组合。
错误处理

可以使用.onErrorResume等操作符来优雅地处理错误情况，例如重试逻辑或返回默认值。

Mono<String> withErrorHandling = client.get()
        .uri("/api/data")
        .retrieve()
        .onErrorResume(WebClientResponseException.class, e -> {
            // 处理错误，比如返回默认值
            return Mono.just("Default Value");
        })
        .bodyToMono(String.class);

总结

WebClient是一个强大且灵活的工具，它在现代Web应用和服务间通信中扮演着重要角色，特别是当需要构建高性能、可扩展的系统时。通过充分利用响应式编程的优势，开发者可以构建出更加高效、易维护的客户端逻辑。

春哥的魔法书
关注
  • 44
    点赞
  • 踩
  • 16
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
【微服务】spring webflux响应式编程使用详解
congge
10-18 5608
webflux使用详解
SpringBoot2.0不容错过的新特性 WebFlux响应式编程.txt
08-15
SpringMVC是同步阻塞的IO模型，资源浪费相对来说比较严重，当我们在处理一个比较耗时的任务时，例如：上传一个比较大的文件，首先，服务器的线程一直在等待接收文件，在这期间它就像个傻子一样等在那儿（放学别走），什么都干不了，好不容易等到文件来了并且接收完毕，我们又要将文件写入磁盘，在这写入的过程中，这根线程又再次懵bi了，又要等到文件写完才能去干其
Spring5 WebFlux响应式编程应用场景示例
12-25
Spring5 WebFlux 响应式编程应用场景示例
alex2chen#spring-boot-cloud-note#spring5：响应式编程-WebFlux 1
07-25
响应式宣言We want systems that are Responsive, Resilient, Elastic and Message Driven.
Spring Boot 响应式 WebFlux 笔记1
最新发布
被拯救的威尼斯的博客
04-26 919
方法，参数为 Publisher 类型，泛型为 UserAddDTO 类型，并且添加了 @RequestBody 注解，从 request 的 Body。我们使用 IDEA Maven 插件 ，查看下== spring-boot-starter-webflux ==依赖中，所引入的依赖。在响应式的编程模型中，请求是被作为一个事件丢到线程池中执行，等到执行完毕，异步回调结果给主线程，最后返回给前端。在类上，添加== @Configuration== 注解，保证该类中的 Bean 们，都被扫描到。
Spring Webflux 响应式编程 (二) - WebFlux编程实战
11-20
Spring Webflux 响应式编程 (二) - WebFlux编程实战
Spring-webflux 响应式编程
Lifelong learning
09-04 3623
2. Spring-webflux简介 3. 什么是“响应式” 4. Spring-webflux的响应式API 5. Spring MVC 还是 WebFlux？ 6. 并发模型 7. webflux使用 响应式编程
Spring Boot 2 (十)：Spring Boot 中的响应式编程和 WebFlux 入门
weixin_33923148的博客
02-14 386
Spring 5.0 中发布了重量级组件 Webflux，拉起了响应式编程的规模使用序幕。 WebFlux 使用的场景是异步非阻塞的，使用 Webflux 作为系统解决方案，在大多数场景下可以提高系统吞吐量。Spring Boot 2.0 是基于 Spring5 构建而成，因此 Spring Boot 2.X 将自动继承了 Webflux 组件，本篇给大家介绍如何在 Spring Boot 中使用...
【Spring】Webflux--响应式编程
wlc19981111的博客
05-02 87
①Java实现 package reactor; import java.util.Observable; public class ObserverDemo extends Observable{ public static void main(String[] args) { ObserverDemo observer=new ObserverDemo(); //添加观察者 observer.addObserver((o,arg)->{ System.out.printl
Spring WebFlux响应式编程
engchina的专栏
10-22 344
Spring WebFlux是随Spring 5推出的响应式Web框架。 传统的编程模型 传统的编程模型采用的是每条指令依次执行的方式，如果上一条指令没有执行完，当前的线程将先等待，无论如何提升机器性能或者优化代码，都不能改变要得到的响应结果需要等待的本质，即使是使用Java多线程编程，每个线程也是按照代码编写的先后顺序执行的。 在执行程序时，为了提高性能，处理器和编译器常常会对指令进行重排...
Spring：Webflux响应式编程
qq_43745578的博客
10-05 1687
Spring：Webflux响应式编程
Spring Webflux：响应式编程的新篇章
里查叔叔
02-23 1005
Spring Webflux是Spring 5中引入的一个新模块，用于构建响应式的Web应用程序。与传统的Spring MVC不同，Spring Webflux支持两种编程模型：基于注解的@Controller模型和基于函数式编程的模型。Spring Webflux为开发者提供了一个全新的响应式编程模型，使得处理高并发、大数据量的Web应用程序变得更加简单和高效。通过掌握Spring Webflux的核心概念和特点，开发者可以构建出更加健壮、可扩展的Web应用程序，满足不断增长的业务需求。
响应式编程实战：Spring WebFlux集成MongoDB和Swagger
天然玩家的博客
05-28 1488
响应式编程实战：Spring WebFlux+MongoDB+Swagger。
响应式编程之Spring Webflux
技术交流
02-19 4558
一 、响应式编程 响应式系统具有某些特性，使其成为低延迟、高吞吐量工作负载的理想选择。 适用场景：异步非阻塞。 比如： 一个日志监控系统，我们的前端页面将不再需要通过“命令式”的轮询的方式不断向服务器请求数据然后进行更新，而是在建立好通道之后，数据流从系统源源不断流向页面，从而展现实时的指标变化曲线； 一个社交平台，朋友的动态、点赞和留言不是手动刷出来的，而是当后台数据变化的时候自动体现到界面上的。 响应式编程（reactive programming）是一种基于数据流（data stream）和变化传递（
Spring WebFlux中的Mono和Flux：响应式编程的利器
li2530797505的博客
01-03 2234
在JDK9中开始引入了响应式编程模型，而spring5.0版本之后正式引入对webflux的支持，即spring webflux，spring webflux是spring在5.0版本后提供的一套响应式编程风格的web开发框架。使用Mono和Flux的好处是它们通过异步和非阻塞的方式处理数据流，从而提供了更好的性能和可伸缩性。在Spring WebFlux中，Mono和Flux是两个核心的类型，用于处理异步和非阻塞的操作。在上面的示例中，我们创建了一个简单的处理器类，并使用。方法或其他方式来启动应用程序。
响应式Spring的道法术器（Spring WebFlux 教程）
热门推荐
刘康的专栏
03-07 4万+
Spring WebFlux 2小时快速入门 Spring 5 之使用Spring WebFlux开发响应式应用。 lambda与函数式（15min） Reactor 3 响应式编程库（60min） Spring Webflux和Spring Data Reactive开发响应式应用（45min） 通过以上内容相信可以对Spring 5.0 推出的响应式开发有了初步的体会。如果希望有更加...
SpringBoot2.0 WebFlux响应式编程
hxt的博客
04-19 706
一、什么是WebFlux？ WebFlux是异步非阻塞的，SpringMVC是同步阻塞的 响应式一般用Netty或者Servlet 3.1的容器（因为支持异步非阻塞），而Servlet技术栈用的是Servlet容器 二、基于Spring MVC注解的方式 1、添加依赖 <dependency> <groupId>org.springframework.boo...
Spring WebFlux 教程：如何构建一个简单的响应应式 Web 应用程序
qq_37116560的博客
05-11 295
什么是反应式系统(Reactive System)？ 反应式系统是采用反应式架构模式设计的系统，该模式优先考虑使用松散耦合、灵活和可扩展的组件。它们在设计时还考虑了故障解决方案，以确保即使一个系统出现故障，大部分系统仍能运行。 反应式系统专注于： Reactiveness：最重要的考虑因素，反应性系统应该快速响应任何用户输入。响应式系统的拥护者认为，响应式有助于优化系统的所有其他部分，从数...
六、Spring5之Webflux
qq_41231318的博客
07-30 685
Spring5 框架新功能（Webflux） 1、SpringWebflux 介绍 （1）是 Spring5 添加新的模块，用于 web 开发的，功能和 SpringMVC 类似的，Webflux 使用 当前一种比较流行的响应式编程出现的框架。 （2）使用传统 web 框架，比如 SpringMVC，这些基于 Servlet 容器，Webflux 是一种异步非阻 塞的框架，异步非阻塞的框架在 Servlet3.1 以后才支持，核心是基于 Reactor （响应式编程）的相关 API 实现 的。 （3）解释
webflux的mono和flux的用法
01-14
WebFlux是Spring框架的一部分，它提供了一种响应式编程的方式来构建基于非阻塞I/O的应用程序。在WebFlux中，我们可以使用两种主要的数据类型：Mono和Flux。 1. Mono： Mono是一种包含零个或一个元素的响应式流。它类似于Java 8中的Optional，但具有更多的操作符和功能。下面是一些使用Mono的示例： ```java Mono<String> mono = Mono.just("Hello"); // 创建一个包含单个元素的Mono mono.subscribe(System.out::println); // 订阅并打印元素 Mono<Integer> emptyMono = Mono.empty(); // 创建一个空的Mono emptyMono.subscribe(System.out::println); // 不会输出任何内容 Mono<String> errorMono = Mono.error(new RuntimeException("Error")); // 创建一个包含错误的Mono errorMono.subscribe(System.out::println, Throwable::printStackTrace); // 打印错误信息 ``` 2. Flux： Flux是一种包含零个或多个元素的响应式流。它类似于Java 8中的Stream，但具有更多的操作符和功能。下面是一些使用Flux的示例： ```java Flux<String> flux = Flux.just("Hello", "World"); // 创建一个包含多个元素的Flux flux.subscribe(System.out::println); // 订阅并打印元素 Flux<Integer> emptyFlux = Flux.empty(); // 创建一个空的Flux emptyFlux.subscribe(System.out::println); // 不会输出任何内容 Flux<String> errorFlux = Flux.error(new RuntimeException("Error")); // 创建一个包含错误的Flux errorFlux.subscribe(System.out::println, Throwable::printStackTrace); // 打印错误信息 ``` 通过使用Mono和Flux，我们可以在WebFlux中处理异步和非阻塞的操作，例如处理HTTP请求和响应。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值