CKTIS / Java
Consumer<T> — operace bez návratové hodnoty
Consumer<T> přijímá jeden argument a nevrací žádnou hodnotu. Představuje akce s vedlejšími účinky; accept operaci provede a andThen spojí dvě operace, které se vykonají za sebou.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
Consumer<T> action = value -> { /* side effect */ };
action.accept(value);
Consumer<T> combined = action.andThen(after);java.util.function.Consumer<T> je funkční rozhraní, kterému lze přiřadit lambda výraz nebo odkaz na metodu. T určuje typ argumentu. Typickým použitím je vedlejší účinek, například připojení textu k vyrovnávací paměti, místo výpočtu návratové hodnoty.
Consumer.accept, deklarovaná jako void accept(T t), provede operaci se zadaným argumentem. void znamená, že neexistuje návratová hodnota, nikoli že operace vrací null.
andThen(Consumer<? super T> after) vrátí složený Consumer: při zavolání jeho accept obdrží obě operace stejný argument, nejprve původní operace a potom after. Výjimka se předá volajícímu; pokud ji vyvolá první operace, druhá se neprovede. Předání null jako after způsobí NullPointerException.
V příkladu přiřazení výsledku andThen do proměnné combined vyrovnávací paměť nezmění. Teprve combined.accept("Java") připojí text a poté jeho délku. Očekávaný výsledek je Java:4.
Příklady
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);
}
}Výsledek
Java:4
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.