loci.utils

Class ProtectedMethodInvoker

java.lang.Object

loci.utils.ProtectedMethodInvoker

public class ProtectedMethodInvoker
extends Object

This class contains useful methods for executing protected methods via reflection. Use the invokeProtected method to find and execute the target method within a source object. Use the unwrapException method to test any thrown exception for a match to a known throwable.

Author:

Mark Hiner hinerm at gmail.com

Constructor Summary

Constructors

Constructor and Description
ProtectedMethodInvoker()

Method Summary

Methods

Modifier and Type	Method and Description
Object	invokeProtected(Object source, String methodName, Class<?>[] paramTypes, Object[] args) This method attempts to invoke the provided methodName within the source object.
<T extends Throwable> void	unwrapException(Throwable t, Class<T> exceptionType) This method checks whether the Throwable t is an instance of the provided exceptionType.

Methods inherited from class java.lang.Object

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

Constructor Detail

ProtectedMethodInvoker

public ProtectedMethodInvoker()

Method Detail

unwrapException

public <T extends Throwable> void unwrapException(Throwable t,
                                         Class<T> exceptionType)
                     throws T extends Throwable

This method checks whether the Throwable t is an instance of the provided exceptionType. This can be used to check an InvocationTargetException returned by invokeProtected for known exception types that can be re-thrown properly.

Parameters:

t -

exceptionType -

Throws:

T

T extends Throwable

invokeProtected

public Object invokeProtected(Object source,
                     String methodName,
                     Class<?>[] paramTypes,
                     Object[] args)
                       throws InvocationTargetException

This method attempts to invoke the provided methodName within the source object. paramTypes is an array of the classes for the method's parameters, and args is an array of the actual objects to be passed as parameters. The return value is an object wrapping of the target method's return value.

Parameters:

source -

methodName -

paramTypes -

args -

Throws:

InvocationTargetException