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.