Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori