ch.jalu.injector.handlers

Interface Handler

All Known Implementing Classes:

AnnotationResolver, CyclicDependenciesDetector, DefaultInjectionProvider, DirectInstantiationProvider, FactoryDependencyHandler, InstantiationCache, MockDependencyHandler, PostConstructMethodInvoker, ProviderHandler, SavedAnnotationsHandler, SingletonStoreDependencyHandler, StandardInjectionProvider, TypeSafeAnnotationHandler

public interface Handler

Handlers may modify the injection process at different moments. They allow you to define custom injection methods, custom validation. Handlers are executed in the order that they are given to InjectorBuilder, so more important handlers should come first.

Method Summary

Modifier and Type	Method and Description
default void	onAnnotation(Class<? extends Annotation> annotationType, Object object) Processes the annotation type and the associated object.
default <T> void	onProvider(Class<T> clazz, javax.inject.Provider<? extends T> provider) Processes the given provider.
default <T,P extends javax.inject.Provider<? extends T>> void	onProviderClass(Class<T> clazz, Class<P> providerClass) Processes the given provider class.
default <T> T	postProcess(T object, ResolutionContext context, Resolution<?> resolution) Processes the newly created object.
default Resolution<?>	resolve(ResolutionContext context) Resolves the context such that the object identified by the context's object identifier can be instantiated or retrieved.

Method Detail

resolve

@Nullable
default Resolution<?> resolve(ResolutionContext context)
                                 throws Exception

Resolves the context such that the object identified by the context's object identifier can be instantiated or retrieved. May throw an exception if something is invalid, such as when the requested object is not possible to resolve (e.g. wrong combination of annotations, unmet conditions).

The returned Resolution must correspond to the type represented by the context's object identifier.

Parameters:

context - the resolution context

Returns:

the instantiation for the class, or null if not possible

Throws:

Exception - for validation errors

postProcess

@Nullable
default <T> T postProcess(T object,
                                    ResolutionContext context,
                                    Resolution<?> resolution)
                             throws Exception

Processes the newly created object.

Type Parameters:

T - the object's type

Parameters:

object - the object that was instantiated

context - the resolution context

resolution - the resolution that was used to create the object

Returns:

the new object to replace the instance with, null to keep the object the same

Throws:

Exception - for validation errors or similar

onAnnotation

default void onAnnotation(Class<? extends Annotation> annotationType,
                          @Nullable
                          Object object)
                   throws Exception

Processes the annotation type and the associated object.

Parameters:

annotationType - the annotation type

object - the object

Throws:

Exception - for failed validations

onProvider

default <T> void onProvider(Class<T> clazz,
                            javax.inject.Provider<? extends T> provider)
                     throws Exception

Processes the given provider.

Type Parameters:

T - the class' type

Parameters:

clazz - the class to associate the provider with

provider - the provider

Throws:

Exception - for unsuccessful validation, etc.

onProviderClass

default <T,P extends javax.inject.Provider<? extends T>> void onProviderClass(Class<T> clazz,
                                                                              Class<P> providerClass)
                                                                       throws Exception

Processes the given provider class.

Type Parameters:

T - the class' type

P - the provider class' type

Parameters:

clazz - the class to associate the provider class with

providerClass - the provider class

Throws:

Exception - for unsuccessful validation, etc.