InvocationHandler (JBoss Server API) - JBoss 4.0.1 sp1 server API Documentation 英文版文档

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

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 $
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

public 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.