CdiSeInjectionManager (Jersey 2.47 API)

java.lang.Object
- org.glassfish.jersey.inject.cdi.se.CdiSeInjectionManager

All Implemented Interfaces:

InjectionManager
```
public class CdiSeInjectionManager
extends Object
implements InjectionManager
```
Implementation of InjectionManager that starts CDI SE container, scans all users bean according to beans.xml file and register Jersey's internal beans using SeBeanRegisterExtension extension.

Author:

Petr Bouda

Constructor Summary

Constructors
Constructor and Description

CdiSeInjectionManager()

Constructors
Constructor and Description
`CdiSeInjectionManager()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`completeRegistration()` Completes `InjectionManager` and the underlying DI provider.
`<T> T`	`create(Class<T> createMe)` Creates an object with the given class.
`<T> T`	`createAndInitialize(Class<T> createMe)` Creates, injects and post-constructs an object with the given class.
`ForeignDescriptor`	`createForeignDescriptor(Binding binding)` Creates and registers the descriptor in the underlying DI provider and returns `ForeignDescriptor` that is specific descriptor for the underlying DI provider.
`<T> List<T>`	`getAllInstances(Type contractOrImpl)` Gets all services from this injection manager that implement this contract or have this implementation.
`<T> List<ServiceHolder<T>>`	`getAllServiceHolders(Class<T> contractOrImpl, Annotation... qualifiers)` Gets all services from this injection manager that implements this contract or has this implementation along with information about the service which can be kept by `ServiceHolder`.
`javax.enterprise.inject.spi.BeanManager`	`getBeanManager()`
`protected AbstractBinder`	`getBindings()`
`javax.enterprise.inject.se.SeContainer`	`getContainer()`
`<T> T`	`getInstance(Class<T> contractOrImpl)` Gets the best service from this injection manager that implements this contract or has this implementation.
`<T> T`	`getInstance(Class<T> contractOrImpl, Annotation... qualifiers)` Gets the best service from this injection manager that implements this contract or has this implementation.
`<T> T`	`getInstance(Class<T> contractOrImpl, String classAnalyzer)` Gets the best service from this injection manager that implements this contract or has this implementation.
`Object`	`getInstance(ForeignDescriptor foreignDescriptor)` Gets the service instance according to `ForeignDescriptor` which is specific to the underlying DI provider.
`<T> T`	`getInstance(Type contractOrImpl)` Gets the best service from this injection manager that implements this contract or has this implementation.
`void`	`inject(Object instance)` Analyzes the given object and inject into its fields and methods.
`void`	`inject(Object injectMe, String classAnalyzer)` This will analyze the given object and inject into its fields and methods.
`boolean`	`isRegistrable(Class<?> clazz)` Tests whether the provided `clazz` can be registered by the implementation of the `InjectionManager`.
`boolean`	`isShutdown()` Returns `true` when the `InjectionManager` has been shutdown, `false` otherwise.
`void`	`preDestroy(Object preDestroyMe)` Analyzes the given object and call the preDestroy method.
`void`	`register(Binder binder)` Registers beans which are included in `Binder`.
`void`	`register(Binding binding)` Registers one bean represented using fields in the provided descriptor.
`void`	`register(Iterable<Binding> bindings)` Registers a collection of beans represented using fields in the provided descriptors.
`void`	`register(Object provider)` Registers a provider.
`void`	`setBeanManager(javax.enterprise.inject.spi.BeanManager beanManager)`
`void`	`setContainer(javax.enterprise.inject.se.SeContainer container)`
`void`	`shutdown()` Shuts down the entire `InjectionManager` and the underlying DI provider.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - CdiSeInjectionManager
```
public CdiSeInjectionManager()
```
- Method Detail
  - register
```
public void register(Binding binding)
```
    Description copied from interface: InjectionManager
    
    Registers one bean represented using fields in the provided descriptor. The final bean can be direct bean or factory object which will create the bean at the time of injection. InjectionManager is able to register a bean represented by a class or direct instance.
    
    Specified by:
    
    register in interface InjectionManager
    
    Parameters:
    
    binding - one descriptor.
    
    See Also:
    
    ClassBinding, InstanceBinding, SupplierClassBinding, SupplierInstanceBinding
  - register
```
public void register(Iterable<Binding> bindings)
```
    Description copied from interface: InjectionManager
    
    Registers a collection of beans represented using fields in the provided descriptors. The final bean can be direct bean or factory object which will create the bean at the time of injection. InjectionManager is able to register a bean represented by a class or direct instance.
    
    Specified by:
    
    register in interface InjectionManager
    
    Parameters:
    
    bindings - collection of descriptors.
    
    See Also:
    
    ClassBinding, InstanceBinding, SupplierClassBinding, SupplierInstanceBinding
  - register
```
public void register(Binder binder)
```
    Description copied from interface: InjectionManager
    
    Registers beans which are included in Binder. Binder can contains all descriptors extending Binding or other binders which are installed together in tree-structure. This method will get all descriptors bound in the given binder and register them in the order how the binders are installed together. In the tree structure, the deeper on the left side will be processed first.
    
    Specified by:
    
    register in interface InjectionManager
    
    Parameters:
    
    binder - collection of descriptors.
    
    See Also:
    
    ClassBinding, InstanceBinding, SupplierClassBinding, SupplierInstanceBinding
  - register
```
public void register(Object provider)
              throws IllegalArgumentException
