Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Flow.Subscription — richiesta e annullamento

Flow.Subscription controlla la consegna degli elementi tra un publisher e un subscriber. request(long n) aumenta la richiesta, mentre cancel() termina la ricezione senza garantire che la consegna si interrompa immediatamente.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

import java.util.concurrent.Flow;

Flow.Subscription subscription;
// Interface methods:
void request(long n);
void cancel();

Flow.Subscription collega un Flow.Publisher a un Flow.Subscriber. Il subscriber la riceve in onSubscribe, prima degli altri callback. Questo meccanismo di controllo del flusso (backpressure) consente al destinatario di specificare quanti elementi è pronto ad accettare; senza una richiesta, non riceve elementi tramite onNext.

Flow.Subscription.request(long n) aggiunge n alla richiesta ancora inevasa, invece di sostituirla. Se il flusso termina, possono arrivare meno elementi. Long.MAX_VALUE può indicare una richiesta praticamente illimitata. Se la sottoscrizione è attiva, una chiamata con n <= 0 segnala al subscriber un’IllegalArgumentException tramite onError, anziché far sì che request lanci l’eccezione in modo sincrono. Dopo l’annullamento della sottoscrizione, request non ha alcun effetto, nemmeno con n <= 0.

Flow.Subscription.cancel() interrompe la ricezione secondo il principio del miglior risultato possibile: possono comunque arrivare altri messaggi. Non garantisce né onComplete né onError. Entrambi i metodi sono destinati esclusivamente al subscriber associato; altri usi hanno effetti non definiti.

L’esempio usa SubmissionPublisher con l’executor Runnable::run per consegnare le attività nel thread corrente senza una corsa con la terminazione del programma. Il subscriber richiede due elementi e annulla dopo il secondo. L’output previsto è 10 e 20, ciascuno su una riga separata, senza complete. È un esempio per Java SE 21, non una certificazione di un ambiente di produzione.

Esempi

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

public class Main {
    public static void main(String[] args) {
        try (var publisher = new SubmissionPublisher<Integer>(Runnable::run, 4)) {
            publisher.subscribe(new Flow.Subscriber<Integer>() {
                private Flow.Subscription subscription;
                private int received;

                @Override
                public void onSubscribe(Flow.Subscription s) {
                    subscription = s;
                    subscription.request(2);
                }

                @Override
                public void onNext(Integer item) {
                    System.out.println(item);
                    if (++received == 2) {
                        subscription.cancel();
                    }
                }

                @Override
                public void onError(Throwable error) {
                    System.out.println(error.getClass().getSimpleName());
                }

                @Override
                public void onComplete() {
                    System.out.println("complete");
                }
            });
            publisher.submit(10);
            publisher.submit(20);
            publisher.submit(30);
        }
    }
}

Risultato

10
20

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti