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.