net.sf.juffrou.util.reflect

Class BeanWrapperFactory

java.lang.Object

net.sf.juffrou.util.reflect.BeanWrapperFactory

public class BeanWrapperFactory
extends Object

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
BeanWrapperFactory()

Method Summary

Methods

Modifier and Type	Method and Description
protected BeanInstanceBuilder	getBeanInstanceBuilder()
BeanWrapper	getBeanWrapper(Class clazz) Construct a bean wrapper around a class.
BeanWrapper	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

BeanWrapperFactory

public BeanWrapperFactory()

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.

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.

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 BeanWrapper 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.

Parameters:

clazz - class to instantiate the wrapped bean

getBeanWrapper

public BeanWrapper getBeanWrapper(Object instance)

Construct a bean wrapper around an existing bean instance.

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

Parameters:

instance - the bean object to be wrapped

getBeanInstanceBuilder

protected BeanInstanceBuilder getBeanInstanceBuilder()

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 -