CKTIS / Java
Function.identity() : fonction identité et finisseur de collecteur
`Function.identity()` fournit une fonction qui renvoie la même référence. Comme fonction de finition d’un collecteur, elle permet de renvoyer le conteneur d’accumulation sans le transformer.
Version : Java SE 21
Syntaxe
import java.util.function.Function;
// Static method declaration in java.util.function.Function:
static <T> Function<T, T> identity()
// Typical use:
Function<String, String> same = Function.identity();Function.identity() est une méthode générique statique de l’interface java.util.function.Function, disponible depuis Java 8. L’appel ne prend aucun argument et renvoie une Function<T, T>, dont l’entrée et le résultat ont le même type. Son apply(x) se comporte comme x -> x : il renvoie la même référence sans copier ni modifier l’objet, et renvoie null pour null.
Dans Collector<T, A, R>, T est le type des éléments d’entrée, A celui du conteneur d’accumulation et R celui du résultat final. finisher() fournit une Function<A, R>. Si A et R sont du même type et que le conteneur doit devenir le résultat sans transformation, passez Function.identity() à la surcharge de Collector.of qui accepte un finisseur explicite. Si le résultat doit être une copie ou être non modifiable, utilisez un finisseur qui effectue cette transformation.
Passer Function.identity() comme finisseur n’ajoute pas automatiquement IDENTITY_FINISH. Cette caractéristique permet à la réduction de ne pas appeler le finisseur. Ne la déclarez que si le finisseur est une fonction identité et qu’une conversion de type non vérifiée de A vers R réussira. La surcharge de Collector.of sans argument de finition ajoute elle-même cette caractéristique.
Si une API exige un UnaryOperator<T>, utilisez UnaryOperator.identity() : le comportement est le même, mais le type de retour déclaré est UnaryOperator<T>, et non Function<T, T>.
Exemples
import java.util.ArrayList;
import java.util.List;
import java.util.function.Function;
import java.util.stream.Collector;
public class IdentityFinisherDemo {
public static void main(String[] args) {
Collector<String, List<String>, List<String>> collector = Collector.of(
ArrayList::new,
List::add,
(left, right) -> {
left.addAll(right);
return left;
},
Function.identity(),
Collector.Characteristics.IDENTITY_FINISH);
List<String> input = List.of("Ada", "Lin");
List<String> buffer = collector.supplier().get();
input.forEach(name -> collector.accumulator().accept(buffer, name));
List<String> result = collector.finisher().apply(buffer);
System.out.println(result == buffer);
System.out.println(input.stream().collect(collector));
}
}Résultat
true [Ada, Lin]
La première ligne, `true`, montre que `==` confirme qu’il s’agit de la même référence après un appel direct au finisseur. La seconde, `[Ada, Lin]`, montre le contenu collecté depuis le flux, sans indiquer si le flux a appelé le finisseur.
Leçons associées
- Java · Leçon 24 · Avancé · Version : 2