Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Flow.Publisher — publikovanie položiek s riadením dopytu

Flow.Publisher<T> opisuje zdroj položiek, ktoré prijímajú odberatelia. Metóda subscribe pripojí prijímateľa k zdroju a Flow.Subscription mu umožňuje požadovať položky a zrušiť ich doručovanie.

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

Syntax

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

Flow.Publisher<T> je funkčné rozhranie v java.util.concurrent. Flow.Publisher.subscribe má signatúru void subscribe(Flow.Subscriber<? super T> subscriber). Zástupný typ ? super T prijíma prijímateľa typu T alebo jeho nadtypu. Prijatý prijímateľ dostane onSubscribe s objektom Flow.Subscription; argument null spôsobí NullPointerException. Duplicitný odber alebo odmietnutie z dôvodu pravidiel či chyby sa signalizuje cez onError s IllegalStateException.

Samotné zavolanie subscribe nevytvára dopyt. request(n) zvýši dopyt až o n ďalších položiek; pri n <= 0 sa zavolá onError s IllegalArgumentException. Ide o riadenie toku (backpressure), nie o záruku doručenia presne n položiek. cancel() zastaví doručovanie v režime best-effort: správy môžu ešte prísť a koncový signál nie je povinný.

Položky prichádzajú cez onNext; onComplete označuje normálne ukončenie a onError chybu. Po koncovom signáli už nenasledujú ďalšie volania. Volania v rámci jedného odberu sú usporiadané vzťahom happens-before. Nepredpokladajte opätovné prehratie predchádzajúcich položiek ani jednotnú politiku ich zahadzovania: závisia od implementácie.

Príklad používa ako implementáciu SubmissionPublisher a volá subscribe cez referenciu typu Flow.Publisher<Integer>. Prijímateľ požaduje dve položky. Zatvorenie zdroja spustí normálne ukončenie, ale doručovanie je asynchrónne, preto CountDownLatch udržiava program v chode, kým sa nespracuje koncový signál. Toto demonštračné čakanie nemá časový limit; v prevádzkovom kóde treba počítať s tým, že ukončenie nemusí nastať.

Prí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ýsledok

10
20
Done

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje