KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

java.lang.reflect.Method — een methode inspecteren en aanroepen

Een Method-object vertegenwoordigt een methode die via reflection toegankelijk is. Je kunt de naam en annotaties ervan inspecteren en de methode tijdens runtime aanroepen. Het onderdrukken van toegangscontroles met setAccessible blijft onderworpen aan modulegrenzen.

Versie: 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 vertegenwoordigt één methode van een klasse of interface. Class.getDeclaredMethod zoekt een methode die door dat type is gedeclareerd, ook private methoden maar geen geërfde; Class.getMethod zoekt publieke methoden, ook geërfde. Parametertypen bepalen de overload: int.class en Integer.class zijn bij het zoeken niet uitwisselbaar.

Method.getName() geeft alleen de naam terug, niet de signatuur. Method.isAnnotationPresent(Marker.class) controleert of een annotatie van dat type aanwezig is; die annotatie moet de retentie RetentionPolicy.RUNTIME hebben. Methodeannotaties worden niet overgeërfd door methoden die de oorspronkelijke methode overschrijven, ook niet met @Inherited.

Method.setAccessible(true) onderdrukt, indien toegestaan, de toegangscontroles van de Java-taal voor dit reflection-object; de declaratie wordt daardoor niet public. Het omzeilt geen modulegrenzen: voor toegang tot een private methode in een andere module moet het pakket zijn geopend voor de module van de aanroeper. Weigering kan InaccessibleObjectException of SecurityException veroorzaken. Met trySetAccessible() kun je false ontvangen in plaats van de eerste uitzondering.

Method.invoke(receiver, arguments) roept de methode aan; bij een statische methode wordt de ontvanger genegeerd en mag deze null zijn. Het resultaat is van het type Object, primitieve waarden worden ingepakt en void levert null op. Ongeldige argumenten veroorzaken IllegalArgumentException, geweigerde toegang veroorzaakt IllegalAccessException en een uitzondering uit de doelmethode wordt verpakt in InvocationTargetException.

Het voorbeeld gebruikt een aparte top-levelklasse Greeter om toegang tot een private methode vanuit Main te laten zien. Reikwijdte: Java SE 21; de runtime van de repository is niet bevestigd, evenmin als een productie-runtime.

Voorbeelden

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"));
    }
}

Resultaat

greet
true
Hello, Ada

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen