com.levigo.jadice.document.config
Class Jadice

java.lang.Object
  com.levigo.jadice.document.config.Jadice

public class Jadice
extends Object

Helper methods for object creation and configuration. The methods supplied by this class are mainly used by jadice components internally; however, they can be helpful in a few advanced integration scenarios.

Method Summary

static void	configure(Object instance) Apply all registered and applicable ComponentConfigurers to an object.
static <C> C	create(Class<C> componentClass) Create a new instance of the given type and apply the ComponentConfigurers pertaining to it.
static Resolver<Class<?>,ClassNotFoundException>	getClassResolver() Gets the Resolver to be used by jadice components when looking up Class instances based on their name.
static void	purgeComponentConfigurers() Remove all registered ComponentConfigurer instances.
static void	registerComponentConfigurer(ComponentConfigurer<? extends Object> cc, Class<?>... supportedClasses) Add a ComponentConfigurer to the collection of configurers which are invoked by configure(Object), if applicable.
static void	setClassResolver(Resolver<Class<?>,ClassNotFoundException> resolver) Set the Resolver to be used by jadice compontents when looking up Class instances based on their name.

Methods inherited from class java.lang.Object

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

Method Detail

purgeComponentConfigurers

public static void purgeComponentConfigurers()

Remove all registered ComponentConfigurer instances.

See Also:

registerComponentConfigurer(ComponentConfigurer, Class...)

registerComponentConfigurer

public static void registerComponentConfigurer(ComponentConfigurer<? extends Object> cc,
                                               Class<?>... supportedClasses)

Add a ComponentConfigurer to the collection of configurers which are invoked by configure(Object), if applicable.

Parameters:

cc - the instance to be registered

supportedClasses - the type (or types) of classes which this ComponentConfigurer is able to configure

create

public static <C> C create(Class<C> componentClass)

Create a new instance of the given type and apply the ComponentConfigurers pertaining to it.

Parameters:

componentClass - the class to be instantiated

Returns:

a new instance of the requested type, readily configured.

Throws:

IllegalArgumentException - if instantiation is not possible due to various reasons, such as Illegal Access or a non-instantiable kind of class

configure

public static void configure(Object instance)

Apply all registered and applicable ComponentConfigurers to an object. A ComponentConfigurer is applicable if the type of object which it is able to configure matches the given instance's type.

Parameters:

instance - the object to be configured

getClassResolver

public static Resolver<Class<?>,ClassNotFoundException> getClassResolver()

Gets the Resolver to be used by jadice components when looking up Class instances based on their name.

Returns:

the Resolver to be used by jadice components when looking up Class instances based on their name.

setClassResolver

public static void setClassResolver(Resolver<Class<?>,ClassNotFoundException> resolver)

Set the Resolver to be used by jadice compontents when looking up Class instances based on their name. Setting a custom resolver is only needed in very few advanced integration scenarios.

Parameters:

resolver - the Resolver to be used from now on