Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Consumer<T> — un’operazione senza valore restituito

Consumer<T> accetta un argomento e non restituisce alcun valore. Rappresenta azioni con effetti collaterali; accept esegue l’operazione, mentre andThen combina due operazioni eseguite in sequenza.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

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

java.util.function.Consumer<T> è un’interfaccia funzionale a cui si può assegnare un’espressione lambda o un riferimento a un metodo. T indica il tipo dell’argomento. Un uso tipico consiste nel produrre un effetto collaterale, per esempio aggiungere testo a un buffer, invece di calcolare un valore risultato.

Consumer.accept, dichiarato come void accept(T t), esegue l’operazione sull’argomento fornito. void significa che non c’è un valore risultato, non che l’operazione restituisca null.

andThen(Consumer<? super T> after) restituisce un Consumer composto: quando viene chiamato il suo accept, entrambe le operazioni ricevono lo stesso argomento, prima l’operazione originale e poi after. Un’eccezione viene propagata al chiamante; se la prima operazione ne genera una, la seconda non viene eseguita. Passare null come after causa una NullPointerException.

Nell’esempio, assegnare il risultato di andThen a combined non modifica il buffer. Solo combined.accept("Java") aggiunge il testo e poi la sua lunghezza. Il risultato atteso è Java:4.

Esempi

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

Risultato

Java:4

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti