База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

InvocationHandler — обработване на извиквания към динамичен прокси

InvocationHandler определя поведението на методите на динамичен прокси. Научете за договора на InvocationHandler.invoke, аргументите му, ограниченията за върнатите стойности и изключенията, както и обработването на методите на Object.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

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

java.lang.reflect.InvocationHandler обработва извикванията към динамичен прокси, създаден чрез Proxy.newProxyInstance. Проксито имплементира зададените интерфейси; то не осигурява произволно наследяване на класове. Handler може да предоставя резултати без отделен целеви обект.

InvocationHandler.invoke получава proxy, описанието на метода method и масив args (null за метод без параметри). Примитивните аргументи се опаковат в обекти. Ако методът на проксито има примитивен тип на връщане, обработчикът трябва да върне съответния обект-обвивка; връщането на null причинява NullPointerException. При референтен тип на връщане null е допустима стойност. И в двата случая резултат, различен от null, с несъвместим тип причинява ClassCastException. Ако методът на проксито има тип на връщане void, резултатът от обработчика се игнорира.

Недекларирано проверявано изключение се обвива в UndeclaredThrowableException. Извикванията на equals, hashCode и toString също достигат до handler. Не извиквайте отново прихванатия метод върху proxy: това крие риск от рекурсия. Методите по подразбиране също минават през handler; техните имплементации могат да бъдат извикани чрез InvocationHandler.invokeDefault.

Примерът задава поведение за Greeting и трите метода на Object. Умишлено обработва един интерфейс, вместо да предоставя делегиране с общо предназначение. Обхват: Java SE 21; средата за изпълнение на хранилището не удостоверява продукционната среда.

Примери

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

Резултат

Hello, Ada
GreetingProxy

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници