Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje