Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Flow.Subscription — zahteva in preklic

Flow.Subscription nadzira dostavo elementov med izdajateljem in naročnikom. request(long n) poveča zahtevo, cancel() pa konča prejemanje, ne da bi zagotovil takojšnjo ustavitev dostave.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

import java.util.concurrent.Flow;

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

Flow.Subscription povezuje Flow.Publisher in Flow.Subscriber. Naročnik jo prejme v onSubscribe pred drugimi povratnimi klici. Ta mehanizem nadzora pretoka (backpressure) prejemniku omogoča določiti, koliko elementov je pripravljen sprejeti; brez zahteve prek onNext ne prejme nobenega elementa.

Flow.Subscription.request(long n) prišteje n še neizpolnjeni zahtevi, namesto da bi jo nadomestil. Če se tok konča, lahko prispe manj elementov. Long.MAX_VALUE lahko pomeni praktično neomejeno zahtevo. Če je naročnina aktivna, naročnik pri n <= 0 prejme izjemo IllegalArgumentException prek onError; metoda request izjeme ne sproži sinhrono. Po preklicu naročnine klic request nima učinka, niti pri n <= 0.

Flow.Subscription.cancel() ustavi prejemanje po načelu najboljšega možnega izida: dodatna sporočila lahko še vedno prispejo. Ne zagotavlja ne onComplete ne onError. Obe metodi sta namenjeni izključno povezanemu naročniku; drugačna uporaba ima nedoločene učinke.

Primer uporablja SubmissionPublisher z izvajalnikom Runnable::run, da naloge dostavi v trenutni niti brez tekmovanja z zaključkom programa. Naročnik zahteva dva elementa in po drugem prekliče naročnino. Pričakovani izhod sta 10 in 20, vsak v svoji vrstici, brez complete. To je primer za Java SE 21, ne potrdilo produkcijskega okolja.

Primeri

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

Rezultat

10
20

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri