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

CKTIS / Java

Surcharge de méthodes

La surcharge de méthodes permet à plusieurs méthodes de porter le même nom tout en ayant des listes de paramètres différentes. Le compilateur choisit une surcharge à partir des arguments et de leurs types connus à la compilation, et non des classes à l’exécution des objets passés en argument.

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

Syntaxe

static String describe(int value) { return "int"; }
static String describe(Object value) { return "Object"; }
static String describe(String value) { return "String"; }

Il y a surcharge de méthodes lorsque des méthodes appartenant à une classe portent le même nom, mais ont des signatures qui ne sont pas équivalentes pour la redéfinition. Elles peuvent être déclarées dans cette classe ou héritées.

Pour les méthodes ordinaires non génériques, les surcharges diffèrent par le nombre, les types ou l’ordre des types de paramètres. Les noms des paramètres, le type de retour ou la clause throws ne suffisent pas, à eux seuls, à créer une surcharge.

Le choix de la surcharge se fait à la compilation. Dans l’exemple, describe(value) choisit describe(Object), car le type déclaré de value est Object, même si cette variable contient un objet String. À ne pas confondre avec la redéfinition : pour une signature de méthode d’instance sélectionnée, l’implémentation peut être déterminée à l’exécution.

Si aucune méthode n’est applicable, ou s’il est impossible de choisir sans ambiguïté la méthode la plus spécifique, la compilation échoue. Les surcharges devraient représenter la même opération pour différentes entrées afin que les appels restent faciles à comprendre.

Exemples

public class Main {
    static String describe(int value) {
        return "int";
    }

    static String describe(Object value) {
        return "Object";
    }

    static String describe(String value) {
        return "String";
    }

    public static void main(String[] args) {
        Object value = "hello";
        System.out.println(describe(7));
        System.out.println(describe("hello"));
        System.out.println(describe(value));
    }
}

Résultat

int
String
Object

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