CKTIS / Java
java.lang.reflect.Method — pregled i pozivanje metode
Objekt Method predstavlja metodu kojoj se pristupa refleksijom. Omogućuje pregled naziva i anotacija te pozivanje tijekom izvođenja programa. Isključivanje provjera pristupa pomoću setAccessible i dalje podliježe granicama modula.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
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 predstavlja jednu metodu klase ili sučelja. Class.getDeclaredMethod traži metodu deklariranu u tom tipu, uključujući privatne, ali ne i naslijeđene metode; Class.getMethod traži javne metode, uključujući naslijeđene. Tipovi parametara određuju preopterećenje: int.class i Integer.class nisu zamjenjivi pri pretraživanju.
Method.getName() vraća samo naziv, a ne potpis. Method.isAnnotationPresent(Marker.class) provjerava postoji li anotacija tog tipa; ona mora imati retenciju RetentionPolicy.RUNTIME. Metode koje nadjačavaju druge metode ne nasljeđuju njihove anotacije, čak ni uz uporabu @Inherited.
Method.setAccessible(true) potiskuje, ako je dopušteno, provjere pristupa jezika Java za taj refleksijski objekt; deklaraciju ne mijenja u public. Ne zaobilazi granice modula: za pristup privatnoj metodi u drugom modulu njezin paket mora biti otvoren modulu pozivatelja. Odbijanje može uzrokovati InaccessibleObjectException ili SecurityException. trySetAccessible() omogućuje dobivanje vrijednosti false umjesto prve od tih iznimki.
Method.invoke(receiver, arguments) poziva metodu; kod statičke metode primatelj se zanemaruje i može biti null. Rezultat je tipa Object, primitivne se vrijednosti pakiraju, a void daje null. Nevaljani argumenti uzrokuju IllegalArgumentException, odbijen pristup uzrokuje IllegalAccessException, a iznimka ciljne metode omata se u InvocationTargetException.
Primjer koristi zasebnu klasu najviše razine Greeter kako bi pokazao pristup privatnoj metodi iz Main. Opseg: Java SE 21; okruženje izvođenja repozitorija nije potvrđeno, kao ni produkcijsko okruženje izvođenja.
Primjeri
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"));
}
}Rezultat
greet true Hello, Ada
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.