java.lang.Object
org.glassfish.hk2.utilities.DescriptorImpl
org.glassfish.hk2.utilities.AbstractActiveDescriptor<T>
org.glassfish.hk2.utilities.AliasDescriptor<T>
- Type Parameters:
T
- The cache type
- All Implemented Interfaces:
Externalizable
,Serializable
,ActiveDescriptor<T>
,Descriptor
,SingleCache<T>
An active descriptor class that serves as an alias for another descriptor.
This alias can have only one contract that may or may not also be
advertised by the host descriptor. An AliasDescriptor
can have a different name from the host descriptor as well
- Author:
- tbeerbower
- See Also:
-
Field Summary
Fields -
Constructor Summary
ConstructorsConstructorDescriptionFor serializationAliasDescriptor
(ServiceLocator locator, ActiveDescriptor<T> descriptor, String contract, String name) Construct an AliasDescriptor. -
Method Summary
Modifier and TypeMethodDescriptioncreate
(ServiceHandle<?> root) Creates an instance of the ActiveDescriptor.void
Disposes this instance.boolean
This equals matches only if the following fields of the descriptor match: implementation contracts name scope qualifiers descriptorType descriptorVisibility metadata proxiable proxyForSameScope analysisNameThe set of types that this ActiveDescriptor must produce.Get the descriptor being aliased.Returns the fully qualified class name of the implementation class.Class<?>
The implementation class that should be used to generate new instances of this descriptor.If known the Type of the implementation.Returns the full list of Injectees this class has.The full set of qualifiers that this ActiveDescriptor providesReturns all of the annotation classes that this object should be registered with or looked up byClass<? extends Annotation>
Returns the scope that this ActiveDescriptor belongs toint
hashCode()
boolean
This method returns true if this descriptor has been reified (class loaded).Methods inherited from class org.glassfish.hk2.utilities.AbstractActiveDescriptor
addContractType, addQualifierAnnotation, getCache, getFactoryLocatorId, getFactoryServiceId, getScopeAsAnnotation, isCacheSet, 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, 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, getRanking, getScope, getServiceId, isProxiable, isProxyForSameScope, setRanking
-
Field Details
-
ALIAS_METADATA_MARKER
This will be put in all Alias descriptors. The value will be ALIAS_FREE_DESCRIPTOR if the descritpor being aliased does not have a locator and service id. If the descriptor being aliased does have a locator and service id the value will be. - See Also:
-
ALIAS_FREE_DESCRIPTOR
This is the value the metadata field ALIAS_METADATA_MARKER will take if the descriptor being aliased does not have a locator id or a service id- See Also:
-
-
Constructor Details
-
AliasDescriptor
public AliasDescriptor()For serialization -
AliasDescriptor
public AliasDescriptor(ServiceLocator locator, ActiveDescriptor<T> descriptor, String contract, String name) Construct an AliasDescriptor.- Parameters:
locator
- the service locatordescriptor
- the descriptor to be aliasedcontract
- the contactname
- the name
-
-
Method Details
-
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
Description copied from interface:ActiveDescriptor
If known the Type of the implementation. If unknown will return the same asActiveDescriptor.getImplementationClass()
- Returns:
- The type of the implementation or the implementation class
-
create
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
-
isReified
public boolean isReified()Description copied from interface:ActiveDescriptor
This method returns true if this descriptor has been reified (class loaded). If this method returns false then the other methods in this interface will throw an IllegalStateException. Once this method returns true it may be- Specified by:
isReified
in interfaceActiveDescriptor<T>
- Overrides:
isReified
in classAbstractActiveDescriptor<T>
- Returns:
- true if this descriptor has been reified, false otherwise
-
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 interfaceDescriptor
- Overrides:
getImplementation
in classDescriptorImpl
- 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
-
getContractTypes
Description copied from interface:ActiveDescriptor
The set of types that this ActiveDescriptor must produce. These types may be Classes or ParameterizedTypes, and may be no other subclass of Type- Specified by:
getContractTypes
in interfaceActiveDescriptor<T>
- Overrides:
getContractTypes
in classAbstractActiveDescriptor<T>
- Returns:
- the set of types this ActiveDescriptor must implement or extend
-
getScopeAnnotation
Description copied from interface:ActiveDescriptor
Returns the scope that this ActiveDescriptor belongs to- Specified by:
getScopeAnnotation
in interfaceActiveDescriptor<T>
- Overrides:
getScopeAnnotation
in classAbstractActiveDescriptor<T>
- Returns:
- The scope of this ActiveDescriptor
-
getQualifierAnnotations
Description copied from interface:ActiveDescriptor
The full set of qualifiers that this ActiveDescriptor provides- Specified by:
getQualifierAnnotations
in interfaceActiveDescriptor<T>
- Overrides:
getQualifierAnnotations
in classAbstractActiveDescriptor<T>
- Returns:
- The set of annotations that this ActiveDescriptor provides
-
getQualifiers
Description copied from interface:Descriptor
Returns all of the annotation classes that this object should be registered with or looked up by- Specified by:
getQualifiers
in interfaceDescriptor
- Overrides:
getQualifiers
in classDescriptorImpl
- Returns:
- Never returns null, but may return an empty set. The set of fully qualified class names that are annotations that this object must have
-
getInjectees
Description copied from interface:ActiveDescriptor
Returns the full list of Injectees this class has. These references will be resolved prior to the class being constructed, even if these injectees are field or method injectees.If this descriptor is describing a factory created type then this list must have zero length
- Specified by:
getInjectees
in interfaceActiveDescriptor<T>
- Overrides:
getInjectees
in classAbstractActiveDescriptor<T>
- Returns:
- Will not return null, but may return an empty list. The set of Injectees that must be resolved before this ActiveDescriptor can be constructed
-
dispose
Description copied from interface:ActiveDescriptor
Disposes this instance. All the PerLookup objects that were created for this instance will be destroyed after this object has been destroyed- Specified by:
dispose
in interfaceActiveDescriptor<T>
- Overrides:
dispose
in classAbstractActiveDescriptor<T>
- Parameters:
instance
- The instance to destroy
-
getDescriptor
Get the descriptor being aliased.- Returns:
- the descriptor
-
hashCode
public int hashCode()- Overrides:
hashCode
in classAbstractActiveDescriptor<T>
-
equals
Description copied from class:DescriptorImpl
This equals matches only if the following fields of the descriptor match:- implementation
- contracts
- name
- scope
- qualifiers
- descriptorType
- descriptorVisibility
- metadata
- proxiable
- proxyForSameScope
- analysisName
- Overrides:
equals
in classAbstractActiveDescriptor<T>
- Parameters:
o
- The object to compare to this one. May be null (which will result in a false)- Returns:
- true if the descriptors are equal
-