CKTIS / Java
java.lang.reflect.Method — odczyt metadanych i wywołanie metody
Obiekt Method reprezentuje metodę dostępną przez refleksję. Pozwala odczytać jej nazwę i adnotacje oraz wywołać ją w czasie działania programu. Wyłączenie kontroli dostępu przez setAccessible podlega ograniczeniom modułów.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
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 reprezentuje jedną metodę klasy lub interfejsu. Class.getDeclaredMethod wyszukuje metodę zadeklarowaną w danym typie, także prywatną, ale nie odziedziczoną; Class.getMethod wyszukuje metody publiczne, także odziedziczone. Typy parametrów identyfikują przeciążenie: przy wyszukiwaniu int.class i Integer.class nie są zamienne.
Method.getName() zwraca samą nazwę, bez sygnatury. Odziedziczona metoda Method.isAnnotationPresent(Marker.class) sprawdza obecność adnotacji danego typu; adnotacja musi mieć retencję RetentionPolicy.RUNTIME. Adnotacje metod nie są dziedziczone przez metody przesłaniające, nawet przy użyciu @Inherited.
Method.setAccessible(true) wyłącza kontrolę dostępu języka dla tego obiektu refleksji, jeśli jest to dozwolone; nie zmienia deklaracji na public. Nie omija granic modułów: dostęp do prywatnej metody w innym module wymaga otwarcia pakietu dla modułu wywołującego. Odmowa może spowodować InaccessibleObjectException lub SecurityException. trySetAccessible() pozwala zamiast pierwszego z tych wyjątków otrzymać false.
Method.invoke(receiver, arguments) wywołuje metodę; dla metody statycznej odbiorca jest ignorowany i może być null. Wynik ma typ Object, wartości prymitywne są opakowywane, a void daje null. Błędne argumenty powodują IllegalArgumentException, brak dostępu — IllegalAccessException, a wyjątek metody docelowej jest opakowany w InvocationTargetException.
Przykład używa osobnej klasy najwyższego poziomu Greeter, aby pokazać dostęp do prywatnej metody z Main. Zakres: Java SE 21; środowisko repozytorium, środowisko produkcyjne niepotwierdzone.
Przykłady
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"));
}
}Wynik
greet true Hello, Ada
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.