Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Consumer<T> — operácia bez návratovej hodnoty

Consumer<T> prijíma jeden argument a nevracia žiadnu hodnotu. Predstavuje akcie s vedľajšími účinkami; accept vykoná operáciu a andThen spojí dve operácie, ktoré sa vykonajú za sebou.

Verzia: 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> je funkčné rozhranie, ktorému možno priradiť lambda výraz alebo odkaz na metódu. T určuje typ argumentu. Typickým použitím je vedľajší účinok, napríklad pridanie textu do vyrovnávacej pamäte, namiesto výpočtu návratovej hodnoty.

Consumer.accept, deklarovaná ako void accept(T t), vykoná operáciu so zadaným argumentom. void znamená, že neexistuje návratová hodnota, nie že operácia vracia null.

andThen(Consumer<? super T> after) vráti zložený Consumer: pri zavolaní jeho accept dostanú obe operácie rovnaký argument, najprv pôvodná operácia a potom after. Výnimka sa odovzdá volajúcemu; ak ju vyvolá prvá operácia, druhá sa nevykoná. Odovzdanie null ako after spôsobí NullPointerException.

V príklade priradenie výsledku andThen do premennej combined vyrovnávaciu pamäť nezmení. Až combined.accept("Java") pridá text a potom jeho dĺžku. Očakávaný výsledok je Java:4.

Prí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ýsledok

Java:4

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje