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.