Rust / 系统课时

读写 TCP 连接

读写 TCP 连接

Tokio 的 TcpStream 同时提供异步读端和写端。真正需要做出的设计选择,是连接是否保持在一个任务中使用,还是拆成可独立移动的读半部和写半部并发处理;这直接决定应使用 split 还是 into_split。

学习目标

  • 使用 TcpListener、TcpStream 完成一次 TCP 连接与双向读写
  • 区分 split 返回的借用半部与 into_split 返回的拥有所有权半部
  • 在需要独立任务并发读写时正确安排所有权与连接关闭

建立连接并完成读写

服务端通过 TcpListener::accept 得到 TcpStream,客户端通过 TcpStream::connect 建立连接。TCP 本身只提供字节流,不保留“消息”边界,因此示例使用换行符作为一条消息的结束标记。

下面的程序在本机绑定临时端口,服务端收到 ping 后返回 ack:ping。示例假定 Cargo 项目已添加 Tokio 1.x,并启用 full 特性。

rust
use tokio::io::{self, AsyncBufReadExt, AsyncWriteExt, BufReader};
use tokio::net::{TcpListener, TcpStream};

#[tokio::main]
async fn main() -> io::Result<()> {
    let listener = TcpListener::bind("127.0.0.1:0").await?;
    let addr = listener.local_addr()?;

    let server = tokio::spawn(async move {
        let (mut socket, _) = listener.accept().await?;

        // split 借用同一个 TcpStream,适合在当前任务作用域内分别读写。
        let (read_half, mut write_half) = socket.split();
        let mut reader = BufReader::new(read_half);

        let mut line = String::new();
        reader.read_line(&mut line).await?;
        write_half
            .write_all(format!("ack:{line}").as_bytes())
            .await?;
        write_half.shutdown().await?;

        Ok::<(), io::Error>(())
    });

    let stream = TcpStream::connect(addr).await?;

    // into_split 产生拥有所有权的半部,可以移动到独立的 spawned task。
    let (read_half, mut write_half) = stream.into_split();

    let writer = tokio::spawn(async move {
        write_half.write_all(b"ping\n").await?;
        write_half.shutdown().await
    });

    let reader = tokio::spawn(async move {
        let mut reader = BufReader::new(read_half);
        let mut line = String::new();
        reader.read_line(&mut line).await?;
        Ok::<String, io::Error>(line)
    });

    writer.await??;
    let reply = reader.await??;
    server.await??;

    println!("client received: {}", reply.trim_end());
    Ok(())
}

预期输出

text
client received: ack:ping

绑定地址中的端口由操作系统动态分配,实际值可视为 <PORT>;示例没有打印该值,因此不会影响预期输出。

split 与 into_split 的所有权差异

split(&mut stream) 返回借用的读半部和写半部,它们的生命周期受原始 TcpStream 约束,适合同一作用域内用 join!、select! 或顺序逻辑协调。由于普通 tokio::spawn 要求任务持有可独立存活的数据,借用半部通常不能直接移动到两个独立的 spawned task 中。

into_split(stream) 会消费原始 TcpStream,返回 OwnedReadHalf 与 OwnedWriteHalf。两个半部可以分别移动到独立任务,因此更适合读循环和写循环长期并发运行,但也会承担拥有型拆分所需的共享所有权管理成本。

TcpStream 的 split 与 into_split 所有权关系

处理并发与关闭

TCP 支持全双工读写,读任务等待数据时,写任务仍可继续发送。常见服务会让一个任务持续解析输入,另一个任务从通道接收待发送消息;这种结构下,into_split 更容易满足所有权要求。

调用写半部的 shutdown().await 表示本端不再发送更多数据,但读半部仍可继续接收对端数据。若只是丢弃一个拥有型半部,另一半仍可能保持连接资源,因此连接生命周期应由协议结束条件和任务退出路径共同控制。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读写 TCP 连接

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通