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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.