net.openhft.chronicle.core.util

Class AbstractInvocationHandler

java.lang.Object

net.openhft.chronicle.core.util.AbstractInvocationHandler

All Implemented Interfaces:

InvocationHandler

public abstract class AbstractInvocationHandler
extends Object
implements InvocationHandler

Abstract base class for invocation handlers, which provides a mechanism for dynamically dispatching method calls to arbitrary targets.

Subclasses should override the doInvoke(Object, Method, Object[]) method to provide custom handling for method invocations.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractInvocationHandler(Type definedClass) Constructs a new invocation handler for the specified type.

Method Summary

Modifier and Type	Method and Description
protected abstract Object	doInvoke(Object proxy, Method method, Object[] args) Handles the actual invocation of the method.
Object	invoke(Object proxy, Method method, Object[] args) Handles method invocations on proxy instances.
void	onClose(Closeable closeable) Sets a Closeable that should be called when close() is called on this invocation handler.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AbstractInvocationHandler

protected AbstractInvocationHandler(Type definedClass)

Constructs a new invocation handler for the specified type.

Parameters:

definedClass - The type for which the invocation handler is defined.

Method Detail

invoke

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

Handles method invocations on proxy instances.

Specified by:

invoke in interface InvocationHandler

Parameters:

proxy - The proxy instance.

method - The method being called.

args - The arguments for the method call.

Returns:

The result from the method call.

Throws:

Throwable - if an error occurs during method invocation.

doInvoke

protected abstract Object doInvoke(Object proxy,
                                   Method method,
                                   Object[] args)
                            throws InvocationTargetException,
                                   IllegalAccessException,
                                   IllegalStateException,
                                   BufferOverflowException,
                                   BufferUnderflowException,
                                   IllegalArgumentException,
                                   ArithmeticException,
                                   InvalidMarshallableException

Handles the actual invocation of the method. This method should be overridden by subclasses to implement custom invocation behavior.

Parameters:

proxy - The proxy instance.

method - The method being called.

args - The arguments for the method call.

Returns:

The result of the method invocation.

Throws:

InvocationTargetException - if the method being called throws an exception.

IllegalAccessException - if this InvocationHandler does not have access to the method.

IllegalStateException - if the proxy is in an inappropriate state for the method call.

BufferOverflowException - if the buffer overflows during method invocation.

BufferUnderflowException - if the buffer underflows during method invocation.

IllegalArgumentException - if the method receives illegal arguments.

ArithmeticException - if an arithmetic exception occurs during method invocation.

InvalidMarshallableException - if the object being marshaled is invalid.

onClose

public void onClose(Closeable closeable)

Sets a Closeable that should be called when close() is called on this invocation handler.

Parameters:

closeable - The Closeable to be invoked when close() is called.