```
    Description copied from interface: InjectionManager
    
    Registers a provider. An implementation of the InjectionManager should test whether the type of the object can be registered using the method InjectionManager.isRegistrable(Class). Then a caller has an certainty that the instance of the tested class can be registered in InjectionManager. If InjectionManager is not able to register the provider then IllegalArgumentException is thrown.
    
    Specified by:
    
    register in interface InjectionManager
    
    Parameters:
    
    provider - object that can be registered in InjectionManager.
    
    Throws:
    
    IllegalArgumentException - provider cannot be registered.
  - isRegistrable
```
public boolean isRegistrable(Class<?> clazz)
```
    Description copied from interface: InjectionManager
    
    Tests whether the provided clazz can be registered by the implementation of the InjectionManager.
    
    Specified by:
    
    isRegistrable in interface InjectionManager
    
    Parameters:
    
    clazz - type that is tested whether is registrable by the implementation of InjectionManager.
    
    Returns:
    
    true if the InjectionManager is able to register this type.
  - createAndInitialize
```
public <T> T createAndInitialize(Class<T> createMe)
```
    Description copied from interface: InjectionManager
    
    Creates, injects and post-constructs an object with the given class. This is equivalent to calling the create-class method followed by the inject-class method followed by the post-construct method.
    The object created is not managed by the injection manager.
    
    Specified by:
    
    createAndInitialize in interface InjectionManager
    
    Parameters:
    
    createMe - The non-null class to create this object from;
    
    Returns:
    
    An instance of the object that has been created, injected and post constructed.
  - create
```
public <T> T create(Class<T> createMe)
```
    Description copied from interface: InjectionManager
    
    Creates an object with the given class.
    The object created is not managed by the injection manager.
    
    Specified by:
    
    create in interface InjectionManager
    
    Parameters:
    
    createMe - The non-null class to create this object from;
    
    Returns:
    
    An instance of the object that has been created.
  - getAllServiceHolders
```
public <T> List<ServiceHolder<T>> getAllServiceHolders(Class<T> contractOrImpl,
                                                       Annotation... qualifiers)
