CKTIS / Java
Reaktivní proudy a backpressure v Javě
Reaktivní proudy a backpressure v Javě: Java 21 zpřístupňuje kontrakt reactive streams přes Flow.Publisher, Subscriber, Subscription a Processor, přičemž poptávku řídí request(long).
Verze: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntaxe
reactive streamsJava 21 zpřístupňuje kontrakt reactive streams přes Flow.Publisher, Subscriber, Subscription a Processor, přičemž poptávku řídí request(long).
Použij Flow pro asynchronní pipeline s backpressure, když každý Subscriber řídí počet rozpracovaných prvků; SubmissionPublisher poskytuje bufferovaný publisher.
Subscriber musí v onSubscribe uložit Subscription a žádat prvky; request(Long.MAX_VALUE) značí neomezenou poptávku a blokující onNext může zastavit doručování.
Nekladný request ukončí odběratele přes onError s IllegalArgumentException; po onError či onComplete nepřijdou další signály a cancel zastaví poptávku.
Pořadí onSubscribe, onNext:1, onNext:2, onNext:3, onComplete ukazuje Subscriber, který po každém signálu žádá právě jeden prvek a obdrží jediné ukončení.
Příklady
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.Flow;
import java.util.concurrent.SubmissionPublisher;
public class Main {
static final class OneAtATime implements Flow.Subscriber<Integer> {
private final CountDownLatch done;
private Flow.Subscription subscription;
OneAtATime(CountDownLatch done) { this.done = done; }
@Override public void onSubscribe(Flow.Subscription subscription) {
this.subscription = subscription;
System.out.println("onSubscribe");
subscription.request(1);
}
@Override public void onNext(Integer item) {
System.out.println("onNext:" + item);
subscription.request(1);
}
@Override public void onError(Throwable throwable) {
System.out.println("onError:" + throwable.getClass().getSimpleName());
done.countDown();
}
@Override public void onComplete() {
System.out.println("onComplete");
done.countDown();
}
}
public static void main(String[] args) throws InterruptedException {
var done = new CountDownLatch(1);
var publisher = new SubmissionPublisher<Integer>(Runnable::run, 1);
publisher.subscribe(new OneAtATime(done));
publisher.submit(1);
publisher.submit(2);
publisher.submit(3);
publisher.close();
done.await();
}
}
Výsledek
onSubscribe onNext:1 onNext:2 onNext:3 onComplete
Pořadí onSubscribe, onNext:1, onNext:2, onNext:3, onComplete ukazuje Subscriber, který po každém signálu žádá právě jeden prvek a obdrží jediné ukončení.