База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Flow.Subscriber — получаване на елементи с контрол на търсенето

Flow.Subscriber<T> получава елементи и крайни сигнали от издател. Чрез абонамента може да заявява търсене с request(n) и така да контролира колко елемента се доставят.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

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> от java.util.concurrent е интерфейс за получател. T задава типа на елемента. Извикванията за една и съща Flow.Subscription са строго последователни; това не означава, че са обвързани с една нишка.

Flow.Subscriber.onSubscribe(Flow.Subscription subscription) получава абонамента преди останалите методи. Запазете го и поискайте елементи. Flow.Subscriber.onNext(T item) обработва един елемент. request(n) добавя търсене, вместо да заменя предишното. При активен абонамент извикване на request(n) с n <= 0 предизвиква сигнал onError с IllegalArgumentException. След отмяна на абонамента или след краен сигнал извикването на request(n) не предизвиква нов сигнал onError. Без заявено търсене елементи не се доставят. Това е управление на потока, или backpressure.

Flow.Subscriber.onError(Throwable throwable) сигнализира за непоправима грешка, а Flow.Subscriber.onComplete() — за нормално приключване. И двата сигнала са крайни: след който и да е от тях абонаментът не извиква повече методи на получателя. Не използвайте изключенията, хвърлени от методите на получателя, като протокол за грешки: интерфейсът не гарантира правилно последващо поведение. cancel() действа според най-добрите възможности: съобщения все още може да пристигат и краен сигнал не е гарантиран.

Примерът използва SubmissionPublisher и заявява следващ елемент едва след обработката на текущия. close() прекратява публикуването, но не заменя изчакването на доставката; done.join() изчаква приключването на получателя. Примерът показва нормалния път; при грешка done приключва изключително.

Примери

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();
    }
}

Резултат

item=10
item=20
complete

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници