Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

util.concurrent.Flow: praktyczna referencja

util.concurrent.Flow: praktyczna referencja: Flow grupuje zgodne z Reactive Streams interfejsy Publisher, Subscriber, Subscription i Processor z kontrolą popytu.

Wersja: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Składnia

java.util.concurrent.Flow

Flow grupuje zgodne z Reactive Streams interfejsy Publisher, Subscriber, Subscription i Processor z kontrolą popytu.

Stosuj request do jawnego backpressure, aby subskrybent określał liczbę elementów, które jest gotów przyjąć.

Publisher musi najpierw wywołać onSubscribe, sygnały dla subskrypcji muszą być uporządkowane, a request z wartością niedodatnią kończy się onError.

Po onError lub onComplete nie wolno wysyłać dalszych sygnałów; cancel zatrzymuje dostarczanie best effort, a implementacja musi obsłużyć rywalizację żądań.

Przykład sprawdza opisywany element w małym, deterministycznym programie i porównuje dokładny standardowy wynik.

Przykłady

import java.util.concurrent.Flow;

public class Main {
    public static void main(String[] args) {
        Flow.Publisher<Integer> publisher = subscriber -> subscriber.onSubscribe(new Flow.Subscription() {
            private boolean done;

            public void request(long count) {
                if (done) return;
                done = true;
                if (count <= 0) {
                    subscriber.onError(new IllegalArgumentException("non-positive demand"));
                    return;
                }
                subscriber.onNext(7);
                subscriber.onComplete();
            }

            public void cancel() {
                done = true;
            }
        });

        publisher.subscribe(new Flow.Subscriber<>() {
            public void onSubscribe(Flow.Subscription subscription) { subscription.request(1); }
            public void onNext(Integer item) { System.out.println(item); }
            public void onError(Throwable error) { throw new RuntimeException(error); }
            public void onComplete() { }
        });
    }
}

Wynik

7

Przykład sprawdza opisywany element w małym, deterministycznym programie i porównuje dokładny standardowy wynik.

Źródła