学习 Rust Futures - Concrete  and Combinators 

在前面我们简单的介绍了一些 Futures 的基本知识的例子中,我们出现了 combinator 的概念,也就是 and_then 这些。Combinator 能将多个 Future 串联组合起来,依次执行调动,最终得到结果。

在 futures 库里面,已经提供了一些基本的 Future,后面,我们会结合这些 concrete 的 Future,来具体说明一下 combinator。

Leaf Future

在 futures 里面,有一种 leaf future ,也就是 FutureResult,它只要调用 poll 就能够及时的返回值,不需要额外的等待。后续很多的例子我们都会通过这种 leaf future 来完成。

使用 leaf future 也是非常简单的,我们可以通过 ok, err 以及 result 来完成:

 let f = ok::<u32, u32>(1);
 assert_eq!(f.wait().unwrap(), 1);
 
 let f = err::<u32, u32>(2);
 assert_eq!(f.wait().unwrap_err(), 2);
 
 let f = result::<u32, u32>(Ok(3));
 assert_eq!(f.wait().unwrap(), 3);
 
 let f = result::<u32, u32>(Err(4));
 assert_eq!(f.wait().unwrap_err(), 4);

Empty Future

不同于上面的 leaf future,我们还可以创建一种 empty future,它在任何 poll 的时候,都会返回 NotReady

 let mut f1 = empty::<u32, u32>();
 assert_eq!(f1.poll(), Ok(Async::NotReady));

Map / MapErr Future

我们可以使用 map 或者 map_err 将一个 Future 转为另一个 Future,譬如:

 let f = ok::<u32, u32>(1);
 let f2 = f.map(|x| x + 1);
 assert_eq!(f2.wait().unwrap(), 2);
 
 let f = err::<u32, u32>(2);
 let f2 = f.map_err(|x| x + 2);
 assert_eq!(f2.wait().unwrap_err(), 4);

Then / AndThen / OrElse Future

我们也可以使用 then / and_then / or_else 来将当前 Future 完成的值传递给下一个 Future 处理:

 let f = ok::<u32, u32>(1);
 let f2 = f.then(|x| x.map(|y| y + 1));
 assert_eq!(f2.wait().unwrap(), 2);
 
 let f = err::<u32, u32>(2);
 let f2 = f.then(|x| x.map_err(|y| y + 2));
 assert_eq!(f2.wait().unwrap_err(), 4);
 
 let f = ok::<u32, u32>(1);
 let f2 = f.and_then(|x| Ok(x + 1));
 assert_eq!(f2.wait().unwrap(), 2);
 
 let f = err::<u32, u32>(2);
 let f2 = f.or_else(|x| Err(x + 2));
 assert_eq!(f2.wait().unwrap_err(), 4);

Select / Join Future

我们可以使用 select / join 来等待一个或者所有 Future 完成:

 let f1 = ok::<u32, u32>(1);
 let f2 = ok::<u32, u32>(2);
 
 let _ = f1.select(f2).map(|(x, y)| {
     assert_eq!(x, 1);
     assert_eq!(y.wait().unwrap(), 2);
 });
 
 let f1 = ok::<u32, u32>(1);
 let f2 = ok::<u32, u32>(2);
 let _ = f1.join(f2).map(|(x, y)| {
     assert_eq!(x, 1);
     assert_eq!(y, 2);
 });

Flatten Future

也可以使用 flatten 来得到最后一个 Future 的值:

 let f1 = ok::<u32, u32>(1);
 let f2 = ok::<_, u32>(f1);
 assert_eq!(f2.flatten().wait().unwrap(), 1);

Fuse Future

通常一个 Future 完成之后,再次去 poll 会 panic 出错,为了防止这样的情况出现,我们可以使用 fuse,这样当 Future 已经完成之后,后面任何 poll 都会返回 NotReady

 let mut f1 = ok::<u32, u32>(1);
 assert_eq!(f1.poll(), Ok(Async::Ready(1)));
 
 let mut f1 = ok::<u32, u32>(1).fuse();
 assert_eq!(f1.poll(), Ok(Async::Ready(1)));
 assert_eq!(f1.poll(), Ok(Async::NotReady));

Channel

futures 现在提供两种 channel,one-shot 以及 MPSC。one-shot 主要用于两个线程之间交互的情况,而 MPSC 则是可以多个线程发送数据,一个线程接受处理。

一个 one-shot 的简单例子:

 let (tx, rx) = oneshot::channel::<u32>();
 
 thread::spawn(move || {
     tx.complete(1);
 });
 
 rx.map(|x| {
         assert_eq!(x, 1);
     })
     .wait()
     .unwrap();

一个 MPSC 的简单例子:

 let (tx, rx) = mpsc::channel::<u32>(1);
 
 let tx1 = tx.clone();
 thread::spawn(move || {
     tx1.send(1).wait().unwrap();
 });
 
 let tx2 = tx.clone();
 thread::spawn(move || {
     tx2.send(2).wait().unwrap();
 });
 
 drop(tx);
 
 let mut w = rx.wait();
 assert_eq!(w.next().unwrap(), Ok(1));
 assert_eq!(w.next().unwrap(), Ok(2));
 assert!(w.next().is_none());

小结

这里,我们简单介绍了 futures 库提供的一些基本 future,combinator,以及他们的使用方法。 可以看到,使用都是非常简单的。这里,我们并没有详细的说明 Stream,但也没有特别大的差别。另外,futures 库还有一个关键的 task 概念,这个我们后续在说明。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 156,265评论 4 359
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,274评论 1 288
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 106,087评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,479评论 0 203
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,782评论 3 285
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,218评论 1 207
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,594评论 2 309
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,316评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,955评论 1 237
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,274评论 2 240
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,803评论 1 255
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,177评论 2 250
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,732评论 3 229
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,953评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,687评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,263评论 2 267
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,189评论 2 258

推荐阅读更多精彩内容