CKTIS / Java
util.concurrent.Flow: praktická referencia
util.concurrent.Flow: praktická referencia: Flow združuje rozhrania Publisher, Subscriber, Subscription a Processor kompatibilné s Reactive Streams a riadením dopytu.
Verzia: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntax
java.util.concurrent.FlowFlow združuje rozhrania Publisher, Subscriber, Subscription a Processor kompatibilné s Reactive Streams a riadením dopytu.
Použi request na výslovný spätný tlak, aby každý odberateľ určil počet prvkov, ktoré je pripravený prijať.
Publisher musí najprv zavolať onSubscribe, signály jednej Subscription musia byť usporiadané a nekladná požiadavka končí onError.
Po onError ani onComplete nesmie prísť ďalší signál; cancel zastaví dodávanie podľa možností a implementácia musí bezpečne riešiť súbežný dopyt.
Príklad používa dokumentovaný prvok v malom deterministickom programe a porovnáva presný štandardný výstup.
Príklady
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() { }
});
}
}
Výsledok
7
Príklad používa dokumentovaný prvok v malom deterministickom programe a porovnáva presný štandardný výstup.