CKTIS / Java
Flow.Subscription — zahtjev i otkazivanje
Flow.Subscription upravlja isporukom elemenata između izdavača i pretplatnika. request(long n) povećava zahtjev, dok cancel() završava primanje bez jamstva da će isporuka odmah prestati.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
import java.util.concurrent.Flow;
Flow.Subscription subscription;
// Interface methods:
void request(long n);
void cancel();Flow.Subscription povezuje Flow.Publisher s Flow.Subscriber. Pretplatnik je prima u onSubscribe, prije ostalih povratnih poziva. Ovaj mehanizam upravljanja tokom (backpressure) omogućuje primatelju da odredi koliko je elemenata spreman prihvatiti; bez zahtjeva ne prima elemente putem onNext.
Flow.Subscription.request(long n) dodaje n neispunjenom zahtjevu umjesto da ga zamijeni. Ako tok završi, može stići manje elemenata. Long.MAX_VALUE može značiti praktički neograničen zahtjev. Ako je pretplata aktivna, pri pozivu s n <= 0 pretplatnik prima iznimku IllegalArgumentException putem onError; metoda request ne baca iznimku sinkrono. Nakon otkazivanja pretplate poziv request nema učinka, čak ni za n <= 0.
Flow.Subscription.cancel() zaustavlja primanje uz najbolji mogući trud: dodatne poruke ipak mogu stići. Ne jamči ni onComplete ni onError. Obje su metode namijenjene isključivo povezanom pretplatniku; druga uporaba ima nedefinirane učinke.
Primjer koristi SubmissionPublisher s izvršiteljem Runnable::run za isporuku zadataka u trenutačnoj dretvi, bez utrke s završetkom programa. Pretplatnik traži dva elementa i otkazuje pretplatu nakon drugoga. Očekivani izlaz je 10 i 20, svaki u zasebnom retku, bez complete. Ovo je primjer za Java SE 21, a ne potvrda produkcijskog okruženja.
Primjeri
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);
}
}
}Rezultat
10 20
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.