CKTIS / Java
util.concurrent.Flow: praktische referentie
util.concurrent.Flow: praktische referentie: Flow groepeert Reactive Streams-compatibele Publisher-, Subscriber-, Subscription- en Processor-interfaces met vraagsturing.
Versie: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntax
java.util.concurrent.FlowFlow groepeert Reactive Streams-compatibele Publisher-, Subscriber-, Subscription- en Processor-interfaces met vraagsturing.
Gebruik request voor expliciete tegendruk zodat elke abonnee aangeeft hoeveel elementen hij kan ontvangen.
Een Publisher moet eerst onSubscribe aanroepen, signalen per abonnement moeten geordend zijn en een niet-positief verzoek eindigt met onError.
Na onError of onComplete mag geen signaal volgen; cancel stopt levering naar beste vermogen en de implementatie moet gelijktijdige vraag veilig afhandelen.
Het voorbeeld gebruikt het gedocumenteerde element in een klein deterministisch programma en vergelijkt de exacte standaarduitvoer.
Voorbeelden
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() { }
});
}
}
Resultaat
7
Het voorbeeld gebruikt het gedocumenteerde element in een klein deterministisch programma en vergelijkt de exacte standaarduitvoer.