Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Flow.Subscription — procura e cancelamento

Flow.Subscription controla a entrega de elementos entre um publicador e um subscritor. request(long n) aumenta a procura, enquanto cancel() termina a receção sem garantir que a entrega pare imediatamente.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

import java.util.concurrent.Flow;

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

Flow.Subscription liga um Flow.Publisher a um Flow.Subscriber. O subscritor recebe-a em onSubscribe, antes das restantes chamadas de retorno. Este mecanismo de controlo do fluxo (backpressure) permite ao recetor indicar quantos elementos está preparado para aceitar; sem um pedido, não recebe elementos através de onNext.

Flow.Subscription.request(long n) adiciona n à procura pendente, em vez de a substituir. Podem chegar menos elementos se o fluxo terminar. Long.MAX_VALUE pode significar uma procura praticamente ilimitada. Se a subscrição estiver ativa, uma chamada com n <= 0 sinaliza ao subscritor uma IllegalArgumentException através de onError, em vez de request lançar a exceção de forma síncrona. Após o cancelamento da subscrição, request não tem qualquer efeito, mesmo com n <= 0.

Flow.Subscription.cancel() interrompe a receção segundo o melhor esforço: ainda podem chegar outras mensagens. Não garante nem onComplete nem onError. Ambos os métodos destinam-se exclusivamente ao subscritor associado; qualquer outra utilização tem efeitos indefinidos.

O exemplo utiliza SubmissionPublisher com o executor Runnable::run para entregar tarefas na thread atual sem uma corrida com o fim do programa. O subscritor pede dois elementos e cancela depois do segundo. O resultado esperado é 10 e 20, cada um numa linha, sem complete. É um exemplo de Java SE 21, não uma certificação de um ambiente de produção.

Exemplos

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

Resultado

10
20

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes