Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Flow.Subscription — požiadavka a zrušenie

Flow.Subscription riadi doručovanie položiek medzi vydavateľom a odberateľom. request(long n) zvyšuje požiadavku, zatiaľ čo cancel() ukončí prijímanie bez záruky, že sa doručovanie zastaví okamžite.

Verzia: Java SE 21; repository runtime, production runtime not attested

Syntax

import java.util.concurrent.Flow;

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

Flow.Subscription prepája Flow.Publisher s Flow.Subscriber. Odberateľ ju dostane v onSubscribe pred ostatnými spätnými volaniami. Tento mechanizmus riadenia toku (backpressure) umožňuje príjemcovi určiť, koľko položiek je pripravený prijať; bez požiadavky nedostane cez onNext žiadne položky.

Flow.Subscription.request(long n) pripočíta n k nevybavenej požiadavke namiesto toho, aby ju nahradila. Ak sa tok skončí, môže prísť menej položiek. Long.MAX_VALUE môže znamenať prakticky neobmedzenú požiadavku. Ak je odber aktívny, pri volaní s n <= 0 dostane odberateľ výnimku IllegalArgumentException prostredníctvom onError; metóda request ju nevyhodí synchrónne. Po zrušení odberu nemá volanie request žiadny účinok, ani pri n <= 0.

Flow.Subscription.cancel() zastaví prijímanie v rámci najlepších možností: ďalšie správy môžu aj tak prísť. Nezaručuje ani onComplete, ani onError. Obe metódy sú určené iba pre príslušného odberateľa; iné použitie má nedefinované účinky.

Príklad používa SubmissionPublisher s executorom Runnable::run, ktorý doručuje úlohy v aktuálnom vlákne bez súbehu s ukončením programu. Odberateľ požiada o dve položky a po druhej zruší odber. Očakávaný výstup je 10 a 20, každé na samostatnom riadku, bez complete. Ide o príklad pre Java SE 21, nie o potvrdenie produkčného prostredia.

Príklady

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

Výsledok

10
20

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje