org.jboss.proxy.compiler
Interface InvocationHandler

All Known Subinterfaces:
Proxies.ProxyInvocationHandler
All Known Implementing Classes:
EntityBridgeInvocationHandler

public interface InvocationHandler

An invoker is a target of method calls, where the calls are expressed not as primitive Java method invocations, but according to the conventions of the Core Reflection API. Invokers are designed to be used along with the Core Reflection API.

The Invoker.invoke operation is similar to java.lang.reflect.Method.invoke, except that the object (or objects) which receives the message is hidden behind the invoker. Also, unlike Method.invoke, the action of the Invoker.invoke operation is completely under programmer control, because Invoker.invoke is an interface method, not a native method.

You can wrap an invoker around an object so that the invoker passes all method calls down to the object. Such an invoker is called a proxy invoker for that object.

You can also wrap a new object around an invoker, so that the object implements some given interface (or interfaces), and passes all method calls up to the invoker. Such an object is called a proxy target object for that invoker.

You can do more complex tasks with invokers, such as passing each method call through a network connection before it reaches its target object. You can also filter or replicate method invocations. You can even execute the the invocations interpretively, without ever calling the method on a "real" Java object.

Version:
$Revision: 1.1.26.1 $
Author:
Unknown
See Also:
Method.invoke(java.lang.Object, java.lang.Object...), Invoker#invoke, Proxies#newInvoker, Proxies.newTarget(java.lang.ClassLoader, org.jboss.proxy.compiler.InvocationHandler, java.lang.Class[])

Method Summary
 Object invoke(Object dummy, Method method, Object[] args)
          Processes a method invocation on a proxy instance and returns the result.
 

Method Detail

invoke

Object invoke(Object dummy,
              Method method,
              Object[] args)
              throws Throwable
Processes a method invocation on a proxy instance and returns the result.

Parameters:
dummy - ???
method - The method instance corresponding to the interface method invoked on the proxy instance.
args - An array of objects containing the values of the arguments passed in the method invocation on the proxy instance, or null if interface method takes no arguments.
Returns:
The value to return from the method invocation on the proxy instance.
Throws:
Throwable - The exception to throw from the method invocation on the proxy instance.


Copyright © 2002 JBoss Group, LLC. All Rights Reserved.