CKTIS / Java
util.concurrent.Flow: praktični priročnik
util.concurrent.Flow: praktični priročnik: Flow združuje vmesnike Publisher, Subscriber, Subscription in Processor, združljive z Reactive Streams, z nadzorom povpraševanja.
Različica: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Sintaksa
java.util.concurrent.FlowFlow združuje vmesnike Publisher, Subscriber, Subscription in Processor, združljive z Reactive Streams, z nadzorom povpraševanja.
request uporabi za izrecni povratni pritisk, da vsak naročnik pove, koliko elementov je pripravljen sprejeti.
Publisher mora najprej poklicati onSubscribe, signali ene Subscription morajo biti urejeni, nepozitivna zahteva pa konča z onError.
Po onError ali onComplete ne sme biti signalov; cancel ustavi dostavo po najboljših močeh, izvedba pa mora varno obravnavati sočasno povpraševanje.
Primer uporabi dokumentirani element v majhnem determinističnem programu in primerja natančen standardni izhod.
Primeri
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() { }
});
}
}
Rezultat
7
Primer uporabi dokumentirani element v majhnem determinističnem programu in primerja natančen standardni izhod.