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.