CKTIS / Java
Function.compose : exécuter d’abord la fonction passée en argument
`compose` crée une fonction qui exécute d’abord `before`, puis transmet son résultat à la fonction sur laquelle la méthode a été appelée. `andThen` commence par cette dernière.
Version : Java SE 21
Syntaxe
default <V> Function<V, R> compose(Function<? super V, ? extends T> before)Function.compose est une méthode d’instance par défaut de l’interface java.util.function.Function<T, R> dans Java SE 21. L’appel f.compose(g) renvoie une fonction composée sans exécuter les deux fonctions. Appeler apply(x) sur le résultat revient à faire f.apply(g.apply(x)) : g (l’argument before) s’exécute d’abord, puis f.
Si f est de type Function<T, R>, la fonction composée est de type Function<V, R>. La borne ? super V permet à before d’accepter V ou l’un de ses supertypes ; ? extends T lui permet de renvoyer T ou l’un de ses sous-types. Le résultat intermédiaire peut ainsi servir d’entrée à f.
Avec f.andThen(g), l’ordre est inversé : f s’exécute avant g. Si les types sont compatibles, g.andThen(f) exprime le même ordre que f.compose(g).
Passer null comme argument before déclenche une NullPointerException dès l’appel à compose. Si l’une des fonctions lève une exception pendant apply, celle-ci est propagée à l’appelant sans être encapsulée. Si before lève une exception, la seconde fonction ne s’exécute pas.
Exemples
import java.util.function.Function;
public class ComposeExample {
public static void main(String[] args) {
Function<Integer, Integer> twice = n -> n * 2;
Function<Integer, Integer> addOne = n -> n + 1;
Function<Integer, Integer> composed = twice.compose(addOne);
System.out.println(composed.apply(3));
System.out.println(twice.andThen(addOne).apply(3));
}
}Résultat
8 7
`twice.compose(addOne)` fait passer `3` à `4`, puis double ce résultat pour obtenir `8`. `twice.andThen(addOne)` double d’abord `3` pour obtenir `6`, puis ajoute `1` pour obtenir `7`.
Leçons associées
- Java · Leçon 48 · Intermédiaire · Version : 2