org.glassfish.jersey.internal.inject

Class ProviderBinder

java.lang.Object

org.glassfish.jersey.internal.inject.ProviderBinder

public class ProviderBinder
extends Object

Class used for registration of the custom providers into HK2 service locator.

Custom providers are classes that implements specific JAX-RS or Jersey SPI interfaces (e.g. MessageBodyReader) and are supplied by the user. These providers will be bound into the HK2 service locator annotated by a @Custom qualifier annotation.

Use the @Custom qualifier annotation to retrieve these providers from HK2 service locator. You may also use a one of the provider accessor utility method defined in Providers class.

Author:

Miroslav Fuksa (miroslav.fuksa at oracle.com), Marek Potociar (marek.potociar at oracle.com), Michal Gajdos (michal.gajdos at oracle.com)

Constructor Summary

Constructors

Constructor and Description
ProviderBinder(org.glassfish.hk2.api.ServiceLocator locator) Create new provider binder instance.

Method Summary

Methods

Modifier and Type	Method and Description
void	bindClasses(Class<?>... classes) Register/bind custom provider classes.
void	bindClasses(Iterable<Class<?>> classes) Register/bind custom provider classes.
void	bindClasses(Iterable<Class<?>> classes, boolean bindResources) Register/bind custom provider classes that may also be resources.
void	bindInstances(Iterable<Object> instances) Register/bind custom provider instances.
static void	bindProvider(Class<?> providerClass, ContractProvider model, org.glassfish.hk2.api.DynamicConfiguration dc) Bind contract provider model to a provider class using the supplied HK2 dynamic configuration.
static void	bindProvider(Object providerInstance, ContractProvider model, org.glassfish.hk2.api.DynamicConfiguration dc) Bind contract provider model to a provider instance using the supplied HK2 dynamic configuration.
static void	bindProviders(ComponentBag componentBag, RuntimeType constrainedTo, Set<Class<?>> registeredClasses, org.glassfish.hk2.api.DynamicConfiguration dynamicConfiguration) Bind all providers contained in providerBag (classes and instances) using HK2 service locator.
static void	bindProviders(ComponentBag componentBag, RuntimeType constrainedTo, Set<Class<?>> registeredClasses, org.glassfish.hk2.api.ServiceLocator locator) Bind all providers contained in providerBag (classes and instances) using HK2 service locator.
static void	bindProviders(ComponentBag componentBag, org.glassfish.hk2.api.ServiceLocator locator) Bind all providers contained in providerBag (classes and instances) using HK2 service locator.

Methods inherited from class java.lang.Object

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

Constructor Detail

ProviderBinder

public ProviderBinder(org.glassfish.hk2.api.ServiceLocator locator)

Create new provider binder instance.

Parameters:

locator - HK2 service locator the binder will use to bind the providers into.

Method Detail

bindInstances

public void bindInstances(Iterable<Object> instances)

Register/bind custom provider instances. Registered providers will be handled always as Singletons.

Parameters:

instances - custom provider instances.

bindClasses

public void bindClasses(Class<?>... classes)

Register/bind custom provider classes. Registered providers will be handled always as Singletons unless annotated by PerLookup.

Parameters:

classes - custom provider classes.

bindClasses

public void bindClasses(Iterable<Class<?>> classes)

Register/bind custom provider classes. Registered providers will be handled always as Singletons unless annotated by PerLookup.

Parameters:

classes - custom provider classes.

bindClasses

public void bindClasses(Iterable<Class<?>> classes,
               boolean bindResources)

Register/bind custom provider classes that may also be resources. Registered providers/resources will be handled always as Singletons unless annotated by PerLookup.

If bindAsResources is set to true, the providers will also be bound as resources.

Parameters:

classes - custom provider classes.

bindResources - if true, the provider classes will also be bound as resources.

bindProvider

public static void bindProvider(Class<?> providerClass,
                ContractProvider model,
                org.glassfish.hk2.api.DynamicConfiguration dc)

Bind contract provider model to a provider class using the supplied HK2 dynamic configuration.

Parameters:

providerClass - provider class.

model - contract provider model.

dc - HK2 dynamic service locator configuration.

bindProvider

public static void bindProvider(Object providerInstance,
                ContractProvider model,
                org.glassfish.hk2.api.DynamicConfiguration dc)

Bind contract provider model to a provider instance using the supplied HK2 dynamic configuration. Scope value specified in the contract provider model is ignored as instances can only be bound as "singletons".

Parameters:

providerInstance - provider instance.

model - contract provider model.

dc - HK2 dynamic service locator configuration.

bindProviders

public static void bindProviders(ComponentBag componentBag,
                 org.glassfish.hk2.api.ServiceLocator locator)

Bind all providers contained in providerBag (classes and instances) using HK2 service locator. Configuration is also committed.

Parameters:

componentBag - bag of provider classes and instances.

locator - HK2 service locator the binder will use to bind the providers into.

bindProviders

public static void bindProviders(ComponentBag componentBag,
                 RuntimeType constrainedTo,
                 Set<Class<?>> registeredClasses,
                 org.glassfish.hk2.api.ServiceLocator locator)

Bind all providers contained in providerBag (classes and instances) using HK2 service locator. Configuration is also committed.

Parameters:

componentBag - bag of provider classes and instances.

constrainedTo - current runtime (client or server).

registeredClasses - classes which are manually registered by the user (not found by the classpath scanning).

locator - HK2 service locator the binder will use to bind the providers into.

bindProviders

public static void bindProviders(ComponentBag componentBag,
                 RuntimeType constrainedTo,
                 Set<Class<?>> registeredClasses,
                 org.glassfish.hk2.api.DynamicConfiguration dynamicConfiguration)

Bind all providers contained in providerBag (classes and instances) using HK2 service locator. Configuration is not committed.

Parameters:

componentBag - bag of provider classes and instances.

constrainedTo - current runtime (client or server).

registeredClasses - classes which are manually registered by the user (not found by the classpath scanning).

dynamicConfiguration - HK2 dynamic service locator configuration.