База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Consumer<T> — операция без резултатна стойност

Consumer<T> приема един аргумент и не връща стойност. Представлява действия със странични ефекти; accept изпълнява операцията, а andThen свързва две операции, които се изпълняват последователно.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

Consumer<T> action = value -> { /* side effect */ };
action.accept(value);
Consumer<T> combined = action.andThen(after);

java.util.function.Consumer<T> е функционален интерфейс, на който може да се присвои ламбда израз или препратка към метод. T указва типа на аргумента. Типична употреба е страничен ефект, например добавяне на текст към буфер, вместо изчисляване на резултатна стойност.

Consumer.accept, деклариран като void accept(T t), изпълнява операцията с подадения аргумент. void означава, че няма резултатна стойност, а не че операцията връща null.

andThen(Consumer<? super T> after) връща съставен Consumer: когато бъде извикан неговият accept, двете операции получават един и същ аргумент — първо първоначалната операция, а след това after. Изключение се предава към извикващия код; ако първата операция хвърли изключение, втората не се изпълнява. Подаването на null като after причинява NullPointerException.

В примера присвояването на резултата от andThen на combined не променя буфера. Едва combined.accept("Java") добавя текста, а след това и дължината му. Очакваният резултат е Java:4.

Примери

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);
    }
}

Резултат

Java:4

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници