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

CKTIS / Java

Flow.Subscription — заявка и отказване

Flow.Subscription управлява доставянето на елементи между издател и абонат. request(long n) увеличава заявката, а cancel() прекратява получаването, без да гарантира незабавно спиране на доставянето.

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

Синтаксис

import java.util.concurrent.Flow;

Flow.Subscription subscription;
// Interface methods:
void request(long n);
void cancel();

Flow.Subscription свързва Flow.Publisher с Flow.Subscriber. Абонатът я получава в onSubscribe преди останалите обратни извиквания. Този механизъм за управление на потока (backpressure) позволява на получателя да зададе колко елемента е готов да приеме; без заявка той не получава елементи чрез onNext.

Flow.Subscription.request(long n) добавя n към неизпълнената заявка, вместо да я заменя. Ако потокът приключи, може да пристигнат по-малко елементи. Long.MAX_VALUE може да означава практически неограничена заявка. Ако абонаментът е активен, при n <= 0 абонатът получава IllegalArgumentException чрез onError, а request не хвърля изключението синхронно. След отказване от абонамента извикването на request няма ефект дори при n <= 0.

Flow.Subscription.cancel() спира получаването доколкото е възможно: все пак може да пристигнат още съобщения. Не гарантира нито onComplete, нито onError. Двата метода са предназначени само за съответния абонат; всяка друга употреба има неопределени последици.

Примерът използва SubmissionPublisher с изпълнителя Runnable::run, за да доставя задачите в текущата нишка, без състезание с приключването на програмата. Абонатът заявява два елемента и се отказва след втория. Очакваният изход е 10 и 20, всеки на отделен ред, без complete. Това е пример за Java SE 21, а не удостоверение за производствена среда.

Примери

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

public class Main {
    public static void main(String[] args) {
        try (var publisher = new SubmissionPublisher<Integer>(Runnable::run, 4)) {
            publisher.subscribe(new Flow.Subscriber<Integer>() {
                private Flow.Subscription subscription;
                private int received;

                @Override
                public void onSubscribe(Flow.Subscription s) {
                    subscription = s;
                    subscription.request(2);
                }

                @Override
                public void onNext(Integer item) {
                    System.out.println(item);
                    if (++received == 2) {
                        subscription.cancel();
                    }
                }

                @Override
                public void onError(Throwable error) {
                    System.out.println(error.getClass().getSimpleName());
                }

                @Override
                public void onComplete() {
                    System.out.println("complete");
                }
            });
            publisher.submit(10);
            publisher.submit(20);
            publisher.submit(30);
        }
    }
}

Резултат

10
20

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

Източници