• Stars
    star
    251
  • Rank 161,862 (Top 4 %)
  • Language
    Rust
  • License
    MIT License
  • Created about 4 years ago
  • Updated 8 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Rust, Tokio, CN, Doc, Demo

Tokio 中文文档

1.说明

Tokio 它是Rust语言的一种异步运行时 可以用来编写可靠,异步的Rust应用. 它有以下几个特点:

  • 快速: Tokio是零成本抽象的,可以带给你接近裸机的性能.
  • 可靠的: Tokio基于Rust语言的生命周期,类型系统,并发模型来减少bug和确保线程安全.
  • 可扩展: Tokio有非常小的占用,并能处理背压(backpressure)和取消(cancellation)操作.

Tokio是一个事件驱动的非阻塞I/O平台,用于使用Rust编写异步应用. 在较高的层次上,它提供了几个主要的组件:

  • 基于多线程与工作流窃取的 任务调度器 scheduler.
  • 响应式的,基于操作系统的事件队列(比如,epoll, kqueue, IOCP, 等...).
  • 异步的TCP and UDP socket.

这些组件提供了用来构建异步应用所需要的运行时组件.

官方原文指南.

bin 目录下有一些可以参考的,基于官方文档的示例代码.

我的其它翻译:Actix-web 3.0 中文文档.

2.中文文档索引

指南

介绍(Introduction)

你好 Tokio (Hello Tokio)

Spawning

共享状态(Shared state)

通道(Channels)

I/O

帧(Framing)

深入异步(Async in depth)

Select

流(Streams)

主题(Topics)

使用同步代码桥接(Bridging with sync code)

优雅关机(Graceful Shutdown)

词汇表(Glossary)

API文档(API documentation)

3.其它

Tokio是一个非常值得学习的,Rust生态中的网络库. 有些类似 "Rust界的Netty" 的感觉,很多上层库,或包,或框架都是基于它(比如 Actix-web). 因此作为一名 Rustaceans 学习与使用,或理解Tokio意义重大. 此中文文档是本人在学习Tokio后的 "果实" . 我顺便整理了出来.

由于水平有限,不敢妄言翻译的有多好,其中难免会有错误和遗漏,如果发现烦请一并指正. 望此文档能给同样对Tokio感兴趣的人的学习带来一点帮助.