net.sf.juffrou.reflect

Class CustomizableBeanWrapperFactory

java.lang.Object

net.sf.juffrou.reflect.CustomizableBeanWrapperFactory

All Implemented Interfaces:

BeanWrapperFactory

public class CustomizableBeanWrapperFactory
extends Object
implements BeanWrapperFactory

This class is responsible for creating and caching BeanWrapperContexts.

A BeanWrapper uses the same BeanWrapperFactory to create the BeanWrapperContexts for its nested BeanWrappers. BeanWrapperFactory can also be used as an umbrella to create BeanWrappers in a more performant way as it caches the introspection information and re-uses it whenever possible.

Author:

cemartins

Constructor Summary

Constructors

Constructor and Description
CustomizableBeanWrapperFactory()

Method Summary

Methods

Modifier and Type	Method and Description
BeanInstanceBuilder	getBeanInstanceBuilder()
JuffrouBeanWrapper	getBeanWrapper(Class clazz) Construct a bean wrapper around a class.
JuffrouBeanWrapper	getBeanWrapper(Object instance) Construct a bean wrapper around an existing bean instance.
BeanWrapperContext	getBeanWrapperContext(Class clazz) Retrieves a BeanWrapperContext for java bean class.
BeanWrapperContext	getBeanWrapperContext(Class clazz, Type... types) Retrieves a BeanWrapperContext for a parameterized (generic) java bean class.
void	setBeanContextBuilder(BeanContextBuilder beanContextBuilder) Control the creation of BeanWrapperContexts.
void	setBeanInstanceBuilder(BeanInstanceBuilder beanInstanceBuilder) Control the instantiation of beans and wrapped beans.

Methods inherited from class java.lang.Object

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

Constructor Detail

CustomizableBeanWrapperFactory

public CustomizableBeanWrapperFactory()

Method Detail

getBeanWrapperContext

public BeanWrapperContext getBeanWrapperContext(Class clazz)

Retrieves a BeanWrapperContext for java bean class.

If the BeanWrapperContext is not in cache then creates a new one.

Specified by:

getBeanWrapperContext in interface BeanWrapperFactory

Parameters:

clazz - the bean class to inspect

Returns:

a BeanWrapperContext with introspection information about the specified class.

See Also:

#getBeanWrapperContext(Class, Type...)}

getBeanWrapperContext

public BeanWrapperContext getBeanWrapperContext(Class clazz,
                                       Type... types)

Retrieves a BeanWrapperContext for a parameterized (generic) java bean class.

If the BeanWrapperContext is not in cache then creates a new one.

Specified by:

getBeanWrapperContext in interface BeanWrapperFactory

Parameters:

clazz - the generic bean class to inspect.

types - the parameters that defined the generic bean class.

Returns:

a BeanWrapperContext with introspection information about the specified class.

getBeanWrapper

public JuffrouBeanWrapper getBeanWrapper(Class clazz)

Construct a bean wrapper around a class.

Bean instances will be instances of that class and will be created only when necessary.
Try to use a cached BeanWrapperContext to save introspection time.

Specified by:

getBeanWrapper in interface BeanWrapperFactory

Parameters:

clazz - class to instantiate the wrapped bean

getBeanWrapper

public JuffrouBeanWrapper getBeanWrapper(Object instance)

Construct a bean wrapper around an existing bean instance.

Will try to use a cached BeanWrapperContext to save introspection time.

Specified by:

getBeanWrapper in interface BeanWrapperFactory

Parameters:

instance - the bean object to be wrapped

getBeanInstanceBuilder

public BeanInstanceBuilder getBeanInstanceBuilder()

Specified by:

getBeanInstanceBuilder in interface BeanWrapperFactory

setBeanInstanceBuilder

public void setBeanInstanceBuilder(BeanInstanceBuilder beanInstanceBuilder)

Control the instantiation of beans and wrapped beans.

The bean wrapper creates new instances using Class.newIntance() by default. You can use this this if you want to create class instances yourself.

Parameters:

beanInstanceBuilder -

setBeanContextBuilder

public void setBeanContextBuilder(BeanContextBuilder beanContextBuilder)

Control the creation of BeanWrapperContexts.

Provide a custom BeanContextBuilder that will instantiate your custom BeanWrapperContext. This way you can extend the BeanWrapperContext class and attach more information to a bean.

Parameters:

beanContextBuilder -