org.jboss.weld.bean.proxy.MethodHandler Maven / Gradle / Ivy

Go to download
package org.jboss.weld.bean.proxy;

import java.lang.reflect.Method;

/**
 * The interface implemented by the invocation handler of a proxy
 * instance.
 *
 */
public interface MethodHandler {
    /**
     * Is called when a method is invoked on a proxy instance associated
     * with this handler. This method must process that method invocation.
     *
     * @param self the proxy instance.
     * @param thisMethod the overridden method declared in the super
     *        class or interface.
     * @param proceed the forwarder method for invoking the overridden
     *        method. It is null if the overridden method is
     *        abstract or declared in the interface.
     * @param args an array of objects containing the values of
     *        the arguments passed in the method invocation
     *        on the proxy instance. If a parameter type is
     *        a primitive type, the type of the array element
     *        is a wrapper class.
     * @return the resulting value of the method invocation.
     *
     * @throws Throwable if the method invocation fails.
     */
    Object invoke(Object self, Method thisMethod, Method proceed,
            Object[] args) throws Throwable;
}