CKTIS / Java
util.concurrent.Flow: référence pratique
util.concurrent.Flow: référence pratique: Flow regroupe les interfaces Publisher, Subscriber, Subscription et Processor compatibles Reactive Streams avec contrôle de la demande.
Version : Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntaxe
java.util.concurrent.FlowFlow regroupe les interfaces Publisher, Subscriber, Subscription et Processor compatibles Reactive Streams avec contrôle de la demande.
Utilise request pour une contre-pression explicite où chaque abonné indique combien d’éléments il peut recevoir.
Un Publisher doit appeler onSubscribe en premier, les signaux d’une souscription doivent rester ordonnés et une demande non positive finit par onError.
Aucun signal ne suit onError ou onComplete ; cancel arrête au mieux la livraison et l’implémentation doit gérer la demande concurrente.
L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.
Exemples
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() { }
});
}
}
Résultat
7
L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.