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

CKTIS / Java

util.concurrent.SubmissionPublisher: referência prática

util.concurrent.SubmissionPublisher: referência prática: SubmissionPublisher<T> entrega assincronamente itens não null aos Flow.Subscriber atuais através de um buffer independente por subscritor.

Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Sintaxe

java.util.concurrent.SubmissionPublisher

SubmissionPublisher entrega assincronamente itens não null aos Flow.Subscriber atuais através de um buffer independente por subscritor.

Usa-o como publisher reactive streams simples com Executor, capacidade e estratégia de backpressure ou drop explícitos.

submit pode bloquear sem interrupção por espaço, enquanto offer pode descartar por subscritor e invocar onDrop.

Lag e demand são estimativas, não controlos de sincronização; close sinaliza onComplete, closeExceptionally onError e null é proibido.

O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.

Exemplos

public class Main {
    public static void main(String[] args) throws Exception {
        try (var publisher = new java.util.concurrent.SubmissionPublisher<Integer>(Runnable::run, 8)) {
            publisher.subscribe(new java.util.concurrent.Flow.Subscriber<>() {
                public void onSubscribe(java.util.concurrent.Flow.Subscription subscription) { subscription.request(1); }
                public void onNext(Integer item) { System.out.println(item); }
                public void onError(Throwable error) { throw new RuntimeException(error); }
                public void onComplete() {}
            });
            publisher.submit(7);
        }
    }
}

Resultado

7

O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.

Fontes