Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

util.concurrent.Flow: riferimento pratico

util.concurrent.Flow: riferimento pratico: Flow raggruppa le interfacce Publisher, Subscriber, Subscription e Processor compatibili con Reactive Streams e controllo della domanda.

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

Sintassi

java.util.concurrent.Flow

Flow raggruppa le interfacce Publisher, Subscriber, Subscription e Processor compatibili con Reactive Streams e controllo della domanda.

Usa request per backpressure esplicita, così ogni subscriber dichiara quanti elementi è pronto a ricevere.

Un Publisher deve chiamare prima onSubscribe, i segnali di una subscription devono essere ordinati e una richiesta non positiva termina con onError.

Nessun segnale segue onError o onComplete; cancel arresta la consegna al meglio e l’implementazione deve gestire domanda concorrente.

L’esempio usa l’elemento documentato in un piccolo programma deterministico e confronta l’output standard esatto.

Esempi

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() { }
        });
    }
}

Risultato

7

L’esempio usa l’elemento documentato in un piccolo programma deterministico e confronta l’output standard esatto.

Fonti