Spring Boot 集成 Spring WebFlux：响应式编程入门与实践指南

在 Spring Boot 项目中集成 Spring WebFlux 是一个相对简单的过程，以下是详细的步骤和要点：

1. 添加依赖

在项目的 pom.xml 文件中，添加 Spring WebFlux 的依赖项：

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

此依赖会引入 WebFlux 的核心功能，包括反应式编程的支持。

2. 创建响应式控制器

创建一个响应式控制器，使用 Flux 和 Mono 来处理异步数据流。例如：

@RestController
@RequestMapping("/users")
public class UserController {

    private final UserService userService;

    @Autowired
    public UserController(UserService userService) {
        this.userService = userService;
    }

    @GetMapping
    public Flux<User> getAllUsers() {
        return userService.getAllUsers();
    }

    @GetMapping("/{id}")
    public Mono<User> getUserById(@PathVariable String id) {
        return userService.getUserById(id);
    }
}

这里，Flux 用于表示多个数据的流，而 Mono 用于表示单个数据。

3. 实现响应式服务层

在服务层中，使用 Flux 和 Mono 来处理数据流。例如：

@Service
public class UserService {

    public Flux<User> getAllUsers() {
        // 返回用户列表的 Flux 流
        return Flux.just(new User("1", "Alice"), new User("2", "Bob"));
    }

    public Mono<User> getUserById(String id) {
        // 根据 ID 返回单个用户的 Mono 流
        return Mono.just(new User(id, "Alice"));
    }
}

服务层可以结合响应式数据库（如 R2DBC）来实现更高效的数据访问。

4. 配置 WebFlux

如果需要自定义 WebFlux 的行为，可以通过配置类进行扩展。例如：

@Configuration
public class WebFluxConfig implements WebFluxConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**").allowedOrigins("*");
    }
}

这可以用于配置跨域支持等。

5. 使用 WebClient 进行异步 HTTP 调用

在需要与其他服务通信时，可以使用 WebClient，它是一个响应式的 HTTP 客户端：

@Bean
public WebClient webClient() {
    return WebClient.builder().build();
}

然后在服务中使用：

public Mono<User> fetchUser(String id) {
    return webClient.get()
                    .uri("https://api.example.com/users/{id}", id)
                    .retrieve()
                    .bodyToMono(User.class);
}

WebClient 提供了非阻塞的 HTTP 调用能力。

6. 注意事项

• WebFlux 默认使用 Netty 作为服务器，也可以切换到其他支持非阻塞的服务器，如 Undertow。

• 如果需要与 Spring MVC 共存，可以在同一个项目中同时使用 spring-boot-starter-web 和 spring-boot-starter-webflux。

• 在处理响应式数据流时，注意使用合适的操作符（如 map、filter）来优化数据处理。