WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

InvocationHandler – Aufrufe dynamischer Proxys behandeln

InvocationHandler legt fest, wie sich die Methoden eines dynamischen Proxys verhalten. Erfahre mehr über den Vertrag von InvocationHandler.invoke, seine Argumente, Einschränkungen für Rückgabewerte und Ausnahmen sowie den Umgang mit Object-Methoden.

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

Syntax

Object invoke(Object proxy, Method method, Object[] args) throws Throwable

java.lang.reflect.InvocationHandler behandelt Aufrufe an einem dynamischen Proxy, der mit Proxy.newProxyInstance erstellt wurde. Der Proxy implementiert die angegebenen Schnittstellen; er ermöglicht keine beliebige Klassenvererbung. Ein Handler kann Ergebnisse liefern, ohne dass ein separates Zielobjekt erforderlich ist.

InvocationHandler.invoke erhält proxy, die Methodenbeschreibung method und ein args-Array (null bei einer Methode ohne Parameter). Primitive Argumente werden verpackt. Hat die Proxy-Methode einen primitiven Rückgabetyp, muss der Handler das entsprechende Wrapper-Objekt zurückgeben; null führt zu einer NullPointerException. Bei einem Referenztyp ist null zulässig. In beiden Fällen führt ein Ergebnis ungleich null mit einem inkompatiblen Typ zu einer ClassCastException. Bei einer Proxy-Methode mit Rückgabetyp void wird das Ergebnis des Handlers verworfen.

Eine nicht deklarierte geprüfte Ausnahme wird in UndeclaredThrowableException verpackt. Auch Aufrufe von equals, hashCode und toString erreichen den Handler. Rufe die abgefangene Methode nicht erneut auf proxy auf: Das kann zu Rekursion führen. Auch Default-Methoden laufen über den Handler; ihre Implementierungen lassen sich mit InvocationHandler.invokeDefault aufrufen.

Das Beispiel definiert das Verhalten für Greeting und die drei Object-Methoden. Es behandelt bewusst eine einzelne Schnittstelle und bietet keine allgemeine Delegation. Geltungsbereich: Java SE 21; die Laufzeitumgebung des Repositorys bestätigt nicht die Produktionslaufzeit.

Beispiele

import java.lang.reflect.InvocationHandler;
import java.lang.reflect.Proxy;

public class Main {
    public interface Greeting {
        String greet(String name);
    }

    public static void main(String[] args) {
        InvocationHandler handler = (proxy, method, arguments) -> {
            if (method.getDeclaringClass() == Object.class) {
                return switch (method.getName()) {
                    case "equals" -> proxy == arguments[0];
                    case "hashCode" -> System.identityHashCode(proxy);
                    case "toString" -> "GreetingProxy";
                    default -> throw new UnsupportedOperationException(method.getName());
                };
            }
            return "Hello, " + arguments[0];
        };

        Greeting greeting = (Greeting) Proxy.newProxyInstance(
                Greeting.class.getClassLoader(),
                new Class<?>[] { Greeting.class }, handler);

        System.out.println(greeting.greet("Ada"));
        System.out.println(greeting);
    }
}

Ergebnis

Hello, Ada
GreetingProxy

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen