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

CKTIS / Java

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

Flow.Publisher<T> описва източник на елементи, получавани от абонати. Методът subscribe свързва получател с източника, а Flow.Subscription му позволява да заявява елементи и да отменя получаването.

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

Синтаксис

Flow.Publisher<T>
void subscribe(Flow.Subscriber<? super T> subscriber)

Flow.Publisher<T> е функционален интерфейс в java.util.concurrent. Flow.Publisher.subscribe има сигнатура void subscribe(Flow.Subscriber<? super T> subscriber). Заместващият тип ? super T приема получател от тип T или негов надтип. Приетият получател получава onSubscribe с обект Flow.Subscription; аргумент null причинява NullPointerException. Повторно абониране или отказ поради политика или грешка се сигнализира чрез onError с IllegalStateException.

Самото извикване на subscribe не създава търсене. request(n) добавя търсене за до n следващи елемента; при n <= 0 се извиква onError с IllegalArgumentException. Това е контрол на потока (backpressure), а не гаранция, че ще бъдат доставени точно n елемента. cancel() спира доставянето според принципа на най-доброто усилие: съобщения все още може да пристигат, а краен сигнал не е задължителен.

Елементите пристигат чрез onNext; onComplete указва нормално приключване, а onError — грешка. След краен сигнал няма последващи извиквания. Извикванията в рамките на едно абониране са подредени чрез отношението happens-before. Не приемайте, че предишни елементи ще бъдат възпроизведени отново или че има единна политика за отпадане на елементи: това зависи от реализацията.

Примерът използва SubmissionPublisher като реализация и извиква subscribe чрез референция от тип Flow.Publisher<Integer>. Получателят заявява два елемента. Затварянето на източника започва нормалното приключване, но доставянето е асинхронно, затова CountDownLatch поддържа програмата активна, докато крайният сигнал бъде обработен. Това демонстрационно изчакване няма времево ограничение; в работещ код трябва да се предвиди как да се постъпи, ако приключване не настъпи.

Примери

import java.util.concurrent.CountDownLatch;
import java.util.concurrent.Flow;
import java.util.concurrent.SubmissionPublisher;

public class Main {
    public static void main(String[] args) throws InterruptedException {
        CountDownLatch done = new CountDownLatch(1);
        try (SubmissionPublisher<Integer> source = new SubmissionPublisher<>()) {
            Flow.Publisher<Integer> publisher = source;
            publisher.subscribe(new Flow.Subscriber<Integer>() {
                public void onSubscribe(Flow.Subscription subscription) {
                    subscription.request(2);
                }

                public void onNext(Integer item) {
                    System.out.println(item);
                }

                public void onError(Throwable error) {
                    System.out.println("Error: " + error.getClass().getSimpleName());
                    done.countDown();
                }

                public void onComplete() {
                    System.out.println("Done");
                    done.countDown();
                }
            });
            source.submit(10);
            source.submit(20);
        }
        done.await();
    }
}

Резултат

10
20
Done

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

Източници