CKTIS / Java
java.lang.reflect.Method — eine Methode untersuchen und aufrufen
Ein Method-Objekt repräsentiert eine Methode, auf die über Reflection zugegriffen wird. Damit lassen sich ihr Name und ihre Annotationen untersuchen und sie zur Laufzeit aufrufen. Das Unterdrücken von Zugriffskontrollen mit setAccessible unterliegt weiterhin Modulgrenzen.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
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äsentiert eine einzelne Methode einer Klasse oder eines Interfaces. Class.getDeclaredMethod sucht eine von diesem Typ deklarierte Methode, einschließlich privater, aber ohne geerbte Methoden; Class.getMethod sucht öffentliche Methoden, auch geerbte. Parametertypen bestimmen die Überladung: int.class und Integer.class sind bei der Suche nicht austauschbar.
Method.getName() gibt nur den Namen zurück, nicht die Signatur. Method.isAnnotationPresent(Marker.class) prüft, ob eine Annotation dieses Typs vorhanden ist; sie muss die Retention RetentionPolicy.RUNTIME haben. Methodenannotationen werden nicht an überschreibende Methoden vererbt, auch nicht mit @Inherited.
Method.setAccessible(true) unterdrückt, sofern erlaubt, die Zugriffskontrollen der Java-Sprache für dieses Reflection-Objekt; die Deklaration wird dadurch nicht zu public. Modulgrenzen werden nicht umgangen: Für den Zugriff auf eine private Methode in einem anderen Modul muss ihr Paket für das Modul des Aufrufers geöffnet sein. Eine Verweigerung kann InaccessibleObjectException oder SecurityException auslösen. Mit trySetAccessible() kann statt der ersten Ausnahme false zurückgegeben werden.
Method.invoke(receiver, arguments) ruft die Methode auf; bei einer statischen Methode wird der Empfänger ignoriert und darf null sein. Das Ergebnis hat den Typ Object, primitive Werte werden verpackt und void ergibt null. Ungültige Argumente führen zu IllegalArgumentException, verweigerter Zugriff zu IllegalAccessException; eine Ausnahme der Zielmethode wird in InvocationTargetException verpackt.
Das Beispiel verwendet eine separate Top-Level-Klasse Greeter, um den Zugriff von Main auf eine private Methode zu zeigen. Geltungsbereich: Java SE 21; die Laufzeitumgebung des Repositorys ist nicht bestätigt, ebenso wenig eine Produktionslaufzeit.
Beispiele
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"));
}
}Ergebnis
greet true Hello, Ada
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.