org.nanoj.injector.impl

Class InjectorImpl

java.lang.Object

org.nanoj.injector.impl.InjectorImpl

All Implemented Interfaces:

Injector

public class InjectorImpl
extends Object
implements Injector

Injector implementation. A container managing dynamically components with basic "Dependency Injection"
It injects dependencies using the components constructors
NB : each component managed by this type of container is supposed to have only one constructor
If a component has multiple constructors, they are searched in the following order :
1/ the default constructor
2/ if no default constructor, the first other constructor found (with parameters)

Author:

Laurent Guerin

Constructor Summary

Constructors

Constructor and Description
InjectorImpl(String name, HashMap<Class<?>,Class<?>> implementationClasses, String[] implementationConventions, HashMap<Class<?>,javax.inject.Provider<?>> implementationProviders, InterceptorProvider[] interceptorProviders) Constructor

Method Summary

Methods

Modifier and Type	Method and Description
protected String	getClassName(String sFullClassName) Returns the "class name" of the given full class name e.g. returns "String" for "java.lang.String"
protected <T> T	getComponentInstance(Class<T> componentClass) Returns a component instance for the given class If the given class is an interface the implementation is returned.
<T> T	getInstance(Class<T> clazz)
InterceptorProvider[]	getInterceptorProviders()
String	getName()
protected String	getPackageName(String sFullClassName) Returns the "package name" of the given class name e.g. returns "java.lang" for "java.lang.String"
protected boolean	isMonoInstance(Class<?> cl) Returns a boolean value indicating if the given component is "mono-instance" or not By default it returns TRUE if the given class has an annotation ending with "Singleton" This method can be overridden in the sub-class if necessary
protected boolean	isMonoInstanceByAnnotation(Class<?> componentClass)
protected boolean	isMonoInstanceByAnnotation(Class<?> componentClass, Class<?> annotationClass) Method designed to be used in the "isMonoInstance" concrete method.
protected boolean	isMonoInstanceByBooleanStaticField(Class<?> componentClass, String fieldName) Method designed to be used in the "isMonoInstance" concrete method.
protected boolean	isMonoInstanceByInterface(Class<?> componentClass, Class<?> monoInstanceInterface) Method designed to be used in the "isMonoInstance" concrete method.
void	printAllComponents(PrintStream out) Utility method to print all the container's components

Methods inherited from class java.lang.Object

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

Constructor Detail

InjectorImpl

public InjectorImpl(String name,
            HashMap<Class<?>,Class<?>> implementationClasses,
            String[] implementationConventions,
            HashMap<Class<?>,javax.inject.Provider<?>> implementationProviders,
            InterceptorProvider[] interceptorProviders)

Constructor

Parameters:

name -

implementationClasses -

implementationConventions -

implementationProviders -

interceptorProviders -

Method Detail

getName

public String getName()

Specified by:

getName in interface Injector

getInterceptorProviders

public InterceptorProvider[] getInterceptorProviders()

Specified by:

getInterceptorProviders in interface Injector

getInstance

public <T> T getInstance(Class<T> clazz)

Specified by:

getInstance in interface Injector

getComponentInstance

protected <T> T getComponentInstance(Class<T> componentClass)

Returns a component instance for the given class
If the given class is an interface the implementation is returned.
The convention to find the implementation is defined in the "getImplementationClassName"
method defined in the subclass.

Parameters:

componentClass - the requested component class or interface

Returns:

the component concrete class

isMonoInstance

protected boolean isMonoInstance(Class<?> cl)

Returns a boolean value indicating if the given component is "mono-instance" or not
By default it returns TRUE if the given class has an annotation ending with "Singleton"
This method can be overridden in the sub-class if necessary

Parameters:

cl -

Returns:

getClassName

protected String getClassName(String sFullClassName)

Returns the "class name" of the given full class name
e.g. returns "String" for "java.lang.String"

Parameters:

sFullClassName -

Returns:

getPackageName

protected String getPackageName(String sFullClassName)

Returns the "package name" of the given class name
e.g. returns "java.lang" for "java.lang.String"

Parameters:

sFullClassName -

Returns:

printAllComponents

public void printAllComponents(PrintStream out)

Utility method to print all the container's components

Specified by:

printAllComponents in interface Injector

Parameters:

out -

isMonoInstanceByInterface

protected boolean isMonoInstanceByInterface(Class<?> componentClass,
                                Class<?> monoInstanceInterface)

Method designed to be used in the "isMonoInstance" concrete method.
Returns true if the given component class implements the given interface used as a "mono-instance" marker

Parameters:

componentClass - the component class to introspect

monoInstanceInterface - the class of the interface used as a marker

Returns:

isMonoInstanceByBooleanStaticField

protected boolean isMonoInstanceByBooleanStaticField(Class<?> componentClass,
                                         String fieldName)

Method designed to be used in the "isMonoInstance" concrete method.
Returns "true" if there's a public static boolean field initialized to "true" in the class.
Returns "false" in all other cases : field not found, or not accessible, or initialized to "false"

Parameters:

componentClass - the component class to introspect

fieldName - the name of the field used as a marker
( searched as a public static boolean field initialized to "true" )

Returns:

isMonoInstanceByAnnotation

protected boolean isMonoInstanceByAnnotation(Class<?> componentClass,
                                 Class<?> annotationClass)

Method designed to be used in the "isMonoInstance" concrete method.
Returns true if the given component class is marked with the given annotation

Parameters:

componentClass - the component class to introspect

annotationClass - the annotation to be searched

Returns:

isMonoInstanceByAnnotation

protected boolean isMonoInstanceByAnnotation(Class<?> componentClass)