CKTIS / Java
util.concurrent.SubmissionPublisher: praktyczna referencja
util.concurrent.SubmissionPublisher: praktyczna referencja: SubmissionPublisher<T> asynchronicznie dostarcza nie-null elementy bieżącym Flow.Subscriber przez niezależny bufor każdego subskrybenta.
Wersja: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Składnia
java.util.concurrent.SubmissionPublisherSubmissionPublisher asynchronicznie dostarcza nie-null elementy bieżącym Flow.Subscriber przez niezależny bufor każdego subskrybenta.
Stosuj jako prosty publisher reactive streams z jawnym Executor, pojemnością i strategią backpressure lub drop.
submit może blokować nieprzerywalnie na wolnym miejscu, a offer może odrzucić element osobno dla subskrybentów i wywołać onDrop.
Wartości lag i demand są przybliżone i nie służą do synchronizacji; close kończy przez onComplete, closeExceptionally przez onError, a null jest zabronione.
Przykład sprawdza opisywany element w małym, deterministycznym programie i porównuje dokładny standardowy wynik.
Przykłady
public class Main {
public static void main(String[] args) throws Exception {
try (var publisher = new java.util.concurrent.SubmissionPublisher<Integer>(Runnable::run, 8)) {
publisher.subscribe(new java.util.concurrent.Flow.Subscriber<>() {
public void onSubscribe(java.util.concurrent.Flow.Subscription subscription) { subscription.request(1); }
public void onNext(Integer item) { System.out.println(item); }
public void onError(Throwable error) { throw new RuntimeException(error); }
public void onComplete() {}
});
publisher.submit(7);
}
}
}
Wynik
7
Przykład sprawdza opisywany element w małym, deterministycznym programie i porównuje dokładny standardowy wynik.