org.labcrypto.avicenna

Class Avicenna

java.lang.Object

org.labcrypto.avicenna.Avicenna

public class Avicenna
extends Object

Main class for loading dependencies and injection purposes. This class should be used statically. It will extract Dependency references from DependencyFactory objects and inject them into fields annotated by InjectHere.

Author:

Kamran Amini kam.cpp@gmail.com

See Also:

Dependency, DependencyFactory, InjectHere

Constructor Summary

Constructors

Constructor and Description
Avicenna()

Method Summary

Modifier and Type	Method and Description
static void	addDependencyFactory(Class... dependencyFactoryClasses) Adds classes annotated by DependencyFactory.
static void	addDependencyFactory(Object... dependencyFactories) Adds objects annotated by DependencyFactory.
static void	clear() Clears the container.
static <T> void	defineDependency(Class<T> clazz, Collection<String> qualifiers, T dependency) Adds a direct mapping between a type and an object.
static <T> void	defineDependency(Class<T> clazz, T dependency) Adds a direct mapping between a type and an object.
static <T> T	get(Class<T> clazz) Retrieves a stored dependnecy using class object and qualifiers.
static <T> T	get(Class<T> clazz, Collection<String> qualifiers) Retrieves a stored dependnecy using class object and qualifiers.
static void	inject(Object... objects) Whenever this method is called, all objects in input argument are searched for annotated fields.

Methods inherited from class java.lang.Object

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

Constructor Detail

Avicenna

public Avicenna()

Method Detail

addDependencyFactory

public static void addDependencyFactory(Class... dependencyFactoryClasses)

Adds classes annotated by DependencyFactory. Added class has some methods or fields which supplied dependencies.

Parameters:

dependencyFactoryClasses - An object annotated by DependencyFactory.

addDependencyFactory

public static void addDependencyFactory(Object... dependencyFactories)

Adds objects annotated by DependencyFactory. Added object has some methods or fields which supplied dependencies.

Parameters:

dependencyFactories - An object annotated by DependencyFactory.

inject

public static void inject(Object... objects)

Whenever this method is called, all objects in input argument are searched for annotated fields. Then, the fields are injected by dependency objects.

Parameters:

objects - List of objects which they should be injected.

clear

public static void clear()

Clears the container.

defineDependency

public static <T> void defineDependency(Class<T> clazz,
                                        T dependency)

Adds a direct mapping between a type and an object.

Parameters:

clazz - Class type which should be injected.

dependency - Dependency reference which should be copied to injection targets.

defineDependency

public static <T> void defineDependency(Class<T> clazz,
                                        Collection<String> qualifiers,
                                        T dependency)

Adds a direct mapping between a type and an object.

Parameters:

clazz - Class type which should be injected.

qualifiers - Qualifiers to distinguish between similar types.

dependency - Dependency reference which should be copied to injection targets.

get

public static <T> T get(Class<T> clazz)

Retrieves a stored dependnecy using class object and qualifiers.

Parameters:

clazz - Class type which its related dependency reference should be retrieved.

get

public static <T> T get(Class<T> clazz,
                        Collection<String> qualifiers)

Retrieves a stored dependnecy using class object and qualifiers.

Parameters:

clazz - Class type which its related dependency reference should be retrieved.

qualifiers - List of qualifiers to distinguish between similar types.