```
    Description copied from interface: InjectionManager
    
    Gets all services from this injection manager that implements this contract or has this implementation along with information about the service which can be kept by ServiceHolder.
    
    Specified by:
    
    getAllServiceHolders in interface InjectionManager
    
    Type Parameters:
    
    T - Instance type.
    
    Parameters:
    
    contractOrImpl - May not be null, and is the contract or concrete implementation to get the best instance of.
    
    qualifiers - The set of qualifiers that must match this service definition.
    
    Returns:
    
    An instance of the contract or impl along with other information. May return null if there is no provider that provides the given implementation or contract.
  - getInstance
```
public <T> T getInstance(Class<T> contractOrImpl,
                         Annotation... qualifiers)
```
    Description copied from interface: InjectionManager
    
    Gets the best service from this injection manager that implements this contract or has this implementation.
    Use this method only if other information is not needed otherwise use, otherwise use InjectionManager.getAllServiceHolders(Class, Annotation...).
    
    Specified by:
    
    getInstance in interface InjectionManager
    
    Type Parameters:
    
    T - Instance type.
    
    Parameters:
    
    contractOrImpl - May not be null, and is the contract or concrete implementation to get the best instance of.
    
    qualifiers - The set of qualifiers that must match this service definition.
    
    Returns:
    
    An instance of the contract or impl. May return null if there is no provider that provides the given implementation or contract.
  - getInstance
```
public <T> T getInstance(Class<T> contractOrImpl)
```
    Description copied from interface: InjectionManager
    
    Gets the best service from this injection manager that implements this contract or has this implementation.
    Use this method only if other information is not needed otherwise use, otherwise use InjectionManager.getAllServiceHolders(Class, Annotation...).
    
    Specified by:
    
    getInstance in interface InjectionManager
    
    Type Parameters:
    
    T - Instance type.
    
    Parameters:
    
    contractOrImpl - May not be null, and is the contract or concrete implementation to get the best instance of.
    
    Returns:
    
    An instance of the contract or impl. May return null if there is no provider that provides the given implementation or contract.
  - getInstance
```
public <T> T getInstance(Type contractOrImpl)
```
    Description copied from interface: InjectionManager
    
    Gets the best service from this injection manager that implements this contract or has this implementation.
    Use this method only if other information is not needed otherwise use, otherwise use InjectionManager.getAllServiceHolders(Class, Annotation...).
    
    Specified by:
    
    getInstance in interface InjectionManager
    
    Type Parameters:
    
    T - Instance type.
    
    Parameters:
    
    contractOrImpl - May not be null, and is the contract or concrete implementation to get the best instance of.
    
    Returns:
    
    An instance of the contract or impl. May return null if there is no provider that provides the given implementation or contract.
  - getInstance
```
public Object getInstance(ForeignDescriptor foreignDescriptor)
```
    Description copied from interface: InjectionManager
    
    Gets the service instance according to ForeignDescriptor which is specific to the underlying DI provider.
    
    Specified by:
    
    getInstance in interface InjectionManager
    
    Parameters:
    
    foreignDescriptor - DI specific descriptor.
    
    Returns:
    
    service instance according to foreign descriptor.
  - createForeignDescriptor
```
public ForeignDescriptor createForeignDescriptor(Binding binding)
```
    Description copied from interface: InjectionManager
    
    Creates and registers the descriptor in the underlying DI provider and returns ForeignDescriptor that is specific descriptor for the underlying DI provider.
    
    Specified by:
    
    createForeignDescriptor in interface InjectionManager
    
    Parameters:
    
    binding - jersey descriptor.
    
    Returns:
    
    specific foreign descriptor of the underlying DI provider.
  - getAllInstances
```
public <T> List<T> getAllInstances(Type contractOrImpl)
```
    Description copied from interface: InjectionManager
    
    Gets all services from this injection manager that implement this contract or have this implementation.
    Use this method only if other information is not needed otherwise use, otherwise use InjectionManager.getAllServiceHolders(Class, Annotation...).
    
    Specified by:
    
    getAllInstances in interface InjectionManager
    
    Type Parameters:
    
    T - Instance type.
    
    Parameters:
    
    contractOrImpl - May not be null, and is the contract or concrete implementation to get the best instance of.
    
    Returns:
    
    A list of services implementing this contract or concrete implementation. May not return null, but may return an empty list
  - inject
```
public void inject(Object instance)
```
    Description copied from interface: InjectionManager
    
    Analyzes the given object and inject into its fields and methods. The object injected in this way will not be managed by HK2
    
    Specified by:
    
    inject in interface InjectionManager
    
    Parameters:
    
    instance - The object to be analyzed and injected into
  - preDestroy
```
public void preDestroy(Object preDestroyMe)
```
    Description copied from interface: InjectionManager
    
    Analyzes the given object and call the preDestroy method. The object given will not be managed by bean manager.
    
    Specified by:
    
    preDestroy in interface InjectionManager
    
    Parameters:
    
    preDestroyMe - The object to preDestroy
  - completeRegistration
```
public void completeRegistration()
                          throws IllegalStateException
