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