CKTIS / Java
java.lang.reflect.Method — pregled in priklic metode
Objekt Method predstavlja metodo, do katere dostopamo z refleksijo. Omogoča pregled njenega imena in anotacij ter priklic med izvajanjem. Onemogočanje preverjanja dostopa z setAccessible še vedno omejujejo meje modulov.
Različica: 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 eno metodo razreda ali vmesnika. Class.getDeclaredMethod poišče metodo, deklarirano v tem tipu, vključno z zasebnimi, ne pa podedovanih metod; Class.getMethod poišče javne metode, tudi podedovane. Preobremenitev določajo tipi parametrov: int.class in Integer.class pri iskanju nista zamenljiva.
Method.getName() vrne samo ime, ne podpisa. Method.isAnnotationPresent(Marker.class) preveri, ali je prisotna anotacija tega tipa; imeti mora hrambo RetentionPolicy.RUNTIME. Anotacije metod se ne podedujejo v metodah, ki preglasijo izvirne metode, niti ob uporabi @Inherited.
Method.setAccessible(true) po potrebi in kadar je dovoljeno onemogoči preverjanje dostopa jezika Java za ta refleksijski objekt; deklaracije ne spremeni v public. Ne obide meja modulov: za dostop do zasebne metode v drugem modulu mora biti njen paket odprt modulu klicatelja. Zavrnitev lahko povzroči InaccessibleObjectException ali SecurityException. trySetAccessible() omogoča vrnitev false namesto prve od teh izjem.
Method.invoke(receiver, arguments) prikliče metodo; pri statični metodi se prejemnik prezre in je lahko null. Rezultat je tipa Object, primitivne vrednosti se zapakirajo, void pa vrne null. Neveljavni argumenti povzročijo IllegalArgumentException, zavrnjen dostop povzroči IllegalAccessException, izjema ciljne metode pa je ovita v InvocationTargetException.
Primer uporablja ločen vrhnji razred Greeter, da pokaže dostop do zasebne metode iz Main. Obseg: Java SE 21; izvajalno okolje repozitorija ni potrjeno, prav tako ne produkcijsko izvajalno okolje.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.