Since: API Level 1
public interface

InvocationHandler

java.lang.reflect.InvocationHandler

Class Overview

Implementors of this interface dispatch methods invoked on proxy instances.

See Also

Summary

Public Methods
abstract Object invoke(Object proxy, Method method, Object[] args)
Handles the method which was originally invoked on the proxy instance.

Public Methods

public abstract Object invoke (Object proxy, Method method, Object[] args)

Since: API Level 1

Handles the method which was originally invoked on the proxy instance. A typical usage pattern follows below:

 public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
     //do some processing before the method invocation
 
     //invoke the method
     Object result = method.invoke(proxy, args);
 
     //do some processing after the method invocation
     return result;
 }

Parameters
proxy the proxy instance on which the method was invoked
method the method invoked on the proxy instance
args an array of objects containing the parameters passed to the method, or null if no arguments are expected. Primitive types are wrapped in the appropriate wrapper type
Returns
  • the result of executing the method. Primitive types need to be wrapped in the appropriate wrapper type
Throws
Throwable the exception to throw from the invoked method on the proxy. The exception must match one of the declared exception types of the invoked method or any unchecked exception type. If not then an UndeclaredThrowableException is thrown