org.glassfish.hk2.internal

Class ConstantActiveDescriptor<T>

java.lang.Object

org.glassfish.hk2.utilities.DescriptorImpl

org.glassfish.hk2.utilities.AbstractActiveDescriptor<T>

org.glassfish.hk2.internal.ConstantActiveDescriptor<T>

Type Parameters:

T - The type of the constant

All Implemented Interfaces:

java.io.Externalizable, java.io.Serializable, ActiveDescriptor<T>, Descriptor, SingleCache<T>

public class ConstantActiveDescriptor<T>
extends AbstractActiveDescriptor<T>

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private static long	serialVersionUID For serialization
private T	theOne

Constructor Summary

Constructors

Constructor and Description
ConstantActiveDescriptor() For serializable
ConstantActiveDescriptor(T theOne, java.util.Set<java.lang.reflect.Type> advertisedContracts, java.lang.Class<? extends java.lang.annotation.Annotation> scope, java.lang.String name, java.util.Set<java.lang.annotation.Annotation> qualifiers, DescriptorVisibility descriptorVisibility, java.lang.Boolean proxy, java.lang.Boolean proxyForSameScope, java.lang.String classAnalysisName, java.util.Map<java.lang.String,java.util.List<java.lang.String>> metadata, int rank) Creates the constant descriptor

Method Summary

Modifier and Type	Method and Description
T	create(ServiceHandle<?> root) Creates an instance of the ActiveDescriptor.
T	getCache() This can be used for scopes that will only every be created once.
java.lang.String	getImplementation() Returns the fully qualified class name of the implementation class.
java.lang.Class<?>	getImplementationClass() The implementation class that should be used to generate new instances of this descriptor.
java.lang.reflect.Type	getImplementationType() If known the Type of the implementation.
boolean	isCacheSet() Returns true if this cache has been set

Methods inherited from class org.glassfish.hk2.utilities.AbstractActiveDescriptor

addContractType, addQualifierAnnotation, dispose, equals, getContractTypes, getFactoryLocatorId, getFactoryServiceId, getInjectees, getQualifierAnnotations, getScopeAnnotation, getScopeAsAnnotation, hashCode, isReified, releaseCache, removeContractType, removeQualifierAnnotation, setCache, setFactoryId, setImplementationType, setName, setReified, setScopeAnnotation, setScopeAsAnnotation

Methods inherited from class org.glassfish.hk2.utilities.DescriptorImpl

addAdvertisedContract, addMetadata, addMetadata, addQualifier, clearMetadata, descriptorEquals, getAdvertisedContracts, getClassAnalysisName, getDescriptorType, getDescriptorVisibility, getLoader, getLocatorId, getMetadata, getName, getQualifiers, getRanking, getScope, getServiceId, isProxiable, isProxyForSameScope, pretty, readExternal, readObject, removeAdvertisedContract, removeAllMetadata, removeMetadata, removeQualifier, setClassAnalysisName, setDescriptorType, setDescriptorVisibility, setImplementation, setLoader, setLocatorId, setMetadata, setProxiable, setProxyForSameScope, setRanking, setScope, setServiceId, toString, writeExternal, writeObject

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.glassfish.hk2.api.Descriptor

getAdvertisedContracts, getClassAnalysisName, getDescriptorType, getDescriptorVisibility, getLoader, getLocatorId, getMetadata, getName, getQualifiers, getRanking, getScope, getServiceId, isProxiable, isProxyForSameScope, setRanking

Field Detail

serialVersionUID

private static final long serialVersionUID

For serialization

See Also:

Constant Field Values

theOne

private final T theOne

Constructor Detail

ConstantActiveDescriptor

public ConstantActiveDescriptor()

For serializable

ConstantActiveDescriptor

public ConstantActiveDescriptor(T theOne,
                                java.util.Set<java.lang.reflect.Type> advertisedContracts,
                                java.lang.Class<? extends java.lang.annotation.Annotation> scope,
                                java.lang.String name,
                                java.util.Set<java.lang.annotation.Annotation> qualifiers,
                                DescriptorVisibility descriptorVisibility,
                                java.lang.Boolean proxy,
                                java.lang.Boolean proxyForSameScope,
                                java.lang.String classAnalysisName,
                                java.util.Map<java.lang.String,java.util.List<java.lang.String>> metadata,
                                int rank)

Creates the constant descriptor

Parameters:

theOne - May not be null

advertisedContracts -

scope -

name -

qualifiers -

descriptorVisibility -

proxy -

proxyForSameScope -

classAnalysisName -

metadata -

rank -

Method Detail

getImplementation

public java.lang.String getImplementation()

Description copied from interface: Descriptor

Returns the fully qualified class name of the implementation class. If this is a factory descriptor then this will return the fully qualified name of the class implementing the factory interface.

Specified by:

getImplementation in interface Descriptor

Overrides:

getImplementation in class DescriptorImpl

Returns:

Might return null in some cases, but will usually return the fully qualified class name of the implementation class or of the factory class for this descriptor

getCache

public T getCache()

Description copied from interface: SingleCache

This can be used for scopes that will only every be created once. The returned value must have been set previously with setCache. If this is called when isCacheSet is false will result in a RuntimeException

Specified by:

getCache in interface SingleCache<T>

Overrides:

getCache in class AbstractActiveDescriptor<T>

Returns:

A value cached with this ActiveDescriptor

isCacheSet

public boolean isCacheSet()

Description copied from interface: SingleCache

Returns true if this cache has been set

Specified by:

isCacheSet in interface SingleCache<T>

Overrides:

isCacheSet in class AbstractActiveDescriptor<T>

Returns:

true if there is a currently cached value, false otherwise

getImplementationClass

public java.lang.Class<?> getImplementationClass()

Description copied from interface: ActiveDescriptor

The implementation class that should be used to generate new instances of this descriptor.

If the class returned is a Factory, then the factory is used to create instances. In this case the system will get an instance of the factory and use it to create the instances

Returns:

The class that directly implements the contract types, or the class that is the factory for an object that implements the contract types

getImplementationType

public java.lang.reflect.Type getImplementationType()

Description copied from interface: ActiveDescriptor

If known the Type of the implementation. If unknown will return the same as ActiveDescriptor.getImplementationClass()

Returns:

The type of the implementation or the implementation class

create

public T create(ServiceHandle<?> root)

Description copied from interface: ActiveDescriptor

Creates an instance of the ActiveDescriptor. All of the Injectee's must be created prior to instantiation, and associated with the ExtendedProvider so that they can be destroyed properly

Parameters:

root - The root service handle, which can be used to associated all the PerLookup objects with this creation

Returns:

An instance of this ActiveDescriptor