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.