Package org.atmosphere.inject

Class InjectableObjectFactory

java.lang.Object

org.atmosphere.inject.InjectableObjectFactory

All Implemented Interfaces:

AtmosphereObjectFactory<Injectable<?>>, AtmosphereConfigAware

public class InjectableObjectFactory
extends java.lang.Object
implements AtmosphereObjectFactory<Injectable<?>>

Support injection of Atmosphere's Internal object using AtmosphereConfig,AtmosphereFramework,{@link org.atmosphere.cpr.BroadcasterFactory, AtmosphereResourceFactory ,DefaultMetaBroadcaster and AtmosphereResourceSessionFactory and classes implementing the Injectable defined inside META_INF/services/org.atmosphere.inject.Inject

Author:

Jeanfrancois Arcand

Field Summary

Fields

Modifier and Type	Field	Description
protected static org.slf4j.Logger	logger

Constructor Summary

Constructors

Constructor	Description
InjectableObjectFactory()

Method Summary

Modifier and Type	Method	Description
AtmosphereObjectFactory	allowInjectionOf(Injectable<?> injectable)	Pass information to the underlying Dependency Injection Implementation
AtmosphereObjectFactory	allowInjectionOf(Injectable<?> injectable, boolean first)
<U> void	applyMethods(U instance, java.lang.Class<U> defaultType)	Execute InjectIntrospector.introspectMethod(java.lang.reflect.Method, java.lang.Object)
void	configure(AtmosphereConfig config)	Configure an AtmosphereFramework object.
protected <T,U extends T> void	fieldInjectionException(java.lang.reflect.Field field, U instance, java.lang.Class<T> clazz, java.lang.Exception ex)
<U> U	getInjectable(java.lang.Class<U> u)	Use this method to retrieve available Injectable.
<T> T	inject(T instance)	Apply Injectable and InjectIntrospector to a class already constructed.
<U> void	injectFields(java.util.Set<java.lang.reflect.Field> fields, U instance, AtmosphereFramework framework, java.util.LinkedList<Injectable<?>> injectable)
<U> void	injectInjectable(U instance, java.lang.Class<? extends U> defaultType, AtmosphereFramework framework)
protected void	injectionFailed()
InjectableObjectFactory	listener(InjectionListener i)
protected <T,U extends T> void	methodInjectionException(java.lang.reflect.Method m, U instance, java.lang.Class<T> clazz, java.lang.Exception ex)
boolean	needRequestScoped(java.lang.Class defaultType)
<T,U extends T> U	newClassInstance(java.lang.Class<T> classType, java.lang.Class<U> defaultType)	Delegate the creation of Object to the underlying object provider like Spring, Guice, etc.
protected <T,U extends T> void	nullFieldInjectionFor(java.lang.reflect.Field field, U instance, java.lang.Class<T> clazz)
protected <T,U extends T> void	postFieldInjection(java.lang.reflect.Field field, U instance, java.lang.Class<T> clazz)
protected <T,U extends T> void	postMethodInjection(java.lang.reflect.Method method, U instance, java.lang.Class<T> clazz)
protected <T,U extends T> void	preFieldInjection(java.lang.reflect.Field field, U instance, java.lang.Class<T> clazz)
protected <T,U extends T> void	preMethodInjection(java.lang.reflect.Method method, U instance, java.lang.Class<T> clazz)
void	requestScoped(java.lang.Object instance, java.lang.Class defaultType)
void	requestScoped(java.lang.Object instance, java.lang.Class defaultType, AtmosphereResource r)
protected void	retryInjection(AtmosphereFramework framework)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected static final org.slf4j.Logger logger

Constructor Detail

InjectableObjectFactory

public InjectableObjectFactory()

Method Detail

configure

public void configure(AtmosphereConfig config)

Description copied from interface: AtmosphereConfigAware

Configure an AtmosphereFramework object.

Specified by:

configure in interface AtmosphereConfigAware

Parameters:

config - AtmosphereConfig

retryInjection

protected void retryInjection(AtmosphereFramework framework)

newClassInstance

public <T,U extends T> U newClassInstance(java.lang.Class<T> classType,
                                                java.lang.Class<U> defaultType)
                                         throws java.lang.InstantiationException,
                                                java.lang.IllegalAccessException

Description copied from interface: AtmosphereObjectFactory

Delegate the creation of Object to the underlying object provider like Spring, Guice, etc. When creating a class, it is important to check if the class can be configured via its implementation of the AtmosphereConfigAware. AtmosphereConfigAware.configure(AtmosphereConfig) should be called in that case.

