CKTIS / Java
Consumer<T> — operacja bez wartości wynikowej
Consumer<T> przyjmuje jeden argument i nie zwraca wartości. Służy do działań wywołujących efekty uboczne; accept uruchamia operację, a andThen łączy dwie operacje wykonywane kolejno.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
Consumer<T> action = value -> { /* side effect */ };
action.accept(value);
Consumer<T> combined = action.andThen(after);java.util.function.Consumer<T> to interfejs funkcyjny: można przypisać do niego lambdę lub referencję do metody. T określa typ argumentu. Typowym zastosowaniem jest efekt uboczny, na przykład dopisanie tekstu do bufora, zamiast obliczania wartości wynikowej.
Consumer.accept, zadeklarowana jako void accept(T t), wykonuje operację dla podanego argumentu. void oznacza brak wartości wynikowej, a nie zwracanie null.
andThen(Consumer<? super T> after) zwraca złożony Consumer: po wywołaniu jego accept obie operacje otrzymują ten sam argument, najpierw pierwotna, potem after. Wyjątek jest przekazywany do wywołującego; jeśli pierwsza operacja go zgłosi, druga nie zostanie wykonana. Przekazanie null jako after powoduje NullPointerException.
W przykładzie samo przypisanie wyniku andThen do combined nie zmienia bufora. Dopiero combined.accept("Java") dopisuje tekst, a następnie jego długość. Oczekiwany wynik to Java:4.
Przykłady
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);
}
}Wynik
Java:4
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.