CKTIS / Java
Consumer<T> — eine Operation ohne Rückgabewert
Consumer<T> nimmt ein Argument entgegen und gibt keinen Wert zurück. Die Schnittstelle steht für Aktionen mit Seiteneffekten; accept führt die Operation aus, andThen verknüpft zwei nacheinander ausgeführte Operationen.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
Consumer<T> action = value -> { /* side effect */ };
action.accept(value);
Consumer<T> combined = action.andThen(after);java.util.function.Consumer<T> ist ein funktionales Interface, dem ein Lambda-Ausdruck oder eine Methodenreferenz zugewiesen werden kann. T gibt den Argumenttyp an. Typisch ist ein Seiteneffekt, zum Beispiel das Anhängen von Text an einen Puffer, statt eines berechneten Ergebniswerts.
Consumer.accept, deklariert als void accept(T t), führt die Operation mit dem angegebenen Argument aus. void bedeutet, dass es keinen Ergebniswert gibt, nicht, dass die Operation null zurückgibt.
andThen(Consumer<? super T> after) gibt einen zusammengesetzten Consumer zurück: Wird dessen accept aufgerufen, erhalten beide Operationen dasselbe Argument, zuerst die ursprüngliche Operation und danach after. Eine Ausnahme wird an den Aufrufer weitergegeben; löst die erste Operation eine Ausnahme aus, wird die zweite nicht ausgeführt. Wird null als after übergeben, tritt eine NullPointerException auf.
Im Beispiel ändert die Zuweisung des Ergebnisses von andThen an combined den Puffer nicht. Erst combined.accept("Java") hängt den Text und danach seine Länge an. Das erwartete Ergebnis ist Java:4.
Beispiele
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);
}
}Ergebnis
Java:4
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.