KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Consumer<T> — een bewerking zonder resultaatwaarde

Consumer<T> accepteert één argument en retourneert geen waarde. Het staat voor acties met neveneffecten; accept voert de bewerking uit en andThen combineert twee bewerkingen die na elkaar worden uitgevoerd.

Versie: 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> is een functionele interface waaraan een lambda-expressie of methodeverwijzing kan worden toegewezen. T geeft het type van het argument aan. Een gebruikelijk doel is een neveneffect, zoals tekst aan een buffer toevoegen, in plaats van een resultaatwaarde berekenen.

Consumer.accept, gedeclareerd als void accept(T t), voert de bewerking uit met het opgegeven argument. void betekent dat er geen resultaatwaarde is, niet dat de bewerking null retourneert.

andThen(Consumer<? super T> after) retourneert een samengestelde Consumer: wanneer diens accept wordt aangeroepen, ontvangen beide bewerkingen hetzelfde argument, eerst de oorspronkelijke bewerking en daarna after. Een uitzondering wordt doorgegeven aan de aanroeper; als de eerste bewerking een uitzondering veroorzaakt, wordt de tweede niet uitgevoerd. null doorgeven als after veroorzaakt een NullPointerException.

In het voorbeeld verandert de buffer niet door het resultaat van andThen aan combined toe te wijzen. Pas combined.accept("Java") voegt de tekst en daarna de lengte ervan toe. Het verwachte resultaat is Java:4.

Voorbeelden

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

Resultaat

Java:4

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen