CKTIS / Java
Flow.Publisher: publicar elementos con control de la demanda
Flow.Publisher<T> describe una fuente de elementos que reciben los suscriptores. El método subscribe conecta un receptor con la fuente, mientras que Flow.Subscription permite solicitar elementos y cancelar la recepción.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
Flow.Publisher<T>
void subscribe(Flow.Subscriber<? super T> subscriber)Flow.Publisher<T> es una interfaz funcional de java.util.concurrent. Flow.Publisher.subscribe tiene la firma void subscribe(Flow.Subscriber<? super T> subscriber). El comodín ? super T admite un receptor de tipo T o de un supertipo. Un receptor aceptado recibe onSubscribe con un objeto Flow.Subscription; un argumento null provoca NullPointerException. Una suscripción duplicada o un rechazo debido a una política o a un error se señala mediante onError con IllegalStateException.
Llamar a subscribe no crea demanda por sí solo. request(n) añade demanda para hasta n elementos más; si n <= 0, se invoca onError con IllegalArgumentException. Esto es control de flujo (backpressure), no una garantía de que se entreguen exactamente n elementos. cancel() detiene la recepción según el mejor esfuerzo: todavía pueden llegar mensajes y no se exige una señal terminal.
Los elementos llegan mediante onNext; onComplete indica una terminación normal y onError indica un fallo. Después de una señal terminal no se producen más llamadas. Las llamadas de una misma suscripción se ordenan mediante la relación happens-before. No des por hecho que se reproducirán elementos anteriores ni que se aplicará una política uniforme para descartarlos: depende de la implementación.
El ejemplo utiliza SubmissionPublisher como implementación y llama a subscribe a través de una referencia Flow.Publisher<Integer>. El receptor solicita dos elementos. Al cerrar la fuente se inicia la finalización normal, pero la entrega es asíncrona, así que CountDownLatch mantiene vivo el programa hasta que se procesa la señal terminal. Esta espera de demostración no tiene límite de tiempo; en código operativo hay que prever cómo gestionar la falta de finalización.
Ejemplos
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.Flow;
import java.util.concurrent.SubmissionPublisher;
public class Main {
public static void main(String[] args) throws InterruptedException {
CountDownLatch done = new CountDownLatch(1);
try (SubmissionPublisher<Integer> source = new SubmissionPublisher<>()) {
Flow.Publisher<Integer> publisher = source;
publisher.subscribe(new Flow.Subscriber<Integer>() {
public void onSubscribe(Flow.Subscription subscription) {
subscription.request(2);
}
public void onNext(Integer item) {
System.out.println(item);
}
public void onError(Throwable error) {
System.out.println("Error: " + error.getClass().getSimpleName());
done.countDown();
}
public void onComplete() {
System.out.println("Done");
done.countDown();
}
});
source.submit(10);
source.submit(20);
}
done.await();
}
}Resultado
10 20 Done
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.