CKTIS / Java
java.lang.reflect.Method — skúmanie a vyvolanie metódy
Objekt Method predstavuje metódu sprístupnenú pomocou reflexie. Umožňuje skúmať jej názov a anotácie a vyvolať ju počas behu programu. Potlačenie kontrol prístupu pomocou setAccessible stále podlieha hraniciam modulov.
Verzia: 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 predstavuje jednu metódu triedy alebo rozhrania. Class.getDeclaredMethod vyhľadá metódu deklarovanú daným typom, vrátane súkromných, ale nie zdedených metód; Class.getMethod vyhľadá verejné metódy vrátane zdedených. Preťaženie určujú typy parametrov: int.class a Integer.class nie sú pri vyhľadávaní zameniteľné.
Method.getName() vráti iba názov, nie signatúru. Method.isAnnotationPresent(Marker.class) overí prítomnosť anotácie daného typu; anotácia musí mať retenčnú dobu RetentionPolicy.RUNTIME. Anotácie metód sa nededia do metód, ktoré pôvodné metódy prekrývajú, a to ani pri použití @Inherited.
Method.setAccessible(true) potlačí, ak je to povolené, kontroly prístupu jazyka Java pre tento reflexný objekt; deklaráciu tým nezmení na public. Neobchádza hranice modulov: prístup k súkromnej metóde v inom module vyžaduje, aby bol jej balík otvorený modulu volajúceho. Odmietnutie môže spôsobiť InaccessibleObjectException alebo SecurityException. trySetAccessible() umožňuje získať false namiesto prvej z týchto výnimiek.
Method.invoke(receiver, arguments) metódu vyvolá; pri statickej metóde sa prijímateľ ignoruje a môže byť null. Výsledok má typ Object, primitívne hodnoty sa zabalia a void vráti null. Neplatné argumenty spôsobia IllegalArgumentException, odmietnutý prístup spôsobí IllegalAccessException a výnimka cieľovej metódy sa zabalí do InvocationTargetException.
Príklad používa samostatnú triedu najvyššej úrovne Greeter, aby ukázal prístup k súkromnej metóde z Main. Rozsah: Java SE 21; behové prostredie repozitára nie je potvrdené, rovnako ako produkčné behové prostredie.
Príklady
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"));
}
}Výsledok
greet true Hello, Ada
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.