CKTIS / Java
util.concurrent.SubmissionPublisher: praktische Referenz
util.concurrent.SubmissionPublisher: praktische Referenz: SubmissionPublisher<T> liefert Nicht-null-Elemente asynchron an aktuelle Flow.Subscriber über je einen unabhängigen Puffer.
Version: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntax
java.util.concurrent.SubmissionPublisherSubmissionPublisher liefert Nicht-null-Elemente asynchron an aktuelle Flow.Subscriber über je einen unabhängigen Puffer.
Nutze ihn als einfachen Reactive-Streams-Publisher mit explizitem Executor, Kapazität und Backpressure- oder Drop-Strategie.
submit kann ununterbrechbar auf Pufferplatz blockieren; offer kann ein Element pro Subscriber verwerfen und onDrop aufrufen.
Lag und Demand sind Schätzungen, keine Synchronisationssteuerung; close signalisiert onComplete, closeExceptionally onError und null ist verboten.
Das Beispiel prüft das dokumentierte Element in einem kleinen deterministischen Programm und vergleicht die exakte Standardausgabe.
Beispiele
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);
}
}
}
Ergebnis
7
Das Beispiel prüft das dokumentierte Element in einem kleinen deterministischen Programm und vergleicht die exakte Standardausgabe.