Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

สตรีม: ฟิวเจอร์ที่เรียงต่อกันเป็นลำดับ

ย้อนนึกถึงวิธีที่เราใช้ตัวรับของแชนเนลแบบ async ไปก่อนหน้านี้ในบทนี้ที่หัวข้อ“การส่งผ่านข้อความ” เมธอด recv แบบ async จะให้ลำดับของรายการข้อมูลออกมาตามช่วงเวลา ซึ่งนี่เป็นตัวอย่างหนึ่งของรูปแบบการทำงานที่กว้างกว่ามากที่เรียกว่า_สตรีม_ (stream) แนวคิดหลายอย่างสามารถแสดงออกมาในรูปของสตรีมได้อย่างเป็นธรรมชาติ เช่น ข้อมูลที่ทยอยพร้อมใช้งานในคิว, ชิ้นส่วนข้อมูลที่ค่อยๆ ถูกดึงมาจากระบบไฟล์เมื่อชุดข้อมูลทั้งหมดมีขนาดใหญ่เกินกว่าจะเก็บไว้ในหน่วยความจำของคอมพิวเตอร์ได้ทั้งหมด, หรือข้อมูลที่ทยอยส่งมาผ่านเครือข่ายตามลำดับเวลา และเนื่องจากสตรีมก็คือฟิวเจอร์ชนิดหนึ่ง เราจึงสามารถใช้สตรีมร่วมกับฟิวเจอร์ชนิดอื่นๆ และนำมารวมเข้าด้วยกันในวิธีที่น่าสนใจได้ ตัวอย่างเช่น เราสามารถรวมอีเวนต์เป็นชุด (batch) เพื่อหลีกเลี่ยงการส่งคำขอผ่านเครือข่ายบ่อยเกินไป, ตั้งไทม์เอาต์ให้กับลำดับของการทำงานที่ใช้เวลานาน, หรือจำกัดอัตราการเกิดอีเวนต์บนหน้าจอผู้ใช้ (throttle) เพื่อหลีกเลี่ยงการประมวลผลที่ไม่จำเป็น

เราเคยเห็นลำดับของข้อมูลกันไปแล้วในบทที่ 13 เมื่อเราศึกษาเทรต Iterator ในหัวข้อ“เทรต Iterator และเมธอด next” แต่มีความแตกต่างอยู่สองประการระหว่างอิเทอเรเตอร์ (iterator) กับตัวรับของแชนเนลแบบ async ประการแรกคือเรื่องของเวลา: อิเทอเรเตอร์เป็นแบบซิงโครนัส ในขณะที่ตัวรับของแชนเนลเป็นแบบอะซิงโครนัส ประการที่สองคือ API: เมื่อทำงานกับ Iterator โดยตรง เราจะเรียกเมธอด next แบบซิงโครนัสของมัน แต่สำหรับสตรีมของ trpl::Receiver เราเรียกเมธอด recv ซึ่งเป็นแบบอะซิงโครนัสแทน นอกเหนือจากนั้นแล้ว API ทั้งสองแบบให้ความรู้สึกที่คล้ายกันมาก และความคล้ายคลึงนั้นก็ไม่ใช่เรื่องบังเอิญ สตรีมเปรียบเสมือนรูปแบบอะซิงโครนัสของการวนซ้ำ (iteration) อย่างไรก็ตาม ในขณะที่ trpl::Receiver เจาะจงเฉพาะการรอรับข้อความ แต่ API ของสตรีมสำหรับใช้งานทั่วไปนั้นครอบคลุมกว้างกว่ามาก: มันจะจัดเตรียมข้อมูลตัวถัดไปเหมือนกับที่ Iterator ทำ แต่ทำในแบบอะซิงโครนัส

ความคล้ายคลึงกันระหว่างอิเทอเรเตอร์กับสตรีมใน Rust ทำให้เราสามารถสร้างสตรีมขึ้นมาจากอิเทอเรเตอร์ใดๆ ก็ได้ เช่นเดียวกับอิเทอเรเตอร์ เราสามารถทำงานกับสตรีมได้โดยการเรียกเมธอด next ของมันแล้ว await เพื่อรอรับเอาต์พุต ดังแสดงในลิสติ้ง 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 {
   |                                        ~~~~~~~~

ดังที่เอาต์พุตนี้ได้อธิบายไว้ สาเหตุของข้อผิดพลาดจากคอมไพเลอร์ก็คือ เราจำเป็นต้องมีเทรตที่ถูกต้องอยู่ในสโคป (scope) เพื่อให้สามารถใช้เมธอด next ได้ จากสิ่งที่เราพูดคุยกันมา คุณอาจคาดหวังว่าเทรตดังกล่าวน่าจะเป็น Stream แต่ในความเป็นจริงแล้วมันคือ StreamExt คำว่า Ext นั้นย่อมาจาก extension (ส่วนขยาย) ซึ่งเป็นแพตเทิร์นที่พบได้ทั่วไปในชุมชน 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 อยู่ในสโคปแล้ว เราก็สามารถใช้เมธอดอรรถประโยชน์ทั้งหมดของมันได้ เช่นเดียวกับที่เราทำกับอิเทอเรเตอร์