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.