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.SubmissionPublisherSubmissionPublisher 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.