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

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

Sources