Interface Factory<T>
- Type Parameters:
T
- This must be the type of entity for which this is a factory. For example, if this were a factory for Foo, then your factory must implement Factory<Foo>.
- All Known Implementing Classes:
AbstractComplexFactory
,AbstractFactory
,ComplexFactory
,ConcreteComplexFactory
,ConcreteFactory
,FactoryWithDefaultProxy
,FactoryWithDefaultProxyForSameScope
,FactoryWithFalseProxy
,FactoryWithFalseProxyForSameScope
,FactoryWithRanks
,FactoryWithVisibility
,MiddleComplexFactory
A factory may not have a TypeVariable or a Wildcard as its actual type. A factory may have any scope, and the scope of the factory is independent of the scope of the type it is providing.
The scope and qualifiers of the objects this factory is producing must be placed on the provide method itself. Objects created with this method will be put into the scope on the provide method, and will have the qualifiers of the provide method.
A factory is generally added with the FactoryDescriptors
helper
class, though factories can also be registered independently.
A Factory implementation may inject a InstantiationService
. If
it does so then the InstantiationService.getInstantiationData()
method
will return information about the caller of the provide method if that
information is available. This can be used to customize the returned object
based on the Injection point of the parent.
-
Method Summary
-
Method Details
-
provide
T provide()This method will create instances of the type of this factory. The provide method must be annotated with the desired scope and qualifiers.- Returns:
- The produces object
-
dispose
This method will dispose of objects created with this scope. This method should not be annotated, as it is naturally paired with the provide method- Parameters:
instance
- The instance to dispose of
-