CKTIS / Java
Flow.Subscription — zapotrzebowanie i anulowanie
Flow.Subscription steruje odbiorem elementów między wydawcą a subskrybentem. request(long n) zwiększa zapotrzebowanie, a cancel() służy do zakończenia odbioru bez gwarancji natychmiastowego zatrzymania.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
import java.util.concurrent.Flow;
Flow.Subscription subscription;
// Interface methods:
void request(long n);
void cancel();Flow.Subscription łączy Flow.Publisher z Flow.Subscriber. Subskrybent otrzymuje ją w onSubscribe, przed pozostałymi wywołaniami zwrotnymi. Ten mechanizm kontroli przepływu (backpressure) pozwala odbiorcy określić, ile elementów jest gotowy przyjąć; bez żądania nie otrzyma elementów przez onNext.
Flow.Subscription.request(long n) dodaje n do niezrealizowanego zapotrzebowania, zamiast je zastępować. Dostaw może być mniej, jeśli strumień się zakończy. Long.MAX_VALUE może oznaczać praktycznie nieograniczone zapotrzebowanie. Jeśli subskrypcja jest aktywna, dla n <= 0 subskrybent otrzymuje onError z IllegalArgumentException, zamiast synchronicznego zgłoszenia tego wyjątku przez metodę. Po anulowaniu subskrypcji request nie wywołuje żadnego skutku, nawet dla n <= 0.
Flow.Subscription.cancel() zatrzymuje odbiór na zasadzie best-effort: kolejne komunikaty mogą jeszcze dotrzeć. Nie gwarantuje onComplete ani onError. Obie metody są przeznaczone wyłącznie dla powiązanego subskrybenta; inne użycia mają niezdefiniowane skutki.
Przykład używa SubmissionPublisher z wykonawcą Runnable::run, aby dostarczać zadania w bieżącym wątku bez wyścigu z zakończeniem programu. Subskrybent żąda dwóch elementów i anuluje subskrypcję po drugim. Oczekiwany wynik to 10 i 20, każde w osobnym wierszu, bez complete. To przykład dla Java SE 21, nie potwierdzenie środowiska produkcyjnego.
Przykłady
import java.util.concurrent.Flow;
import java.util.concurrent.SubmissionPublisher;
public class Main {
public static void main(String[] args) {
try (var publisher = new SubmissionPublisher<Integer>(Runnable::run, 4)) {
publisher.subscribe(new Flow.Subscriber<Integer>() {
private Flow.Subscription subscription;
private int received;
@Override
public void onSubscribe(Flow.Subscription s) {
subscription = s;
subscription.request(2);
}
@Override
public void onNext(Integer item) {
System.out.println(item);
if (++received == 2) {
subscription.cancel();
}
}
@Override
public void onError(Throwable error) {
System.out.println(error.getClass().getSimpleName());
}
@Override
public void onComplete() {
System.out.println("complete");
}
});
publisher.submit(10);
publisher.submit(20);
publisher.submit(30);
}
}
}Wynik
10 20
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.