KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Flow.Publisher — items publiceren met vraagsturing

Flow.Publisher<T> beschrijft een bron van items die abonnees ontvangen. De methode subscribe verbindt een ontvanger met de bron; met Flow.Subscription kan die ontvanger items aanvragen en de levering annuleren.

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

Syntax

Flow.Publisher<T>
void subscribe(Flow.Subscriber<? super T> subscriber)

Flow.Publisher<T> is een functionele interface in java.util.concurrent. Flow.Publisher.subscribe heeft de signatuur void subscribe(Flow.Subscriber<? super T> subscriber). De wildcard ? super T accepteert een ontvanger van type T of een supertype. Een geaccepteerde ontvanger krijgt onSubscribe met een Flow.Subscription-object; een null-argument veroorzaakt NullPointerException. Een dubbele inschrijving of afwijzing vanwege beleid of fouten wordt via onError met IllegalStateException gemeld.

Alleen subscribe aanroepen creëert geen vraag. request(n) voegt vraag toe voor maximaal n volgende items; bij n <= 0 wordt onError aangeroepen met IllegalArgumentException. Dit is backpressure, geen garantie dat precies n items worden geleverd. cancel() stopt de levering zo goed mogelijk: er kunnen nog berichten aankomen en een eindsignaal is niet vereist.

Items komen binnen via onNext; onComplete geeft een normale beëindiging aan en onError een fout. Na een eindsignaal volgen geen verdere aanroepen. Aanroepen binnen één inschrijving zijn geordend via de happens-before-relatie. Ga niet uit van het opnieuw afspelen van eerdere items of van een uniform beleid voor het laten vallen van items: dat hangt af van de implementatie.

Het voorbeeld gebruikt SubmissionPublisher als implementatie en roept subscribe aan via een verwijzing van het type Flow.Publisher<Integer>. De ontvanger vraagt twee items aan. Het sluiten van de bron start de normale voltooiing, maar omdat de levering asynchroon is, houdt CountDownLatch het programma actief totdat het eindsignaal is verwerkt. Deze demonstratiewacht heeft geen tijdslimiet; plan in operationele code hoe je omgaat met het uitblijven van voltooiing.

Voorbeelden

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

public class Main {
    public static void main(String[] args) throws InterruptedException {
        CountDownLatch done = new CountDownLatch(1);
        try (SubmissionPublisher<Integer> source = new SubmissionPublisher<>()) {
            Flow.Publisher<Integer> publisher = source;
            publisher.subscribe(new Flow.Subscriber<Integer>() {
                public void onSubscribe(Flow.Subscription subscription) {
                    subscription.request(2);
                }

                public void onNext(Integer item) {
                    System.out.println(item);
                }

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

                public void onComplete() {
                    System.out.println("Done");
                    done.countDown();
                }
            });
            source.submit(10);
            source.submit(20);
        }
        done.await();
    }
}

Resultaat

10
20
Done

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen