Iteratoraka Cursor

Bạn nghe playlist trên Spotify và chỉ bấm 'bài tiếp'. Bạn không cần biết bài hát nằm ở server nào, được tải trước bao nhiêu bài. Nút 'next' chính là iterator: giấu hết chuyện lưu trữ, chỉ đưa bạn từng bài một.You play a Spotify playlist and just hit 'next'. You don't care which server holds the songs or how many are pre-loaded. The 'next' button is an iterator: it hides storage details and hands you one song at a time.

Thành phần tham giaParticipants

Iterator

Interface duyệt: hasNext()/next() (Java) hoặc iter.Seq (Go).Traversal interface: hasNext()/next() (Java) or iter.Seq (Go).

ConcreteIterator

Biết cách đi qua một nguồn cụ thể và nhớ vị trí hiện tại (cursor).Knows how to walk a specific source and remembers the current position (cursor).

Aggregate

Tập hợp/nguồn dữ liệu (List, API phân trang, bảng DB) tạo ra iterator.The collection/source (List, paged API, DB table) that produces iterators.

Client

Dùng iterator để duyệt, không biết cấu trúc bên trong.Uses the iterator to traverse without knowing the internals.

Dùng Tự chạy hoặc phím mũi tên để đi qua từng bước gọi giữa các object. Console hiển thị output tương ứng của chương trình.Use Autoplay or the arrow keys to step through each call between objects. The console shows the matching program output.

Cùng một bài toán, hai ngôn ngữ. Rê chuột hoặc focus vào chú thích (số màu cam) để làm nổi bật dòng code tương ứng.Same problem, two languages. Hover or focus an annotation (orange number) to highlight its line.

package com.shop.sync;

import java.util.Collections;
import java.util.Iterator;
import java.util.NoSuchElementException;

// Hides cursor-based paging: callers just see one order after another
public class OrderIterator implements Iterator<Order> {1
    private final OrderApiClient api;
    private Iterator<Order> page = Collections.emptyIterator();
    private String cursor = "";        // "" = first page2
    private boolean lastPage = false;

    public OrderIterator(OrderApiClient api) {
        this.api = api;
    }

    @Override
    public boolean hasNext() {
        while (!page.hasNext() && !lastPage) {3
            OrderPage p = api.fetch(cursor, 100); // lazy: only when the buffer is empty
            page = p.items().iterator();
            cursor = p.nextCursor();
            lastPage = cursor == null;
        }
        return page.hasNext();
    }

    @Override
    public Order next() {
        if (!hasNext()) {
            throw new NoSuchElementException();4
        }
        return page.next();
    }
}

package ordersync

import (
	"context"
	"iter"
)

type Order struct {
	ID     string
	Total  int64
	Method string
}

type Page struct {
	Items      []Order
	NextCursor string // "" = no more pages
}

type Client interface {
	Fetch(ctx context.Context, cursor string, limit int) (Page, error)
}

// All returns a lazy iterator over every order, hiding the paging.
func All(ctx context.Context, c Client) iter.Seq2[Order, error] {1
	return func(yield func(Order, error) bool) {
		cursor := ""2
		for {
			page, err := c.Fetch(ctx, cursor, 100)
			if err != nil {
				yield(Order{}, err)
				return
			}
			for _, o := range page.Items {
				if !yield(o, nil) {3
					return // caller did "break": stop fetching
				}
			}
			if page.NextCursor == "" {
				return
			}
			cursor = page.NextCursor
		}
	}
}

• Collection & for-each của JavaJava collections & for-each

  Mọi List/Set/Map đều trả Iterator; vòng for (x : list) chỉ là cú pháp gọi iterator(). Sửa list khi đang duyệt sẽ gặp ConcurrentModificationException.Every List/Set/Map returns an Iterator; for (x : list) is sugar for iterator(). Modifying the list while iterating throws ConcurrentModificationException.

• Spring Data: Stream, Slice, PageSpring Data: Stream, Slice, Page

  Stream<Order> streamAllBy() (trong @Transactional readOnly) duyệt hàng triệu dòng bằng con trỏ DB mà không nạp hết vào RAM.Stream<Order> streamAllBy() (inside @Transactional readOnly) walks millions of rows via a DB cursor without loading them all into RAM.

• Iterator trong Go stdlibIterators in the Go stdlib

  maps.Keys, slices.All, strings.SplitSeq (Go 1.24) trả iter.Seq; bufio.Scanner và sql.Rows dùng kiểu cũ for rows.Next().maps.Keys, slices.All, strings.SplitSeq (Go 1.24) return iter.Seq; bufio.Scanner and sql.Rows use the older for rows.Next() style.

• Đồng bộ dữ liệu từ API đối tácSyncing data from partner APIs

  Kéo đơn từ sàn TMĐT, giao dịch từ ngân hàng, danh sách S3 object: tất cả đều phân trang bằng cursor/continuation token — iterator giấu đi chi tiết đó.Pulling marketplace orders, bank transactions, S3 object listings: all paged with cursors/continuation tokens — an iterator hides that.