CKTIS / Java
Flow.Subscriber — primanje elemenata uz kontrolu potražnje
Flow.Subscriber<T> prima elemente i završne signale od izdavača. Pretplata omogućuje izražavanje potražnje pomoću request(n), pa primatelj može kontrolirati koliko će elemenata biti isporučeno.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
class Receiver<T> implements Flow.Subscriber<T> {
public void onSubscribe(Flow.Subscription subscription) { }
public void onNext(T item) { }
public void onError(Throwable throwable) { }
public void onComplete() { }
}Flow.Subscriber<T> iz java.util.concurrent sučelje je primatelja. T određuje vrstu elementa. Pozivi za jednu Flow.Subscription odvijaju se strogo sekvencijalno; to ne znači da su vezani uz jednu dretvu.
Flow.Subscriber.onSubscribe(Flow.Subscription subscription) prima pretplatu prije ostalih metoda. Spremite je i zatražite elemente. Flow.Subscriber.onNext(T item) obrađuje jedan element. request(n) dodaje potražnju umjesto da zamijeni prethodnu. Ako je pretplata aktivna, poziv request(n) s n <= 0 izaziva signal onError s IllegalArgumentException. Nakon otkazivanja pretplate ili nakon završnog signala poziv request(n) ne izaziva novi signal onError. Bez potražnje elementi se ne isporučuju. To je kontrola toka, odnosno backpressure.
Flow.Subscriber.onError(Throwable throwable) signalizira nepopravljivu pogrešku, dok Flow.Subscriber.onComplete() signalizira normalan završetak. Oba su signala završna: nakon bilo kojeg od njih pretplata više ne poziva metode primatelja. Iznimke izbačene iz metoda primatelja nemojte upotrebljavati kao protokol za pogreške: sučelje tada ne jamči ispravno daljnje ponašanje. cancel() djeluje uz najbolji mogući napor: poruke još mogu stići, a završni signal nije zajamčen.
Primjer upotrebljava SubmissionPublisher i traži sljedeći element tek nakon obrade trenutačnog. close() završava objavljivanje, ali ne zamjenjuje čekanje na isporuku; done.join() čeka da primatelj završi. Primjer prikazuje uobičajeni tijek; pogreška dovršava done iznimno.
Primjeri
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.Flow;
import java.util.concurrent.SubmissionPublisher;
public class Main {
static final class Receiver implements Flow.Subscriber<Integer> {
private Flow.Subscription subscription;
final CompletableFuture<Void> done = new CompletableFuture<>();
@Override
public void onSubscribe(Flow.Subscription subscription) {
this.subscription = subscription;
subscription.request(1);
}
@Override
public void onNext(Integer item) {
System.out.println("item=" + item);
subscription.request(1);
}
@Override
public void onError(Throwable throwable) {
done.completeExceptionally(throwable);
}
@Override
public void onComplete() {
System.out.println("complete");
done.complete(null);
}
}
public static void main(String[] args) {
Receiver receiver = new Receiver();
try (SubmissionPublisher<Integer> publisher = new SubmissionPublisher<>()) {
publisher.subscribe(receiver);
publisher.submit(10);
publisher.submit(20);
}
receiver.done.join();
}
}Rezultat
item=10 item=20 complete
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.