Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Strumienie reaktywne i backpressure w Javie

Strumienie reaktywne i backpressure w Javie: Java 21 udostępnia kontrakt reactive streams przez Flow.Publisher, Subscriber, Subscription i Processor, gdzie popyt jest sterowany wywołaniem request(long).

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

Składnia

reactive streams

Java 21 udostępnia kontrakt reactive streams przez Flow.Publisher, Subscriber, Subscription i Processor, gdzie popyt jest sterowany wywołaniem request(long).

Stosuj Flow do asynchronicznego potoku z backpressure, gdy Subscriber ma kontrolować liczbę elementów w locie; SubmissionPublisher zapewnia gotowego wydawcę buforującego.

Subscriber musi zapisać Subscription w onSubscribe i żądać elementów; request(Long.MAX_VALUE) oznacza popyt nieograniczony, a blokujące onNext może zatrzymać dostarczanie.

request z wartością niedodatnią kończy subskrybenta onError z IllegalArgumentException; po pojedynczym onError lub onComplete nie wolno wysyłać dalszych sygnałów, a cancel zatrzymuje popyt.

Kolejność onSubscribe, onNext:1, onNext:2, onNext:3, onComplete pokazuje Subscriber żądający dokładnie jednego elementu po każdym sygnale i pojedyncze zakończenie.

Przykłady

import java.util.concurrent.CountDownLatch;
import java.util.concurrent.Flow;
import java.util.concurrent.SubmissionPublisher;

public class Main {
    static final class OneAtATime implements Flow.Subscriber<Integer> {
        private final CountDownLatch done;
        private Flow.Subscription subscription;

        OneAtATime(CountDownLatch done) { this.done = done; }

        @Override public void onSubscribe(Flow.Subscription subscription) {
            this.subscription = subscription;
            System.out.println("onSubscribe");
            subscription.request(1);
        }

        @Override public void onNext(Integer item) {
            System.out.println("onNext:" + item);
            subscription.request(1);
        }

        @Override public void onError(Throwable throwable) {
            System.out.println("onError:" + throwable.getClass().getSimpleName());
            done.countDown();
        }

        @Override public void onComplete() {
            System.out.println("onComplete");
            done.countDown();
        }
    }

    public static void main(String[] args) throws InterruptedException {
        var done = new CountDownLatch(1);
        var publisher = new SubmissionPublisher<Integer>(Runnable::run, 1);
        publisher.subscribe(new OneAtATime(done));
        publisher.submit(1);
        publisher.submit(2);
        publisher.submit(3);
        publisher.close();
        done.await();
    }
}

Wynik

onSubscribe
onNext:1
onNext:2
onNext:3
onComplete

Kolejność onSubscribe, onNext:1, onNext:2, onNext:3, onComplete pokazuje Subscriber żądający dokładnie jednego elementu po każdym sygnale i pojedyncze zakończenie.

Źródła