Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Flow.Publisher — objavljanje elementov z nadzorom povpraševanja

Flow.Publisher<T> opisuje vir elementov, ki jih prejemajo naročniki. Metoda subscribe poveže prejemnika z virom, Flow.Subscription pa mu omogoča zahtevati elemente in preklicati prejemanje.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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

Flow.Publisher<T> je funkcionalni vmesnik v java.util.concurrent. Flow.Publisher.subscribe ima podpis void subscribe(Flow.Subscriber<? super T> subscriber). Nadomestni tip ? super T sprejme prejemnika tipa T ali njegovega nadtipa. Sprejeti prejemnik prejme onSubscribe z objektom Flow.Subscription; argument null povzroči NullPointerException. Podvojena naročnina ali zavrnitev zaradi pravil ali napake se sporoči prek onError z IllegalStateException.

Sam klic subscribe ne ustvari povpraševanja. request(n) poveča povpraševanje za do n naslednjih elementov; pri n <= 0 se pokliče onError z IllegalArgumentException. To je uravnavanje pretoka (backpressure), ne zagotovilo, da bo dostavljenih natanko n elementov. cancel() ustavi dostavo po načelu najboljšega napora: sporočila lahko še prispejo, končni signal pa ni obvezen.

Elementi prispejo prek onNext; onComplete označuje normalen konec, onError pa napako. Po končnem signalu ni nadaljnjih klicev. Klici v okviru ene naročnine so urejeni z relacijo happens-before. Ne predpostavljajte ponovnega predvajanja prejšnjih elementov ali enotne politike njihovega zavračanja: to je odvisno od implementacije.

Primer uporablja SubmissionPublisher kot implementacijo in pokliče subscribe prek reference tipa Flow.Publisher<Integer>. Prejemnik zahteva dva elementa. Zaprtje vira sproži normalen zaključek, vendar je dostava asinhrona, zato CountDownLatch ohrani program dejaven, dokler ni obdelan končni signal. To demonstracijsko čakanje nima časovne omejitve; v operativni kodi je treba predvideti, kako ravnati, če do zaključka ne pride.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri