Package org.glassfish.hk2.api
Interface InjectionResolver<T>
-
- Type Parameters:
T
- This must be the class of the injection annotation that this resolver will handle
- All Known Implementing Classes:
ChildInjectResolverImpl
,ConfiguredByInjectionResolver
,ThreeThirtyResolver
@Contract public interface InjectionResolver<T>
This class allows users to provide a custom injection target for any annotation (including @Inject). The user would usually only provide a resolver for @Inject if it were specializing the system provided resolver for @Inject. Otherwise, this resolver can be used to provide injection points for any annotation.An implementation of InjectionResolver must be in the Singleton scope. Implementations of InjectionResolver will be instantiated as soon as they are added to HK2 in order to avoid deadlocks and circular references. Therefore it is recommended that implementations of InjectionResolver make liberal use of
Provider
orIterableProvider
when injecting dependent services so that these services are not instantiated when the InjectionResolver is created- Author:
- jwells
-
-
Field Summary
Fields Modifier and Type Field Description static String
SYSTEM_RESOLVER_NAME
This is the name of the system provided resolver for 330 injections
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description boolean
isConstructorParameterIndicator()
This method should return true if the annotation that indicates that this is an injection point can appear in the parameter list of a constructor.boolean
isMethodParameterIndicator()
This method should return true if the annotation that indicates that this is an injection point can appear in the parameter list of a method.Object
resolve(Injectee injectee, ServiceHandle<?> root)
This method will return the object that should be injected into the given injection point.
-
-
-
Field Detail
-
SYSTEM_RESOLVER_NAME
static final String SYSTEM_RESOLVER_NAME
This is the name of the system provided resolver for 330 injections- See Also:
- Constant Field Values
-
-
Method Detail
-
resolve
Object resolve(Injectee injectee, ServiceHandle<?> root)
This method will return the object that should be injected into the given injection point. It is the responsiblity of the implementation to ensure that the object returned can be safely injected into the injection point.This method should not do the injection themselves
- Parameters:
injectee
- The injection point this value is being injected intoroot
- The service handle of the root class being created, which should be used in order to ensure proper destruction of associated &64;PerLookup scoped objects. This can be null in the case that this is being used for an object not managed by HK2. This will only happen if this object is being created with the create method of ServiceLocator.- Returns:
- A possibly null value to be injected into the given injection point
-
isConstructorParameterIndicator
boolean isConstructorParameterIndicator()
This method should return true if the annotation that indicates that this is an injection point can appear in the parameter list of a constructor.- Returns:
- true if the injection annotation can appear in the parameter list of a constructor
-
isMethodParameterIndicator
boolean isMethodParameterIndicator()
This method should return true if the annotation that indicates that this is an injection point can appear in the parameter list of a method.- Returns:
- true if the injection annotation can appear in the parameter list of a method
-
-