org.fuin.ddd4j.ddd

Class MethodExecutor

java.lang.Object

org.fuin.ddd4j.ddd.MethodExecutor

@ThreadSafe
public final class MethodExecutor
extends java.lang.Object

Lightweight utility class to execute a method using reflection.

Constructor Summary

Constructors

Constructor and Description
MethodExecutor()

Method Summary

Modifier and Type	Method and Description
java.lang.reflect.Method	findDeclaredAnnotatedMethod(@NotNull java.lang.Object obj, @NotNull java.lang.Class<? extends java.lang.annotation.Annotation> annotationType, java.lang.Class<?>... expectedArgumentTypes) Finds a declared method on the instance or it's parents that has an annotation and optional parameters.
java.util.List<java.lang.reflect.Method>	getDeclaredMethodsIncludingSuperClasses(@NotNull java.lang.Class<?> clasz, java.lang.Class<?>... stopParents) Returns a list of declared methods from classes and super classes.
<T> T	invoke(@NotNull java.lang.reflect.Method method, @NotNull java.lang.Object target, java.lang.Object... args) Invokes a method with any number of arguments.
<T> T	invokeDeclaredAnnotatedMethod(@NotNull java.lang.Object obj, @NotNull java.lang.Class<? extends java.lang.annotation.Annotation> annotationType, java.lang.Class<?>[] argumentTypes, java.lang.Object[] arguments) Finds a declared method that has an annotation and optional parameters.
boolean	same(java.lang.Class<?>[] expected, java.lang.Class<?>[] actual) Verifies if both arrays have the same length and types.

Methods inherited from class java.lang.Object

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

Constructor Detail

MethodExecutor

public MethodExecutor()

Method Detail

invokeDeclaredAnnotatedMethod

public final <T> T invokeDeclaredAnnotatedMethod(@NotNull
                                                 @NotNull java.lang.Object obj,
                                                 @NotNull
                                                 @NotNull java.lang.Class<? extends java.lang.annotation.Annotation> annotationType,
                                                 java.lang.Class<?>[] argumentTypes,
                                                 java.lang.Object[] arguments)

Finds a declared method that has an annotation and optional parameters.

Type Parameters:

T - Type of the return value.

Parameters:

obj - Object to inspect.

annotationType - Expected annotation type.

argumentTypes - Expected argument types, empty array or null.

arguments - Arguments, empty array or null. Must be the same size as 'argumentTypes'.

Returns:

Value returned by the method or null.

findDeclaredAnnotatedMethod

public final java.lang.reflect.Method findDeclaredAnnotatedMethod(@NotNull
                                                                  @NotNull java.lang.Object obj,
                                                                  @NotNull
                                                                  @NotNull java.lang.Class<? extends java.lang.annotation.Annotation> annotationType,
                                                                  java.lang.Class<?>... expectedArgumentTypes)

Finds a declared method on the instance or it's parents that has an annotation and optional parameters. The class

Parameters:

obj - Object to inspect.

annotationType - Expected annotation type.

expectedArgumentTypes - Expected argument types, empty array or null.

Returns:

Method or null if any of the expected parameters does not match.

getDeclaredMethodsIncludingSuperClasses

public final java.util.List<java.lang.reflect.Method> getDeclaredMethodsIncludingSuperClasses(@NotNull
                                                                                              @NotNull java.lang.Class<?> clasz,
                                                                                              @NotNull
                                                                                              java.lang.Class<?>... stopParents)

Returns a list of declared methods from classes and super classes. The given stop classes will not be inspected.

Parameters:

clasz - Class to inspect.

stopParents - Parent classes to stop inspection or null to stop at Object.

Returns:

List of methods.

invoke

public final <T> T invoke(@NotNull
                          @NotNull java.lang.reflect.Method method,
                          @NotNull
                          @NotNull java.lang.Object target,
                          java.lang.Object... args)

Invokes a method with any number of arguments.

Type Parameters:

T - Type of the return value.

Parameters:

method - Method to call.

target - Object that contains the method.

args - Arguments, empty array or null.

Returns:

Value returned by the method or null.

same

public final boolean same(java.lang.Class<?>[] expected,
                          java.lang.Class<?>[] actual)

Verifies if both arrays have the same length and types.

Parameters:

expected - Expected types, empty array or null.

actual - Actual types, empty array or null.

Returns:

TRUE if both arguments match.