CKTIS / Java
Consumer<T> — operacija brez vrnjene vrednosti
Consumer<T> sprejme en argument in ne vrne nobene vrednosti. Predstavlja dejanja s stranskimi učinki; accept izvede operacijo, andThen pa združi dve operaciji, ki se izvedeta zaporedoma.
Različica: 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> je funkcijski vmesnik, ki mu lahko priredimo lambda izraz ali sklic na metodo. T določa vrsto argumenta. Običajna uporaba je stranski učinek, na primer dodajanje besedila v medpomnilnik, namesto izračuna vrnjene vrednosti.
Consumer.accept, deklariran kot void accept(T t), izvede operacijo z danim argumentom. void pomeni, da ni vrnjene vrednosti, ne pa, da operacija vrne null.
andThen(Consumer<? super T> after) vrne sestavljeni Consumer: ko pokličemo njegov accept, obe operaciji prejmeta isti argument, najprej prvotna operacija, nato after. Izjema se posreduje klicatelju; če jo sproži prva operacija, se druga ne izvede. Če kot after podamo null, pride do NullPointerException.
Ko v primeru rezultat klica andThen priredimo spremenljivki combined, se vsebina medpomnilnika še ne spremeni. Šele combined.accept("Java") doda besedilo in nato njegovo dolžino. Pričakovani rezultat je Java:4.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.