Стримы: фьючерсы в последовательности
Вспомним, как мы использовали получатель для нашего асинхронного канала ранее в этой главе
в разделе «Передача сообщений». Асинхронный
метод recv порождает последовательность элементов во времени. Это пример
гораздо более общего паттерна, известного как стрим. Многие концепции естественно
представляются как стримы: элементы, становящиеся доступными в очереди, порции данных,
которые извлекаются постепенно из файловой системы, когда полный набор данных слишком
велик для памяти компьютера, или данные, поступающие по сети со временем.
Поскольку стримы — это фьючерсы, мы можем использовать их с любым другим видом фьючерса и
комбинировать их интересными способами. Например, мы можем пакетировать события, чтобы избежать
запуска слишком большого числа сетевых вызовов, устанавливать тайм-ауты для последовательностей длительных
операций или регулировать события пользовательского интерфейса, чтобы избежать ненужной работы.
Мы видели последовательность элементов в главе 13, когда рассматривали трейт Iterator
в разделе «Трейт Iterator и метод next», но между итераторами и
асинхронным получателем канала есть два различия. Первое различие — время: итераторы
синхронны, а получатель канала асинхронен. Второе различие — API. При работе напрямую с Iterator
мы вызываем его синхронный метод next. Со стримом trpl::Receiver конкретно
мы вместо этого вызывали асинхронный метод recv. В остальном эти API ощущаются очень похожими,
и это сходство не случайно. Стрим похож на асинхронную форму
итерации. Хотя trpl::Receiver конкретно ожидает получения
сообщений, общий API стримов гораздо шире: он предоставляет
следующий элемент так же, как Iterator, но асинхронно.
Сходство между итераторами и стримами в Rust означает, что мы можем на самом деле
создать стрим из любого итератора. Как и с итератором, мы можем работать с
стримом, вызывая его метод next и затем ожидая вывод, как в листинге
17-21, который пока не будет компилироваться.
extern crate trpl; // required for mdbook test
fn main() {
trpl::block_on(async {
let values = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
let iter = values.iter().map(|n| n * 2);
let mut stream = trpl::stream_from_iter(iter);
while let Some(value) = stream.next().await {
println!("The value was: {value}");
}
});
}
Мы начинаем с массива чисел, который преобразуем в итератор, а затем
вызываем map, чтобы удвоить все значения. Затем мы преобразуем итератор в
стрим с помощью функции trpl::stream_from_iter. Затем мы перебираем в цикле
элементы стрима по мере их поступления с помощью цикла while let.
К сожалению, когда мы пытаемся запустить код, он не компилируется, а вместо этого
сообщает, что метод next недоступен:
error[E0599]: no method named `next` found for struct `tokio_stream::iter::Iter` in the current scope
--> src/main.rs:10:40
|
10 | while let Some(value) = stream.next().await {
| ^^^^
|
= help: items from traits can only be used if the trait is in scope
help: the following traits which provide `next` are implemented but not in scope; perhaps you want to import one of them
|
1 + use crate::trpl::StreamExt;
|
1 + use futures_util::stream::stream::StreamExt;
|
1 + use std::iter::Iterator;
|
1 + use std::str::pattern::Searcher;
|
help: there is a method `try_next` with a similar name
|
10 | while let Some(value) = stream.try_next().await {
| ~~~~~~~~
Как объясняет этот вывод, причина ошибки компилятора заключается в том, что нам нужен
правильный трейт в области видимости, чтобы иметь возможность использовать метод next. Учитывая наше обсуждение
до сих пор, можно разумно ожидать, что этим трейтом будет Stream, но на самом деле это
StreamExt. Сокращение от extension (расширение), Ext — это распространённый паттерн в
сообществе Rust для расширения одного трейта другим.
Трейт Stream определяет низкоуровневый интерфейс, который фактически объединяет
трейты Iterator и Future. StreamExt предоставляет набор API более высокого уровня
поверх Stream, включая метод next, а также другие служебные
методы, аналогичные тем, которые предоставляет трейт Iterator. Stream и
StreamExt ещё не являются частью стандартной библиотеки Rust, но большинство крейтов
экосистемы используют похожие определения.
Исправление ошибки компилятора — добавить инструкцию use для
trpl::StreamExt, как в листинге 17-22.
extern crate trpl; // required for mdbook test
use trpl::StreamExt;
fn main() {
trpl::block_on(async {
let values = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
// --snip--
let iter = values.iter().map(|n| n * 2);
let mut stream = trpl::stream_from_iter(iter);
while let Some(value) = stream.next().await {
println!("The value was: {value}");
}
});
}
Со всеми этими частями, собранными вместе, этот код работает так, как мы хотим! Более того,
теперь, когда StreamExt в области видимости, мы можем использовать все его служебные
методы, так же как с итераторами.