org.glassfish.hk2.utilities
Class BuilderHelper

java.lang.Object
  org.glassfish.hk2.utilities.BuilderHelper

public class BuilderHelper
extends Object

This class is used to generate DescriptorBuilders to be used as a simple mechanism to create a Filter or Descriptor.

Constructor Summary

BuilderHelper()

Method Summary

static Filter	allFilter() Returns a filter of type Descriptor that matches all descriptors
static <T> AbstractActiveDescriptor<T>	createConstantDescriptor(T constant) This creates a descriptor that will always return the given object.
static IndexedFilter	createContractFilter(String contract) Returns an indexed filter that will return all descriptors that have contract as an advertised contract
static DescriptorImpl	createDescriptorFromClass(Class<?> clazz) This returns a DescriptorImpl based on the given class.
static IndexedFilter	createNameAndContractFilter(String contract, String name) Returns an indexed filter that will return all descriptors that have the given name and given contract
static IndexedFilter	createNameFilter(String name) Returns an indexed filter that will return all descriptors that have the given name
static Descriptor	deepCopyDescriptor(Descriptor copyMe) Makes a deep copy of the incoming descriptor
static DescriptorBuilder	link(Class<?> implementationClass) This method links an implementation class with a DescriptorBuilder, to be used to further build the Descriptor.
static DescriptorBuilder	link(Class<?> implementationClass, boolean addToContracts) This method links an implementation class with a DescriptorBuilder, to be used to further build the Descriptor
static DescriptorBuilder	link(String implementationClass) This method links an implementation class with a DescriptorBuilder, to be used to further build the Descriptor.
static DescriptorBuilder	link(String implementationClass, boolean addToContracts) This method links an implementation class with a DescriptorBuilder, to be used to further build the Descriptor.

Methods inherited from class java.lang.Object

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

Constructor Detail

BuilderHelper

public BuilderHelper()

Method Detail

createContractFilter

public static IndexedFilter createContractFilter(String contract)

Returns an indexed filter that will return all descriptors that have contract as an advertised contract

Parameters:

contract - The advertised contract to look for

Returns:

The indexed filter that can be used to calls to ServiceLocator methods

createNameFilter

public static IndexedFilter createNameFilter(String name)

Returns an indexed filter that will return all descriptors that have the given name

Parameters:

name - The name to look for

Returns:

The indexed filter that can be used to calls to ServiceLocator methods

createNameAndContractFilter

public static IndexedFilter createNameAndContractFilter(String contract,
                                                        String name)

Returns an indexed filter that will return all descriptors that have the given name and given contract

Parameters:

contract - The advertised contract to look for

name - The name to look for

Returns:

The indexed filter that can be used to calls to ServiceLocator methods

allFilter

public static Filter allFilter()

Returns a filter of type Descriptor that matches all descriptors

Returns:

A filter that matches all descriptors

link

public static DescriptorBuilder link(String implementationClass,
                                     boolean addToContracts)
                              throws IllegalArgumentException

This method links an implementation class with a DescriptorBuilder, to be used to further build the Descriptor.

Parameters:

implementationClass - The fully qualified name of the implementation class to be associated with the DescriptorBuilder.

addToContracts - if true, this implementation class will be added to the list of contracts

Returns:

A DescriptorBuilder that can be used to further build up the Descriptor

Throws:

IllegalArgumentException - if implementationClass is null

link

public static DescriptorBuilder link(String implementationClass)
                              throws IllegalArgumentException

This method links an implementation class with a DescriptorBuilder, to be used to further build the Descriptor. This method will automatically put the implementationClass into the list of advertised contracts.

Parameters:

implementationClass - The fully qualified name of the implementation class to be associated with the PredicateBuilder.

Returns:

A DescriptorBuilder that can be used to further build up the Descriptor

Throws:

IllegalArgumentException - if implementationClass is null

link

public static DescriptorBuilder link(Class<?> implementationClass,
                                     boolean addToContracts)
                              throws IllegalArgumentException

This method links an implementation class with a DescriptorBuilder, to be used to further build the Descriptor

Parameters:

implementationClass - The implementation class to be associated with the DescriptorBuilder.

addToContracts - true if this impl class should be automatically added to the list of contracts

Returns:

A DescriptorBuilder that can be used to further build up the Descriptor

Throws:

IllegalArgumentException - if implementationClass is null

link

public static DescriptorBuilder link(Class<?> implementationClass)
                              throws IllegalArgumentException

This method links an implementation class with a DescriptorBuilder, to be used to further build the Descriptor.

Parameters:

implementationClass - The implementation class to be associated with the DescriptorBuilder.

Returns:

A DescriptorBuilder that can be used to further build up the Descriptor

Throws:

IllegalArgumentException - if implementationClass is null

createConstantDescriptor

public static <T> AbstractActiveDescriptor<T> createConstantDescriptor(T constant)

This creates a descriptor that will always return the given object. The set of types in the advertised contracts will contain the class of the constant and all interfaces implemented by the constant (including those not marked with &86;Contract).

Parameters:

constant - The non-null constant that should always be returned from the create method of this ActiveDescriptor.

Returns:

The descriptor returned can be used in calls to DynamicConfiguration.addActiveDescriptor

createDescriptorFromClass

public static DescriptorImpl createDescriptorFromClass(Class<?> clazz)

This returns a DescriptorImpl based on the given class. The returned descriptor will include the class itself as an advertised contract and all implemented interfaces that are marked @Contract

Parameters:

clazz - The class to analyze

Returns:

The DescriptorImpl corresponding to this class

deepCopyDescriptor

public static Descriptor deepCopyDescriptor(Descriptor copyMe)

Makes a deep copy of the incoming descriptor

Parameters:

copyMe - The descriptor to copy

Returns:

A new descriptor with all fields copied