Boost.Asio 网络编程学习项目

这是一个基于 C++20 和 Boost.Asio 的网络编程学习仓库。项目旨在从零开始构建高性能的 TCP 服务器，涵盖同步阻塞模式到异步非阻塞模式的演进过程。

📺 配套视频教程: C++ 网络编程 (Bilibili)

🏗️ 项目状态 (Project Status)

开发中 (Work In Progress) 目前已完成同步服务器和基础异步服务器的实现，完成了序列化，逻辑层架构，优雅退出机制。 项目暂且搁置，等待未来有时间时继续完善多线程模型和进阶技术。代办事务

⏱️ 学习进度 (Current Progress)

• 已掌握知识点:
  • 发送队列 (std::queue) 保证异步写操作的串行化。
  • 消息节点 (MsgNode) 管理数据生命周期。
  • 解决 TCP 粘包问题 (Header + Body 协议).

  🔗 阶段总结: 第一阶段：基础网络通信 (Summaries/Phase1_Summary.md)

  • 序列化集成 Protobuf 和 JSON。
  • 逻辑层与网络层解耦设计。
  • 优雅退出机制 (信号处理)。

  🔗 阶段总结: 第二阶段：序列化与架构优化 (Summaries/Phase2_Summary.md)

🗂️ 目录结构说明 (Directory Structure)

asio-network-study
├── .github
│   └── copilot-instructions.md
├── Async
│   ├── AsyncClient
│   │   ├── AsyncClient.cpp
│   │   ├── AsyncClient.h
│   │   └── main.cpp
│   ├── v1_Simple
│   │   ├── AsyncServer.cpp
│   │   ├── Server_demo.cpp
│   │   ├── Server_demo.h
│   │   ├── Session_demo.cpp
│   │   └── Session_demo.h
│   └── v2_FullDuplex
│       ├── AsyncServer.cpp
│       ├── LogicNode.cpp
│       ├── LogicNode.h
│       ├── LogicSystem.cpp
│       ├── LogicSystem.h
│       ├── MsgNode.cpp
│       ├── MsgNode.h
│       ├── Server_demo.cpp
│       ├── Server_demo.h
│       ├── Session_demo.cpp
│       ├── Session_demo.h
│       ├── Singleton.h
│       ├── const.h
│       ├── main.cpp
│       └── 加上逻辑层的服务器结构.png
├── Summaries
│   ├── Phase1_Summary.md
│   ├── Phase2_Summary.md
│   └── ROADMAP.md
├── Sync
│   ├── SyncClient.cpp
│   ├── SyncClient学习版.cpp
│   ├── SyncServer.cpp
│   └── SyncServer学习版.cpp
└── pre_learn
    ├── Session
    │   ├── Session.cpp
    │   └── Session.h
    ├── Single_model
    │   └── Single.cpp
    └── endpoint
        ├── endpoint.cpp
        └── endpoint.h

1. Sync/ - 同步阻塞模型

• 最基础的 C/S 模型。
• 特点: 一线程一连接 (Thread-Per-Connection)。
• 适用: 低并发、简单的测试场景。

2. Async/ - 异步非阻塞模型 (核心)

• 基于 Boost.Asio 的 Proactor 模式实现。
• v1_Simple: 简单的半双工实现（存在缺陷，仅供反面教材）。
• v2_FullDuplex: 全双工、带发送队列的健壮实现（推荐参考）。
• AsyncClient: 异步客户端，支持多线程发送和接收。

3. pre_learn/ - 基础概念验证

• 包含 Endpoint、Buffer 等基础知识的小型测试代码。

💻 开发环境 (Environment)

• 系统: Windows
• 编译器: MinGW-w64 g++ (C++20)
• 依赖库: Boost (Header-only + System/Thread/Context)
• 工具: VS Code

▶️ 如何运行 (How to Run)

本项目配置了 VS Code 的 tasks.json。

1. 打开任意 .cpp 文件（如 Async/v2_FullDuplex/AsyncServer.cpp）。
2. 按下 Ctrl + Shift + B 运行构建任务。
3. 在终端运行生成的 .exe 文件。

🧠 学习重点 (Key Takeaways)

1. 内存与生命周期管理

• 智能指针: 在异步编程中，回调函数执行时对象必须存活。通过 std::shared_ptr 和 std::enable_shared_from_this (伪闭包技术)，确保 Session 对象在所有异步操作完成前不被销毁。
• RAII: 使用 MsgNode 管理发送/接收缓冲区的生命周期，避免内存泄漏和野指针。

2. 并发模型对比

• 同步 (Sync): 简单直观，但每个连接占用一个线程，资源消耗大，不适合高并发。
• 异步 (Async): 基于事件驱动 (Proactor)，单线程即可处理成千上万个连接。难点在于逻辑被回调函数割裂，需要维护上下文。

3. 网络协议设计

• 粘包与半包: TCP 是流式协议。必须设计应用层协议（如 Header + Body）来界定消息边界。
• 全双工通信: 读写分离。接收循环 (HandleRead) 和发送循环 (HandleWrite) 独立运行，互不阻塞。

4. Boost.Asio 最佳实践

• IO Context: 核心调度器。通常一个程序一个 io_context，或者使用 io_context 线程池。
• Strand: 虽然本项目暂未使用，但在多线程操作同一个 socket 时，strand 是保证线程安全的重要工具（本项目通过队列+单IO线程保证安全）。

✅ 待办事项 (To-Do List)

🟢 第一阶段：基础网络通信 (已完成)

• 同步服务器: 基础 Echo Server 实现。
• 异步服务器 (v1): 基础收发功能。
• 异步服务器 (v2):
  • 解决 TCP 粘包 (Header + Body)。
  • 发送队列 (保证 async_write 串行化)。
  • 字节序处理 (Big-Endian/Little-Endian)。
• 异步客户端: 多线程收发架构。

🟡 第二阶段：序列化与协议 (计划中)

• 序列化: 集成 Protobuf (Google Protocol Buffers)。
• 序列化: 集成 JSON (用于配置文件或简单通信)。
• 应用层协议: 简单的 HTTP 服务器实现 (Asio)。

🛑 插播学习: 在进入下一阶段前，强烈建议补充 C++ 并发编程 知识 (锁、条件变量、原子操作、内存模型)，这是理解多线程架构的基础。 📺 推荐教程: C++ 并发编程实战 (Bilibili)

🟠 第三阶段：架构设计与优化

• 逻辑层架构: 封装 LogicSystem (单例模式)，实现业务逻辑与网络层解耦。
• 优雅退出: 实现服务器的安全关闭机制 (信号处理)。
• 多线程模型:
  • IOServicePool: 多 io_context 线程池模式。
  • IOThreadPool: 单 io_context 多线程模式。

🔴 第四阶段：进阶技术 (长期目标)

• C++20 协程: 使用 Coroutines 简化异步代码 (Co_await)。
• Beast 网络库: 实现高性能 HTTP/WebSocket 服务器。
• RPC 框架: 集成 gRPC 进行微服务通信。

🔵 扩展阶段：前端交互与可视化 (Web Integration)

• Web 服务器基础: 引入 Boost.Beast 库。
• WebSocket 通信: 实现全双工实时通信。
• 前端界面: HTML/CSS/JS 可视化客户端。

🔗 详细规划请见: 项目全景路线图 (ROADMAP.md)