Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Flow.Publisher — publikování položek s řízením poptávky

Flow.Publisher<T> popisuje zdroj položek, které přijímají odběratelé. Metoda subscribe připojí příjemce ke zdroji a Flow.Subscription mu umožňuje požadovat položky a zrušit jejich doručování.

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

Syntaxe

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

Flow.Publisher<T> je funkční rozhraní v java.util.concurrent. Flow.Publisher.subscribe má signaturu void subscribe(Flow.Subscriber<? super T> subscriber). Zástupný typ ? super T přijímá příjemce typu T nebo jeho nadtypu. Přijatý příjemce obdrží onSubscribe s objektem Flow.Subscription; argument null způsobí NullPointerException. Duplicitní odběr nebo odmítnutí kvůli zásadám či chybě se signalizuje pomocí onError s IllegalStateException.

Samotné zavolání subscribe nevytváří poptávku. request(n) zvýší poptávku až o n dalších položek; při n <= 0 se zavolá onError s IllegalArgumentException. Jde o řízení toku (backpressure), nikoli o záruku doručení přesně n položek. cancel() zastaví doručování v režimu best-effort: zprávy mohou ještě dorazit a koncový signál není povinný.

Položky přicházejí prostřednictvím onNext; onComplete označuje normální ukončení a onError chybu. Po koncovém signálu už nenásledují žádná další volání. Volání v rámci jednoho odběru jsou uspořádána vztahem happens-before. Nepředpokládejte opakované přehrání dřívějších položek ani jednotnou politiku jejich zahazování: závisí na implementaci.

Příklad používá jako implementaci SubmissionPublisher a volá subscribe přes referenci typu Flow.Publisher<Integer>. Příjemce požaduje dvě položky. Zavření zdroje zahájí normální ukončení, ale doručování je asynchronní, takže CountDownLatch udrží program v chodu, dokud se nezpracuje koncový signál. Toto demonstrační čekání nemá časový limit; v provozním kódu je třeba počítat s tím, že k ukončení nemusí dojít.

Příklady

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

Výsledek

10
20
Done

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje