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

CKTIS / Java

java.lang.reflect.Method — examiner et invoquer une méthode

Un objet Method représente une méthode accessible par réflexion. Il permet d’examiner son nom et ses annotations, puis de l’invoquer à l’exécution. La suppression des contrôles d’accès avec setAccessible reste soumise aux limites des modules.

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

Syntaxe

Method m = Type.class.getDeclaredMethod("methodName", ParameterType.class);
String name = m.getName();
boolean annotated = m.isAnnotationPresent(Marker.class);
m.setAccessible(true);
Object result = m.invoke(receiver, argument);

java.lang.reflect.Method représente une méthode d’une classe ou d’une interface. Class.getDeclaredMethod recherche une méthode déclarée par ce type, y compris les méthodes privées mais pas les méthodes héritées ; Class.getMethod recherche les méthodes publiques, y compris celles héritées. Les types des paramètres identifient la surcharge : int.class et Integer.class ne sont pas interchangeables lors de la recherche.

Method.getName() renvoie uniquement le nom, pas la signature. Method.isAnnotationPresent(Marker.class) vérifie la présence d’une annotation de ce type ; celle-ci doit avoir la rétention RetentionPolicy.RUNTIME. Les annotations de méthode ne sont pas héritées par les méthodes qui redéfinissent celles-ci, même avec @Inherited.

Method.setAccessible(true) supprime, lorsque cela est permis, les contrôles d’accès du langage Java pour cet objet de réflexion ; cela ne transforme pas la déclaration en public. Cette opération ne contourne pas les limites des modules : accéder à une méthode privée d’un autre module exige que son paquet soit ouvert au module appelant. Un refus peut provoquer InaccessibleObjectException ou SecurityException. trySetAccessible() permet d’obtenir false à la place de la première de ces exceptions.

Method.invoke(receiver, arguments) invoque la méthode ; pour une méthode statique, le récepteur est ignoré et peut être null. Le résultat est de type Object, les valeurs primitives sont empaquetées et void donne null. Des arguments incorrects provoquent IllegalArgumentException, un accès refusé provoque IllegalAccessException, et une exception de la méthode cible est enveloppée dans InvocationTargetException.

L’exemple utilise une classe de premier niveau distincte, Greeter, pour montrer l’accès à une méthode privée depuis Main. Portée : Java SE 21 ; l’environnement d’exécution du dépôt n’est pas attesté, pas plus que celui de production.

Exemples

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.reflect.Method;

class Greeter {
    @Retention(RetentionPolicy.RUNTIME)
    @interface Marker {}

    @Marker
    private String greet(String name) {
        return "Hello, " + name;
    }
}

public class Main {
    public static void main(String[] args) throws ReflectiveOperationException {
        Method m = Greeter.class.getDeclaredMethod("greet", String.class);
        System.out.println(m.getName());
        System.out.println(m.isAnnotationPresent(Greeter.Marker.class));
        m.setAccessible(true);
        System.out.println(m.invoke(new Greeter(), "Ada"));
    }
}

Résultat

greet
true
Hello, Ada

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