net.sf.jkniv.reflect.beans

Interface ObjectProxy<T>

Type Parameters:

T - Type of class to be instanced

public interface ObjectProxy<T>

Utility interface to work with object reflection

Author:

Alisson Gomes

Method Summary

Modifier and Type	Method and Description
T	from(Object o) copy all data from properties started with get or is to instance of this proxy
<T extends Annotation> T	getAnnotationField(Class<? extends Annotation> annotation, String fieldName) check if this proxy class has annotation for a method name
<T extends Annotation> T	getAnnotationMethod(Class<? extends Annotation> annotation, String methodName, Class<?>... paramTypes) check if this proxy class has annotation for a method name
Field	getDeclaredField(String name) get the Field declared by the class or sub-class represented by this proxy
Method	getDeclaredMethod(String name) get the Method declared by the class or sub-class represented by this proxy
T	getInstance()
List<Method>	getMethodsAnnotatedWith(Class<? extends Annotation> annotation) Retrieve all public methods annotated with annotation
Class<T>	getTargetClass()
boolean	hasAnnotation(Class<? extends Annotation> annotation) check if this proxy class has annotation
boolean	hasAnnotation(String annotation) check if this proxy class has annotation
boolean	hasInstance() check if instance exists
boolean	hasMethod(String methodName) check if class has a methodName to be invoked.
Object	invoke(Method method, Object... args)
Object	invoke(String methodName, Object... args)
boolean	isInstanceof(Class<?> clazz)
T	merge(Object o) merge all data from properties started with get or is to instance of this proxy
ObjectProxy<T>	mute(Class<? extends Exception> ex) When the proxy catch a Exception to handler by ReflectionException a mute rule is used to not throw the exception.
T	newInstance() build a new instance using constructor with arguments types or default
void	register(TranslateType cast, Class type)
void	setConstructorArgs(Object... constructorArgs) Arguments to build object using contructor
void	setConstructorTypes(Class<?>... contructorTypes) Sequential type arguments from constructor
ObjectProxy<T>	with(HandleableException handle)

Method Detail

setConstructorArgs

void setConstructorArgs(Object... constructorArgs)

Arguments to build object using contructor

Parameters:

constructorArgs - argument values

setConstructorTypes

void setConstructorTypes(Class<?>... contructorTypes)

Sequential type arguments from constructor

Parameters:

contructorTypes - type of arguments

Throws:

ReflectionException - if some type is null

newInstance

T newInstance()

build a new instance using constructor with arguments types or default

Returns:

a new instance of object, throws exception if an instance already exists

Throws:

ReflectionException - if an instance already exists

hasInstance

boolean hasInstance()

check if instance exists

Returns:

true when instance exists, false otherwise

isInstanceof

boolean isInstanceof(Class<?> clazz)

hasMethod

boolean hasMethod(String methodName)

check if class has a methodName to be invoked.

Parameters:

methodName - complete method name like isDeleted, setName...

Returns:

true when the class has the name, false otherwise

getInstance

T getInstance()

getTargetClass

Class<T> getTargetClass()

invoke

Object invoke(String methodName,
              Object... args)

invoke

Object invoke(Method method,
              Object... args)

from

T from(Object o)

copy all data from properties started with get or is to instance of this proxy

Parameters:

o - origin object data

Returns:

instance of object from proxy with the data from o

Throws:

ReflectionException - when some wrong occurs

merge

T merge(Object o)

merge all data from properties started with get or is to instance of this proxy

Parameters:

o - origin object data

Returns:

instance of object from proxy with the data from o

Throws:

ReflectionException - when some wrong occurs

mute

ObjectProxy<T> mute(Class<? extends Exception> ex)

When the proxy catch a Exception to handler by ReflectionException a mute rule is used to not throw the exception.

Parameters:

ex - exception class type

Returns:

this instance

hasAnnotation

boolean hasAnnotation(String annotation)

check if this proxy class has annotation

Parameters:

annotation - name of annotation

Returns:

true when the class has this annotation, false otherwise

hasAnnotation

boolean hasAnnotation(Class<? extends Annotation> annotation)

check if this proxy class has annotation

Parameters:

annotation - name of annotation

Returns:

true when the class has this annotation, false otherwise

getMethodsAnnotatedWith

List<Method> getMethodsAnnotatedWith(Class<? extends Annotation> annotation)

Retrieve all public methods annotated with annotation

Parameters:

annotation - looked for

Returns:

a list of all public methods annotated with annotation or empty list otherwise.

getAnnotationMethod

<T extends Annotation> T getAnnotationMethod(Class<? extends Annotation> annotation,
                                             String methodName,
                                             Class<?>... paramTypes)

check if this proxy class has annotation for a method name

Type Parameters:

T - generic type to return

Parameters:

annotation - name of the annotation

methodName - name of the method

paramTypes - type of parameters

Returns:

the Annotation instance or null if not found

Throws:

ReflectionException - when the methodName not exists

getAnnotationField

<T extends Annotation> T getAnnotationField(Class<? extends Annotation> annotation,
                                            String fieldName)

check if this proxy class has annotation for a method name

Type Parameters:

T - generic type to return

Parameters:

annotation - name of the annotation

fieldName - attribute name

Returns:

the Annotation instance or null if not found

Throws:

ReflectionException - when the attributeName not exists

getDeclaredField

Field getDeclaredField(String name)

get the Field declared by the class or sub-class represented by this proxy

Parameters:

name - field to looking for

Returns:

the Field instance or null if not found

getDeclaredMethod

Method getDeclaredMethod(String name)

get the Method declared by the class or sub-class represented by this proxy

Parameters:

name - method to looking for

Returns:

the Method instance or null if not found

with

ObjectProxy<T> with(HandleableException handle)

register

void register(TranslateType cast,
              Class type)