```
    Description copied from interface: InjectionManager
    
    Completes InjectionManager and the underlying DI provider. All registered components are bound to injection manager and after an invocation of this method all components are available using e.g. InjectionManager.getInstance(Class).
    
    Specified by:
    
    completeRegistration in interface InjectionManager
    
    Throws:
    
    IllegalStateException
  - getBindings
```
protected AbstractBinder getBindings()
```
  - getContainer
```
public javax.enterprise.inject.se.SeContainer getContainer()
```
  - setContainer
```
public void setContainer(javax.enterprise.inject.se.SeContainer container)
```
  - getBeanManager
```
public javax.enterprise.inject.spi.BeanManager getBeanManager()
```
  - setBeanManager
```
public void setBeanManager(javax.enterprise.inject.spi.BeanManager beanManager)
```
  - shutdown
```
public void shutdown()
```
    Description copied from interface: InjectionManager
    
    Shuts down the entire InjectionManager and the underlying DI provider.
    Shutdown phase is dedicated to make some final cleaning steps regarding underlying DI provider.
    
    Specified by:
    
    shutdown in interface InjectionManager
  - isShutdown
```
public boolean isShutdown()
```
    Description copied from interface: InjectionManager
    
    Returns true when the InjectionManager has been shutdown, false otherwise.
    
    Specified by:
    
    isShutdown in interface InjectionManager
    
    Returns:
    
    Whether the InjectionManager has been shutdown.
  - inject
```
public void inject(Object injectMe,
                   String classAnalyzer)
```
    Description copied from interface: InjectionManager
    
    This will analyze the given object and inject into its fields and methods. The object injected in this way will not be managed by HK2
    
    Specified by:
    
    inject in interface InjectionManager
    
    Parameters:
    
    injectMe - The object to be analyzed and injected into
  - getInstance
```
public <T> T getInstance(Class<T> contractOrImpl,
                         String classAnalyzer)
```
    Description copied from interface: InjectionManager
    
    Gets the best service from this injection manager that implements this contract or has this implementation.
    Use this method only if other information is not needed otherwise use, otherwise use InjectionManager.getAllServiceHolders(Class, Annotation...).
    
    Specified by:
    
    getInstance in interface InjectionManager
    
    Type Parameters:
    
    T - Instance type.
    
    Parameters:
    
    contractOrImpl - May not be null, and is the contract or concrete implementation to get the best instance of.
    
    classAnalyzer - -------
    
    Returns:
    
    An instance of the contract or impl. May return null if there is no provider that provides the given implementation or contract.

Class CdiSeInjectionManager

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

CdiSeInjectionManager

Method Detail

register

register

register

register

isRegistrable

createAndInitialize

create

getAllServiceHolders

getInstance

getInstance

getInstance

getInstance

createForeignDescriptor

getAllInstances

inject

preDestroy

completeRegistration

getBindings

getContainer

setContainer

getBeanManager

setBeanManager

shutdown

isShutdown

inject

getInstance