org.glassfish.hk2.extras

Class ExtrasUtilities

java.lang.Object

org.glassfish.hk2.extras.ExtrasUtilities

public class ExtrasUtilities
extends Object

These are utilities for the extra features of hk2. Generally they allow for

Author:

jwells

Field Summary

Fields

Modifier and Type	Field and Description
static String	HK2BRIDGE_LOCATOR_ID This will be put into the metadata of a descriptor that is bridged from another service locator.
static String	HK2BRIDGE_SERVICE_ID This will be put into the metadata of a descriptor that is bridged from another service locator.

Constructor Summary

Constructors

Constructor and Description
ExtrasUtilities()

Method Summary

Methods

Modifier and Type	Method and Description
static void	bridgeServiceLocator(ServiceLocator into, ServiceLocator from) This method will bridge all non-local services from the from ServiceLocator into the into ServiceLocator.
static void	enableDefaultInterceptorServiceImplementation(ServiceLocator locator) This method adds in a default implementation of the InterceptionService which uses annotations to denote which services should intercept other services.
static void	unbridgeServiceLocator(ServiceLocator into, ServiceLocator from) This method will remove all non-local services from the from ServiceLocator into the into ServiceLocator.

Methods inherited from class java.lang.Object

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

Field Detail

HK2BRIDGE_LOCATOR_ID

public static final String HK2BRIDGE_LOCATOR_ID

This will be put into the metadata of a descriptor that is bridged from another service locator. The value will be the locator id of the service locator from which the service originates

See Also:

Constant Field Values

HK2BRIDGE_SERVICE_ID

public static final String HK2BRIDGE_SERVICE_ID

This will be put into the metadata of a descriptor that is bridged from another service locator. The value will be the service id of the descriptor from which the service originates

See Also:

Constant Field Values

Constructor Detail

ExtrasUtilities

public ExtrasUtilities()

Method Detail

enableDefaultInterceptorServiceImplementation

public static void enableDefaultInterceptorServiceImplementation(ServiceLocator locator)

This method adds in a default implementation of the InterceptionService which uses annotations to denote which services should intercept other services. For more information see the org.glassfish.hk2.extras.interception package. This method is idempotent, if the service is already available it will not add it

Parameters:

locator - The locator to add the default interception service implementation to. May not be null

bridgeServiceLocator

public static void bridgeServiceLocator(ServiceLocator into,
                        ServiceLocator from)

This method will bridge all non-local services from the from ServiceLocator into the into ServiceLocator. Changes to the set of services in the from ServiceLocator will be reflected in the into ServiceLocator. The two ServiceLocators involved must not have a parent/child relationship

Parameters:

into - The non-null ServiceLocator that will have services added to it from the from ServiceLocator

from - The non-null ServiceLocator that will add services to the into ServiceLocator

unbridgeServiceLocator

public static void unbridgeServiceLocator(ServiceLocator into,
                          ServiceLocator from)

This method will remove all non-local services from the from ServiceLocator into the into ServiceLocator. The service locator will no longer be related by this bridge The two ServiceLocators involved must not have a parent/child relationship

Parameters:

into - The non-null ServiceLocator that will have services added to it from the from ServiceLocator

from - The non-null ServiceLocator that will add services to the into ServiceLocator