Specified by:

newClassInstance in interface AtmosphereObjectFactory<Injectable<?>>

Parameters:

classType - The class' type to be created

defaultType - a class to be created @return an instance of T

Throws:

java.lang.InstantiationException

java.lang.IllegalAccessException

inject

public <T> T inject(T instance)
             throws java.lang.InstantiationException,
                    java.lang.IllegalAccessException

Apply Injectable and InjectIntrospector to a class already constructed.

Parameters:

instance - the instance to inject to.

Returns:

Throws:

java.lang.InstantiationException

java.lang.IllegalAccessException

applyMethods

public <U> void applyMethods(U instance,
                             java.lang.Class<U> defaultType)
                      throws java.lang.IllegalAccessException

Execute InjectIntrospector.introspectMethod(java.lang.reflect.Method, java.lang.Object)

Type Parameters:

U -

Parameters:

instance - the requested object.

defaultType - the type of the requested object

Throws:

java.lang.IllegalAccessException

injectInjectable

public <U> void injectInjectable(U instance,
                                 java.lang.Class<? extends U> defaultType,
                                 AtmosphereFramework framework)
                          throws java.lang.IllegalAccessException

Type Parameters:

U -

Parameters:

instance - the requested object.

defaultType - the type of the requested object

framework - the AtmosphereFramework

Throws:

java.lang.IllegalAccessException

injectFields

public <U> void injectFields(java.util.Set<java.lang.reflect.Field> fields,
                             U instance,
                             AtmosphereFramework framework,
                             java.util.LinkedList<Injectable<?>> injectable)
                      throws java.lang.IllegalAccessException

Throws:

java.lang.IllegalAccessException

allowInjectionOf

public AtmosphereObjectFactory allowInjectionOf(Injectable<?> injectable)

Description copied from interface: AtmosphereObjectFactory

Pass information to the underlying Dependency Injection Implementation

Specified by:

allowInjectionOf in interface AtmosphereObjectFactory<Injectable<?>>

Parameters:

injectable - an Z

Returns:

this

allowInjectionOf

public AtmosphereObjectFactory allowInjectionOf(Injectable<?> injectable,
                                                boolean first)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getInjectable

public <U> U getInjectable(java.lang.Class<U> u)

Use this method to retrieve available Injectable. This method is for application that inject their own Injectable and needs already constructed classes.

Type Parameters:

U - the type

Parameters:

u - the class

Returns:

the class if exists, null if not

requestScoped

public void requestScoped(java.lang.Object instance,
                          java.lang.Class defaultType,
                          AtmosphereResource r)
                   throws java.lang.IllegalAccessException

Throws:

java.lang.IllegalAccessException

requestScoped

public void requestScoped(java.lang.Object instance,
                          java.lang.Class defaultType)
                   throws java.lang.IllegalAccessException

Throws:

java.lang.IllegalAccessException

needRequestScoped

public boolean needRequestScoped(java.lang.Class defaultType)
                          throws java.lang.IllegalAccessException

Throws:

java.lang.IllegalAccessException

listener

public InjectableObjectFactory listener(InjectionListener i)

injectionFailed

protected void injectionFailed()

nullFieldInjectionFor

protected <T,U extends T> void nullFieldInjectionFor(java.lang.reflect.Field field,
                                                           U instance,
                                                           java.lang.Class<T> clazz)

fieldInjectionException

protected <T,U extends T> void fieldInjectionException(java.lang.reflect.Field field,
                                                             U instance,
                                                             java.lang.Class<T> clazz,
                                                             java.lang.Exception ex)

methodInjectionException

protected <T,U extends T> void methodInjectionException(java.lang.reflect.Method m,
                                                              U instance,
                                                              java.lang.Class<T> clazz,
                                                              java.lang.Exception ex)

preFieldInjection

protected <T,U extends T> void preFieldInjection(java.lang.reflect.Field field,
                                                       U instance,
                                                       java.lang.Class<T> clazz)

postFieldInjection

protected <T,U extends T> void postFieldInjection(java.lang.reflect.Field field,
                                                        U instance,
                                                        java.lang.Class<T> clazz)

preMethodInjection

protected <T,U extends T> void preMethodInjection(java.lang.reflect.Method method,
                                                        U instance,
                                                        java.lang.Class<T> clazz)

postMethodInjection

protected <T,U extends T> void postMethodInjection(java.lang.reflect.Method method,
                                                         U instance,
                                                         java.lang.Class<T> clazz)