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.