CKTIS / Java
Consumer<T> — operacija bez povratne vrijednosti
Consumer<T> prihvaća jedan argument i ne vraća vrijednost. Predstavlja radnje sa sporednim učincima; accept izvršava operaciju, a andThen povezuje dvije operacije koje se izvršavaju redom.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
Consumer<T> action = value -> { /* side effect */ };
action.accept(value);
Consumer<T> combined = action.andThen(after);java.util.function.Consumer<T> funkcionalno je sučelje kojem se može dodijeliti lambda-izraz ili referenca na metodu. T određuje tip argumenta. Uobičajena je primjena sporedni učinak, primjerice dodavanje teksta u međuspremnik, umjesto izračunavanja povratne vrijednosti.
Consumer.accept, deklariran kao void accept(T t), izvršava operaciju sa zadanim argumentom. void znači da nema povratne vrijednosti, a ne da operacija vraća null.
andThen(Consumer<? super T> after) vraća složeni Consumer: kada se pozove njegov accept, obje operacije dobivaju isti argument, najprije izvorna operacija, a zatim after. Iznimka se prosljeđuje pozivatelju; ako je baci prva operacija, druga se ne izvršava. Prosljeđivanje vrijednosti null kao after uzrokuje NullPointerException.
U primjeru dodjela rezultata metode andThen varijabli combined ne mijenja međuspremnik. Tek combined.accept("Java") dodaje tekst, a zatim njegovu duljinu. Očekivani rezultat je Java:4.
Primjeri
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);
}
}Rezultat
Java:4
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.