Spring Framwork RSocket v5.3.36 SNAPSHOT

• 语言: 英语
• 格式: .pdf
• 来源: docs.spring.io

摘要

文档详细介绍了Spring Framework对RSocket协议的支持，包括RSocketRequester、RSocketStrategies等关键组件，以及如何通过注解（如@MessageMapping和@ConnectMapping）实现请求处理和连接管理。文档还涵盖了Spring Boot对RSocket服务器的支持，包含TCP和WebSocket协议，及Spring Security、Spring Integration等模块的集成。内容还涉及数据和元数据的编解码策略配置，以及高级配置选项，如会话保持和拦截器。注解响应器支持在客户端和服务器端对消息和连接事件进行处理，并提供了路由匹配和请求响应类型的详细说明。

AI总结

《Spring Framework RSocket v5.3.36-SNAPSHOT》文档总结：

本文档介绍了Spring Framework对RSocket协议的支持，包括其核心功能、配置方式以及与Spring生态系统的整合，旨在帮助开发者高效构建实时通信应用。

### 核心内容

#### 1. RSocket协议支持
- **RSocket协议**：Spring Framework通过`io.rsocket.RSocket`契约支持RSocket协议，提供四种请求交互类型：
- Fire-and-Forget（无需响应）
- Request-Response（请求-响应）
- Request-Stream（请求-流）
- Request-Channel（双向流通信）
- **Spring模块支持**：
- **spring-messaging**：提供`RSocketRequester`（用于发送请求）和注解响应器（`@MessageMapping`和`@ConnectMapping`）。
- **spring-web**：提供编解码器（如Jackson CBOR/JSON、Protobuf）和路由匹配器（`PathPatternParser`）。
- **Spring Boot 2.2**：支持通过TCP或WebSocket启动RSocket服务器，并提供客户端构建和自动配置功能。
- **Spring Security 5.2**：提供RSocket安全支持。
- **Spring Integration 5.2**：提供RSocket入站和出站网关。
- **Spring Cloud Gateway**：支持RSocket连接。

#### 2. 配置与策略
- **RSocketStrategies**：用于配置编解码器，支持自定义序列化和反序列化逻辑，示例代码展示了如何注册编解码器。
- **客户端配置**：
- 通过`RSocketRequester.Builder`构建客户端，支持设置服务器地址和端口。
- 支持配置响应器（`@MessageMapping`和`@ConnectMapping`），以处理服务器发起的请求。
- **高级配置**：`RSocketRequesterBuilder`提供回调，用于配置底层选项（如心跳间隔、会话复制、拦截器等）。

#### 3. 服务端与客户端
- **服务端启动**：
- 通过`RSocketServer`创建服务端实例。
- 使用`RSocketMessageHandler`处理注解响应器，支持路由匹配和元数据提取。
- **服务端请求器**：服务端可通过`@ConnectMapping`和`@MessageMapping`方法获取客户端请求器，用于主动向客户端发送请求。

#### 4. 注解响应器
- **@MessageMapping**：处理单个请求，支持多种交互类型（如Request-Response、Request-Stream等）。
- **@ConnectMapping**：处理连接级别事件（如SETUP帧和METADATA_PUSH帧）。
- **注解响应器的使用**：
- 服务端需配置`RSocketMessageHandler`来检测带有`@MessageMapping`和`@ConnectMapping`的控制器。
- 支持在客户端和服务端对称使用注解响应器。

#### 5. 交互类型
- 交互类型由输入输出的基数（Cardinality）决定，包括：
- 0（无输入或无输出）：Fire-and-Forget、Request-Response。
- 1（单值输入或输出）：Request-Response。
- Many（多值流输入或输出）：Request-Stream、Request-Channel。

#### 6. 安全与路由匹配
- **安全**：RSocket支持元数据级别的安全配置，`@ConnectMapping`可用于处理连接级别的安全逻辑。
- **路由匹配**：默认使用`SimpleRouteMatcher`，推荐配置`PathPatternRouteMatcher`以提高路由匹配效率。

### 总结
Spring Framework对RSocket协议的支持为构建实时通信应用提供了强大的工具链，涵盖了客户端、服务端、安全、路由匹配等功能，并与Spring生态系统（如Spring Boot、Spring Security、Spring Integration）无缝整合，为开发者提供了一种高效、灵活的通信解决方案。