Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Consumer<T> — une opération sans valeur de résultat

Consumer<T> accepte un argument et ne renvoie aucune valeur. Il représente des actions avec effets de bord ; accept exécute l’opération, tandis que andThen combine deux opérations exécutées l’une après l’autre.

Version : 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> est une interface fonctionnelle à laquelle on peut affecter une expression lambda ou une référence de méthode. T indique le type de l’argument. Un usage courant consiste à produire un effet de bord, par exemple ajouter du texte à un tampon, plutôt qu’à calculer une valeur de résultat.

Consumer.accept, déclaré sous la forme void accept(T t), exécute l’opération avec l’argument fourni. void signifie qu’il n’y a pas de valeur de résultat, et non que l’opération renvoie null.

andThen(Consumer<? super T> after) renvoie un Consumer composé : lors de l’appel à son accept, les deux opérations reçoivent le même argument, d’abord l’opération d’origine, puis after. Une exception est propagée à l’appelant ; si la première opération en lève une, la seconde n’est pas exécutée. Passer null comme after provoque une NullPointerException.

Dans l’exemple, affecter le résultat de andThen à combined ne modifie pas le tampon. Seul combined.accept("Java") ajoute le texte, puis sa longueur. Le résultat attendu est Java:4.

Exemples

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

Résultat

Java:4

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources