Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Function.compose: executar primeiro a função passada como argumento

`compose` cria uma função que executa primeiro `before` e passa o resultado à função sobre a qual o método foi chamado. `andThen` começa por esta última.

Versão: Java SE 21

Sintaxe

default <V> Function<V, R> compose(Function<? super V, ? extends T> before)

Function.compose é um método de instância default da interface java.util.function.Function<T, R> em Java SE 21. A chamada f.compose(g) devolve uma função composta sem executar nenhuma das duas funções. Chamar apply(x) sobre o resultado equivale a f.apply(g.apply(x)): executa-se primeiro g (o argumento before) e depois f.

Se f for do tipo Function<T, R>, a função composta é do tipo Function<V, R>. O limite ? super V permite que before aceite V ou um dos seus supertipos, e ? extends T permite-lhe devolver T ou um dos seus subtipos. Assim, o resultado intermédio pode ser usado como entrada de f.

Com f.andThen(g), a ordem é inversa: primeiro f, depois g. Se os tipos forem compatíveis, g.andThen(f) exprime a mesma ordem que f.compose(g).

Passar null como before lança uma NullPointerException logo na chamada a compose. Se uma das funções lançar uma exceção durante apply, esta é propagada ao chamador sem ser encapsulada noutra exceção. Se before lançar uma exceção, a segunda função não é executada.

Exemplos

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

Resultado

8
7

`twice.compose(addOne)` incrementa `3` para `4` e depois duplica o valor para obter `8`. `twice.andThen(addOne)` duplica primeiro `3` para `6` e depois soma `1`, obtendo `7`.

Lições relacionadas

  • Java · Lição 48 · Intermédio · Versão: 2

Fontes