Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

java.lang.reflect.Method — prozkoumání a vyvolání metody

Objekt Method představuje metodu zpřístupněnou pomocí reflexe. Umožňuje zkoumat její název a anotace a vyvolat ji za běhu programu. Potlačení kontrol přístupu pomocí setAccessible stále podléhá hranicím modulů.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

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 představuje jednu metodu třídy nebo rozhraní. Class.getDeclaredMethod hledá metodu deklarovanou daným typem, včetně privátních, ale bez zděděných metod; Class.getMethod hledá veřejné metody, včetně zděděných. Přetížení určují typy parametrů: int.class a Integer.class nejsou při vyhledávání zaměnitelné.

Method.getName() vrací pouze název, nikoli signaturu. Method.isAnnotationPresent(Marker.class) ověřuje přítomnost anotace daného typu; anotace musí mít retenční dobu RetentionPolicy.RUNTIME. Anotace metod se nedědí do metod, které původní metody překrývají, a to ani při použití @Inherited.

Method.setAccessible(true) potlačí, pokud je to povoleno, kontroly přístupu jazyka Java pro tento reflexní objekt; deklaraci tím nezmění na public. Neobchází hranice modulů: přístup k privátní metodě v jiném modulu vyžaduje, aby byl její balíček otevřen modulu volajícího. Odepření může způsobit InaccessibleObjectException nebo SecurityException. trySetAccessible() umožňuje získat false místo první z těchto výjimek.

Method.invoke(receiver, arguments) metodu vyvolá; u statické metody se příjemce ignoruje a může být null. Výsledek má typ Object, primitivní hodnoty se zabalí a void vrací null. Neplatné argumenty způsobí IllegalArgumentException, odepřený přístup způsobí IllegalAccessException a výjimka cílové metody je zabalena do InvocationTargetException.

Příklad používá samostatnou třídu nejvyšší úrovně Greeter, aby ukázal přístup k privátní metodě z Main. Rozsah: Java SE 21; běhové prostředí repozitáře není potvrzeno, stejně jako produkční běhové prostředí.

Pří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ýsledek

greet
true
Hello, Ada

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje