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

CKTIS / Java

Consumer<T> — uma operação sem valor de resultado

Consumer<T> aceita um argumento e não devolve qualquer valor. Representa ações com efeitos secundários; accept executa a operação, enquanto andThen combina duas operações executadas em sequência.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

java.util.function.Consumer<T> é uma interface funcional à qual se pode atribuir uma expressão lambda ou uma referência a um método. T indica o tipo do argumento. Uma utilização comum é produzir um efeito secundário, por exemplo acrescentar texto a um buffer, em vez de calcular um valor de resultado.

Consumer.accept, declarado como void accept(T t), executa a operação com o argumento fornecido. void significa que não existe valor de resultado, e não que a operação devolve null.

andThen(Consumer<? super T> after) devolve um Consumer composto: quando se chama o seu accept, ambas as operações recebem o mesmo argumento, primeiro a operação original e depois after. Uma exceção é propagada para o chamador; se a primeira operação lançar uma, a segunda não é executada. Passar null como after provoca uma NullPointerException.

No exemplo, atribuir o resultado de andThen a combined não altera o buffer. Só combined.accept("Java") acrescenta o texto e, em seguida, o seu comprimento. O resultado esperado é Java:4.

Exemplos

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

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.

Fontes