Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Consumer<T> — una operación sin valor de resultado

Consumer<T> acepta un argumento y no devuelve ningún valor. Representa acciones con efectos secundarios; accept ejecuta la operación, mientras que andThen combina dos operaciones que se ejecutan en secuencia.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

Consumer<T> action = value -> { /* side effect */ };
action.accept(value);
Consumer<T> combined = action.andThen(after);

java.util.function.Consumer<T> es una interfaz funcional a la que se puede asignar una expresión lambda o una referencia a un método. T indica el tipo del argumento. Un uso habitual es producir un efecto secundario, como añadir texto a un búfer, en lugar de calcular un valor de resultado.

Consumer.accept, declarado como void accept(T t), realiza la operación con el argumento proporcionado. void significa que no hay valor de resultado, no que la operación devuelva null.

andThen(Consumer<? super T> after) devuelve un Consumer compuesto: cuando se llama a su accept, ambas operaciones reciben el mismo argumento, primero la operación original y después after. Las excepciones se propagan al llamador; si la primera operación lanza una, la segunda no se ejecuta. Pasar null como after provoca una NullPointerException.

En el ejemplo, asignar el resultado de andThen a combined no modifica el búfer. Solo combined.accept("Java") añade el texto y, a continuación, su longitud. El resultado esperado es Java:4.

Ejemplos

import java.util.function.Consumer;

public class Main {
    public static void main(String[] args) {
        StringBuilder log = new StringBuilder();
        Consumer<String> append = text -> { log.append(text); };
        Consumer<String> appendLength = text -> {
            log.append(":").append(text.length());
        };

        Consumer<String> combined = append.andThen(appendLength);
        combined.accept("Java");
        System.out.println(log);
    }
}

Resultado

Java:4

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.

Fuentes