CKTIS / Java
util.concurrent.Flow: praktische Referenz
util.concurrent.Flow: praktische Referenz: Flow bündelt Reactive-Streams-kompatible Schnittstellen Publisher, Subscriber, Subscription und Processor mit Nachfragesteuerung.
Version: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntax
java.util.concurrent.FlowFlow bündelt Reactive-Streams-kompatible Schnittstellen Publisher, Subscriber, Subscription und Processor mit Nachfragesteuerung.
Nutze request für ausdrücklichen Backpressure, damit jeder Subscriber die aufnahmebereite Elementzahl angibt.
Ein Publisher muss zuerst onSubscribe aufrufen, Signale einer Subscription müssen geordnet sein und ein nichtpositives request endet mit onError.
Nach onError oder onComplete darf kein Signal folgen; cancel stoppt Lieferung bestmöglich und Implementierungen müssen parallele Nachfrage sicher behandeln.
Das Beispiel prüft das dokumentierte Element in einem kleinen deterministischen Programm und vergleicht die exakte Standardausgabe.
Beispiele
import java.util.concurrent.Flow;
public class Main {
public static void main(String[] args) {
Flow.Publisher<Integer> publisher = subscriber -> subscriber.onSubscribe(new Flow.Subscription() {
private boolean done;
public void request(long count) {
if (done) return;
done = true;
if (count <= 0) {
subscriber.onError(new IllegalArgumentException("non-positive demand"));
return;
}
subscriber.onNext(7);
subscriber.onComplete();
}
public void cancel() {
done = true;
}
});
publisher.subscribe(new Flow.Subscriber<>() {
public void onSubscribe(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() { }
});
}
}
Ergebnis
7
Das Beispiel prüft das dokumentierte Element in einem kleinen deterministischen Programm und vergleicht die exakte Standardausgabe.