Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Flow.Publisher — objavljivanje elemenata uz kontrolu potražnje

Flow.Publisher<T> opisuje izvor elemenata koje primaju pretplatnici. Metoda subscribe povezuje primatelja s izvorom, a Flow.Subscription omogućuje mu traženje elemenata i otkazivanje isporuke.

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

Sintaksa

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

Flow.Publisher<T> funkcionalno je sučelje u java.util.concurrent. Flow.Publisher.subscribe ima potpis void subscribe(Flow.Subscriber<? super T> subscriber). Zamjenski tip ? super T prihvaća primatelja tipa T ili njegova nadtipa. Prihvaćeni primatelj dobiva onSubscribe s objektom Flow.Subscription; argument null uzrokuje NullPointerException. Dvostruka pretplata ili odbijanje zbog pravila ili pogreške signalizira se putem onError s IllegalStateException.

Sam poziv metode subscribe ne stvara potražnju. request(n) povećava potražnju za najviše n sljedećih elemenata; za n <= 0 poziva se onError s IllegalArgumentException. To je kontrola protoka (backpressure), a ne jamstvo isporuke točno n elemenata. cancel() zaustavlja isporuku uz najbolji mogući napor: poruke još mogu stići, a završni signal nije obvezan.

Elementi stižu putem onNext; onComplete označava normalan završetak, a onError pogrešku. Nakon završnog signala nema daljnjih poziva. Pozivi unutar jedne pretplate uređeni su relacijom happens-before. Nemojte pretpostaviti ponovnu reprodukciju ranijih elemenata ni jedinstvenu politiku njihova odbacivanja: to ovisi o implementaciji.

Primjer koristi SubmissionPublisher kao implementaciju i poziva subscribe preko reference tipa Flow.Publisher<Integer>. Primatelj traži dva elementa. Zatvaranje izvora pokreće normalan završetak, no isporuka je asinkrona, pa CountDownLatch održava program aktivnim dok se ne obradi završni signal. Ovo demonstracijsko čekanje nema vremensko ograničenje; u operativnom kodu treba predvidjeti kako postupiti ako završetak izostane.

Primjeri

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

Rezultat

10
20
Done

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori