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

CKTIS / Java

Référence de méthode (::)

La syntaxe :: adapte une méthode existante, un constructeur ou une création de tableau à une interface fonctionnelle. Elle n’invoque pas immédiatement l’opération référencée ; le type cible détermine les paramètres compatibles et le résultat.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

Type::staticMethod
expression::instanceMethod
Type::instanceMethod
ClassType::new
ArrayType::new
super::instanceMethod
TypeName.super::instanceMethod

Une expression contenant :: crée une référence de méthode compatible avec une interface fonctionnelle cible. Une interface fonctionnelle doit définir un seul contrat de fonction, que plusieurs déclarations compatibles de méthodes abstraites peuvent exprimer. Les déclarations qui correspondent à des méthodes publiques de Object ne sont pas prises en compte pour déterminer si l’interface est fonctionnelle. Ce contrat guide la compatibilité des paramètres et du résultat, ainsi que le choix parmi les surcharges. L’expression n’exécute pas l’opération référencée. var f = String::length est invalide, car aucun type cible n’est fourni.

Type::staticMethod référence une méthode statique. expression::instanceMethod lie un récepteur particulier, tandis que Type::instanceMethod reçoit son récepteur comme premier argument de l’invocation ultérieure. Ainsi, String::length convient à ToIntFunction<String> : l’argument String est le récepteur, et non un paramètre de length().

ClassType::new référence un constructeur, et ArrayType::new crée un tableau de la longueur fournie. super::instanceMethod et TypeName.super::instanceMethod référencent une implémentation d’un supertype lorsque le contexte du langage le permet. Une référence peut remplacer une lambda qui transmet les arguments à une opération existante.

Attention : dans expression::instanceMethod, l’expression du récepteur est évaluée et mémorisée immédiatement ; si elle vaut null, une NullPointerException se produit à ce moment-là, et non seulement lors de l’invocation. Dans l’exemple, Math::abs, String::length et String[]::new ne sont exécutés que par les méthodes des interfaces fonctionnelles.

Exemples

import java.util.function.IntFunction;
import java.util.function.IntUnaryOperator;
import java.util.function.ToIntFunction;

public class Main {
    public static void main(String[] args) {
        IntUnaryOperator absolute = Math::abs;
        ToIntFunction<String> length = String::length;
        IntFunction<String[]> allocate = String[]::new;

        System.out.println(absolute.applyAsInt(-7));
        System.out.println(length.applyAsInt("Java"));
        System.out.println(allocate.apply(3).length);
    }
}

Résultat

7
4
3

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources