CKTIS / Java
util.concurrent.Flow: практическа справка
util.concurrent.Flow: практическа справка: Flow обединява съвместимите с Reactive Streams интерфейси Publisher, Subscriber, Subscription и Processor с управление на търсенето.
Версия: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Синтаксис
java.util.concurrent.FlowFlow обединява съвместимите с Reactive Streams интерфейси Publisher, Subscriber, Subscription и Processor с управление на търсенето.
Използвай request за явно обратно налягане, така че всеки абонат да заяви колко елемента може да приеме.
Publisher трябва първо да извика onSubscribe, сигналите за една Subscription трябва да са подредени, а неположителна заявка завършва с onError.
След onError или onComplete не може да има сигнали; cancel спира доставянето при най-добро усилие, а реализацията трябва безопасно да обработва конкурентно търсене.
Примерът използва документирания елемент в малка детерминистична програма и сравнява точния стандартен изход.
Примери
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() { }
});
}
}
Резултат
7
Примерът използва документирания елемент в малка детерминистична програма и сравнява точния стандартен изход.