hk2 4.0.1 · org.jvnet.hk2.internal.ServiceLocatorImpl

Modifier and Type	Class and Description
private static class	ServiceLocatorImpl.CheckConfigurationData
private static class	ServiceLocatorImpl.IgdCacheKey
private class	ServiceLocatorImpl.IgdValue
private static class	ServiceLocatorImpl.UnqualifiedIndexedFilter

Modifier and Type	Field and Description
private final IndexedListData	allDescriptors
private ConcurrentHashMap<Class<? extends Annotation>, InjectionResolver<?>>	allResolvers
private final ReentrantLock	allResolversLock
private final LinkedHashSet<ValidationService>	allValidators
private static final String	BIND_TRACING_PATTERN
private static final String	BIND_TRACING_PATTERN_PROPERTY
private static final boolean	BIND_TRACING_STACKS
private static final String	BIND_TRACING_STACKS_PROPERTY
private static final int	CACHE_SIZE
private final Map<ServiceLocatorImpl, ServiceLocatorImpl>	children
private final ReentrantLock	childrenLock
private final HashMap<String, ClassAnalyzer>	classAnalyzers
private final ClassReflectionHelper	classReflectionHelper
private final LinkedList<ServiceHandle<?>>	configListeners
private final Cache<Class<? extends Annotation>, Context<?>>	contextCache
private static long	currentLocatorId
private String	defaultClassAnalyzer
private volatile Unqualified	defaultUnqualified
pack-priv static final DescriptorComparator	DESCRIPTOR_COMPARATOR
private final HashMap<String, IndexedListData>	descriptorsByAdvertisedContract
private final HashMap<String, IndexedListData>	descriptorsByName
private final LinkedList<ErrorService>	errorHandlers
private static final ServiceHandleComparator	HANDLE_COMPARATOR
private volatile boolean	hasInterceptionServices
private final long	id
private final WeakCARCache<ServiceLocatorImpl.IgdCacheKey, ServiceLocatorImpl.IgdValue>	igashCache
private final WeakCARCache<ServiceLocatorImpl.IgdCacheKey, ServiceLocatorImpl.IgdValue>	igdCache
private final Cache<SystemInjecteeImpl, InjectionResolver<?>>	injecteeToResolverCache
private final LinkedList<InterceptionService>	interceptionServices
private final String	locatorName
private volatile boolean	neutralContextClassLoader
private final AtomicLong	nextServiceId
private final ServiceLocatorImpl	parent
private final PerLocatorUtilities	perLocatorUtilities
private final Context<PerLookup>	perLookupContext
private final ReentrantReadWriteLock	readWriteLock
private final ReentrantReadWriteLock.ReadLock	rLock
private final Context<Singleton>	singletonContext
private static final ReentrantLock	sLock
private ServiceLocatorState	state
private final ReentrantReadWriteLock.WriteLock	wLock

Access	Constructor and Description
public	ServiceLocatorImpl(String The name of this locator name, ServiceLocatorImpl The parent of this locator (may be null) parent) Called by the Generator, and hence must be a public method

Method Summary

Modifier and Type	Method and Description
private Context<?>	_resolveContext(final Class<? extends Annotation> scope)
private void	addChild(ServiceLocatorImpl child)
pack-priv void	addConfiguration(DynamicConfigurationImpl dci)
private List<SystemDescriptor<?>>	addConfigurationInternal(DynamicConfigurationImpl dci)
public Object	assistedInject(Object injectMe, Method method, MethodParameter... params) Implements org.glassfish.hk2.api.ServiceLocator.assistedInject. This will invoke the given method on the given object.
public Object	assistedInject(Object injectMe, Method method, ServiceHandle<?> root, MethodParameter... params) Implements org.glassfish.hk2.api.ServiceLocator.assistedInject. This will invoke the given method on the given object.
private void	callAllConfigurationListeners(List<ServiceHandle<?>> allListeners)
private boolean	callValidate(ValidationService vs, ValidationInformation The non-null validation vi) Must have read lock held
private ServiceLocatorImpl.CheckConfigurationData	Returns: A set of descriptors that is being removed fromthe configuration checkConfiguration(DynamicConfigurationImpl The configuration that contains the proposed modifications dci) Checks the configuration operation before anything happens to the internal data structures.
private void	checkState()
pack-priv void	clearReflectionCache()
pack-priv void	clearServiceCache()
public <T> T	create(Class<T> createMe) Implements org.glassfish.hk2.api.ServiceLocator.create. This method will analyze the given class, and create it if can.
public <T> T	create(Class<T> createMe, String strategy) Implements org.glassfish.hk2.api.ServiceLocator.create. This method will analyze the given class, and create it if can.
public <U> U	createAndInitialize(Class<U> createMe) Implements org.glassfish.hk2.api.ServiceLocator.createAndInitialize. Creates, injects and postConstructs, all in one
public <U> U	createAndInitialize(Class<U> createMe, String strategy) Implements org.glassfish.hk2.api.ServiceLocator.createAndInitialize. Creates, injects and postConstructs, all in one
private static boolean	doTrace(ActiveDescriptor<?> desc)
private void	getAllChildren(LinkedList<ServiceLocatorImpl> allMyChildren)
private static List<String>	getAllContracts(ActiveDescriptor<?> desc)
public <T> List<ServiceHandle<T>>	getAllServiceHandles(Class<T> contractOrImpl, Annotation... qualifiers) Implements org.glassfish.hk2.api.ServiceLocator.getAllServiceHandles. Gets a list of `ServiceHandle` that can be used to get and destroy services associated with descriptors that match the provided criteria
public List<ServiceHandle<?>>	getAllServiceHandles(Type contractOrImpl, Annotation... qualifiers) Implements org.glassfish.hk2.api.ServiceLocator.getAllServiceHandles. Gets a list of `ServiceHandle` that can be used to get and destroy services associated with descriptors that match the provided criteria
public List<ServiceHandle<?>>	getAllServiceHandles(Filter searchCriteria) Implements org.glassfish.hk2.api.ServiceLocator.getAllServiceHandles. Gets a list of `ServiceHandle` whose `ActiveDescriptor`s match the supplied filter.
public List<ServiceHandle<?>>	getAllServiceHandles(Annotation qualifier, Annotation... qualifiers) Implements org.glassfish.hk2.api.ServiceLocator.getAllServiceHandles. Gets a list of `ServiceHandle` that can be used to get and destroy services associated with descriptors that match the provided criteria
public <T> List<T>	getAllServices(Class<T> contractOrImpl, Annotation... qualifiers) Implements org.glassfish.hk2.api.ServiceLocator.getAllServices. Gets all services from this locator that implement this contract or have this implementation and have the provided qualifiers Use this method only if destroying the service is not important, otherwise use `ServiceLocator#getAllServiceHandles(Class, Annotation...)`
public <T> List<T>	getAllServices(Type contractOrImpl, Annotation... qualifiers) Implements org.glassfish.hk2.api.ServiceLocator.getAllServices. Gets all services from this locator that implement this contract or have this implementation and have the provided qualifiers Use this method only if destroying the service is not important, otherwise use `ServiceLocator#getAllServiceHandles(Type, Annotation...)`
public <T> List<T>	getAllServices(Annotation qualifier, Annotation... qualifiers) Implements org.glassfish.hk2.api.ServiceLocator.getAllServices. Gets all services from this locator that have the provided qualifiers Use this method only if destroying the services is not important, otherwise use `ServiceLocator#getAllServiceHandles(Annotation, Annotation...)`
public List<?>	getAllServices(Filter searchCriteria) Implements org.glassfish.hk2.api.ServiceLocator.getAllServices. Gets all services from this locator that match the provided `Filter` Use this method only if destroying the service is not important, otherwise use `ServiceLocator#getAllServiceHandles(Filter)` This method should also be used with care to avoid classloading a large number of services
pack-priv List<ServiceHandle<?>>	getAllUnqualifiedServiceHandles(Type contractOrImpl, Unqualified unqualified, boolean isIterable, Annotation... qualifiers)
private LinkedHashSet<ValidationService>	getAllValidators()
pack-priv ClassAnalyzer	getAnalyzer(String name, Collector collector)
private static long	getAndIncrementLocatorId()
public ActiveDescriptor<?>	getBestDescriptor(Filter filter) Implements org.glassfish.hk2.api.ServiceLocator.getBestDescriptor. Gets the descriptor that best matches this filter, taking ranking and service id into account
pack-priv ClassReflectionHelper	getClassReflectionHelper()
public String	getDefaultClassAnalyzerName() Implements org.glassfish.hk2.api.ServiceLocator.getDefaultClassAnalyzerName. Gets the name of the default class analyzer service
public Unqualified	getDefaultUnqualified() Implements org.glassfish.hk2.api.ServiceLocator.getDefaultUnqualified. This returns the default `Unqualified` annotation that will be put on all injection points that do not have any qualifiers.
private List<SystemDescriptor<?>>	getDescriptors(Filter filter, Injectee onBehalfOf, boolean getParents, boolean doValidation, boolean getLocals)
public List<ActiveDescriptor<?>>	getDescriptors(Filter filter) Implements org.glassfish.hk2.api.ServiceLocator.getDescriptors. Gets the list of descriptors that match the given filter
private Unqualified	getEffectiveUnqualified(Unqualified givenUnqualified, boolean isIterable, Annotation[] qualifiers)
pack-priv LinkedList<ErrorService>	getErrorHandlers()
public ActiveDescriptor<?>	getInjecteeDescriptor(Injectee injectee) Implements org.glassfish.hk2.api.ServiceLocator.getInjecteeDescriptor. This method will first find a descriptor for this injectee, and then reify that descriptor.
pack-priv InjectionResolver<?>	getInjectionResolver(Class<? extends Annotation> annoType)
pack-priv InjectionResolver<?>	getInjectionResolverForInjectee(SystemInjecteeImpl injectee)
pack-priv List<InterceptionService>	getInterceptionServices()
public long	getLocatorId() Implements org.glassfish.hk2.api.ServiceLocator.getLocatorId. This returns the unique locator ID for this locator.
private ServiceLocatorImpl	Returns: This current object getMe() Used to get the ServiceLocatorImpl in inner classes
public String	getName() Implements org.glassfish.hk2.api.ServiceLocator.getName. Returns the name of this ServiceLocator
private static String	getName(String name, Annotation... qualifiers)
public boolean	getNeutralContextClassLoader() Implements org.glassfish.hk2.api.ServiceLocator.getNeutralContextClassLoader. This returns the value of neutralContextClassLoader.
pack-priv long	getNextServiceId()
pack-priv int	getNumberOfChildren()
pack-priv int	getNumberOfDescriptors()
public ServiceLocator	getParent() Implements org.glassfish.hk2.api.ServiceLocator.getParent. Gets the parent service locator for this locator
pack-priv PerLocatorUtilities	getPerLocatorUtilities()
pack-priv int	getReflectionCacheSize()
public <T> T	getService(ActiveDescriptor<T> activeDescriptor, ServiceHandle<?> root) Implements org.glassfish.hk2.api.ServiceLocator.getService. Deprecated This method should be called by code resolving injectee's on behalf of some root service, usually by an implementation of `InjectionResolver#resolve(Injectee, ServiceHandle)`.
public <T> T	getService(ActiveDescriptor<T> activeDescriptor, ServiceHandle<?> root, Injectee originalRequest) Implements org.glassfish.hk2.api.ServiceLocator.getService. This method should be called by code resolving injectee's on behalf of some root service, usually by an implementation of `InjectionResolver#resolve(Injectee, ServiceHandle)`.
public <T> T	getService(Class<T> contractOrImpl, Annotation... qualifiers) Implements org.glassfish.hk2.api.ServiceLocator.getService. Gets the best service from this locator that implements this contract or has this implementation Use this method only if destroying the service is not important, otherwise use `ServiceLocator#getServiceHandle(Class, Annotation...)`
public <T> T	getService(Type contractOrImpl, Annotation... qualifiers) Implements org.glassfish.hk2.api.ServiceLocator.getService. Gets the best service from this locator that implements this contract or has this implementation Use this method only if destroying the service is not important, otherwise use `ServiceLocator#getServiceHandle(Type, Annotation...)`
public <T> T	getService(Class<T> contractOrImpl, String name, Annotation... qualifiers) Implements org.glassfish.hk2.api.ServiceLocator.getService. Gets the best service from this locator that implements this contract or has this implementation and has the given name Use this method only if destroying the service is not important, otherwise use `ServiceLocator#getServiceHandle(Class, String, Annotation...)`
public <T> T	getService(Type contractOrImpl, String name, Annotation... qualifiers) Implements org.glassfish.hk2.api.ServiceLocator.getService. Gets the best service from this locator that implements this contract or has this implementation and has the given name Use this method only if destroying the service is not important, otherwise use `ServiceLocator#getServiceHandle(Type, String, Annotation...)`
pack-priv int	getServiceCacheMaximumSize()
pack-priv int	getServiceCacheSize()
public <T> ServiceHandle<T>	getServiceHandle(ActiveDescriptor<T> activeDescriptor, Injectee injectee) Implements org.glassfish.hk2.api.ServiceLocator.getServiceHandle. Gets a `ServiceHandle` that can be used to get and destroy the service described by the `ActiveDescriptor`.
public <T> ServiceHandle<T>	getServiceHandle(ActiveDescriptor<T> activeDescriptor) Implements org.glassfish.hk2.api.ServiceLocator.getServiceHandle. Gets a `ServiceHandle` that can be used to get and destroy the service described by the `ActiveDescriptor`.
public <T> ServiceHandle<T>	getServiceHandle(Class<T> contractOrImpl, Annotation... qualifiers) Implements org.glassfish.hk2.api.ServiceLocator.getServiceHandle. Gets a `ServiceHandle` that can be used to get and destroy the service that best matches the given criteria
public <T> ServiceHandle<T>	getServiceHandle(Type contractOrImpl, Annotation... qualifiers) Implements org.glassfish.hk2.api.ServiceLocator.getServiceHandle. Gets a `ServiceHandle` that can be used to get and destroy the service that best matches the given criteria
public <T> ServiceHandle<T>	getServiceHandle(Class<T> contractOrImpl, String name, Annotation... qualifiers) Implements org.glassfish.hk2.api.ServiceLocator.getServiceHandle. Gets a `ServiceHandle` that can be used to get and destroy the service that best matches the given criteria
public <T> ServiceHandle<T>	getServiceHandle(Type contractOrImpl, String name, Annotation... qualifiers) Implements org.glassfish.hk2.api.ServiceLocator.getServiceHandle. Gets a `ServiceHandle` that can be used to get and destroy the service that best matches the given criteria
private <T> ServiceHandleImpl<T>	getServiceHandleImpl(ActiveDescriptor<T> activeDescriptor, Injectee injectee)
public ServiceLocatorState	getState() Implements org.glassfish.hk2.api.ServiceLocator.getState. Returns the current state of this service locator.
pack-priv <T> T	getUnqualifiedService(Type contractOrImpl, Unqualified unqualified, boolean isIterable, Annotation... qualifiers) This method is only called from the get of IterableProvider.
pack-priv <T> ServiceHandle<T>	getUnqualifiedServiceHandle(Type contractOrImpl, Unqualified unqualified, boolean isIterable, Annotation... qualifiers)
pack-priv boolean	hasInjectAnnotation(AnnotatedElement annotated)
private ServiceLocatorImpl.IgdValue	igdCacheCompute(final ServiceLocatorImpl.IgdCacheKey key)
public void	inject(Object injectMe) Implements org.glassfish.hk2.api.ServiceLocator.inject. This will analyze the given object and inject into its fields and methods.
public void	inject(Object injectMe, String strategy) Implements org.glassfish.hk2.api.ServiceLocator.inject. This will analyze the given object and inject into its fields and methods.
private List<?>	internalGetAllServiceHandles(Type contractOrImpl, Unqualified unqualified, boolean getHandles, boolean isIterable, Annotation... qualifiers)
private <T> ActiveDescriptor<T>	internalGetDescriptor(Injectee onBehalfOf, Type contractOrImpl, String name, Unqualified unqualified, boolean isIterable, Annotation... qualifiers)
private <T> ActiveDescriptor<T>	internalGetDescriptor(Injectee onBehalfOf, Type contractOrImpl, String name, Unqualified unqualified, boolean isIterable, boolean calledFromSecondChanceResolveMethod, Annotation... qualifiers)
private ActiveDescriptor<?>	internalGetInjecteeDescriptor(Injectee injectee, boolean calledFromSecondChanceResolveMethod)
private <T> T	internalGetService(Type contractOrImpl, String name, Unqualified unqualified, Annotation... qualifiers)
private <T> T	internalGetService(Type contractOrImpl, String name, Unqualified unqualified, boolean calledFromSecondChanceResolveMethod, Annotation... qualifiers)
private <T> ServiceHandleImpl<T>	internalGetServiceHandle(ActiveDescriptor<T> activeDescriptor, Type requestedType, Injectee originalRequest)
pack-priv boolean	isInjectAnnotation(Annotation annotation)
pack-priv boolean	isInjectAnnotation(Annotation annotation, boolean isConstructor)
public boolean	isShutdown() Implements org.glassfish.hk2.api.ServiceLocator.isShutdown. Returns whether the state of this service locator is shutdown.
private Class<?>	loadClass(Descriptor descriptor, Injectee injectee)
private ImmediateResults	narrow(ServiceLocator locator, List<SystemDescriptor<?>> candidates, Type requiredType, String name, Injectee injectee, boolean onlyOne, boolean doValidation, NarrowResults cachedResults, Filter filter, Annotation... qualifiers)
public void	postConstruct(Object postConstructMe) Implements org.glassfish.hk2.api.ServiceLocator.postConstruct. This will analyze the given object and call the postConstruct method.
public void	postConstruct(Object postConstructMe, String strategy) Implements org.glassfish.hk2.api.ServiceLocator.postConstruct. This will analyze the given object and call the postConstruct method.
public void	preDestroy(Object preDestroyMe) Implements org.glassfish.hk2.api.ServiceLocator.preDestroy. This will analyze the given object and call the preDestroy method.
public void	preDestroy(Object preDestroyMe, String strategy) Implements org.glassfish.hk2.api.ServiceLocator.preDestroy. This will analyze the given object and call the preDestroy method.
private List<ServiceHandle<?>>	protectedGetAllServiceHandles(final Type contractOrImpl, final Annotation... qualifiers)
private <T> List<T>	protectedGetAllServices(final Type contractOrImpl, final Annotation... qualifiers)
private List<ActiveDescriptor<?>>	protectedGetDescriptors(final Filter filter)
public ActiveDescriptor<?>	reifyDescriptor(Descriptor descriptor, Injectee injectee) Implements org.glassfish.hk2.api.ServiceLocator.reifyDescriptor. Converts a descriptor to an ActiveDescriptor.
public ActiveDescriptor<?>	reifyDescriptor(Descriptor descriptor) Implements org.glassfish.hk2.api.ServiceLocator.reifyDescriptor. Converts a descriptor to an ActiveDescriptor.
private void	removeChild(ServiceLocatorImpl child)
private void	removeConfigurationInternal(List<SystemDescriptor<?>> unbinds)
pack-priv Context<?>	resolveContext(Class<? extends Annotation> scope)
private void	reup(List<SystemDescriptor<?>> thingsAdded, boolean instanceListenersModified, boolean injectionResolversModified, boolean errorHandlersModified, boolean classAnalyzersModified, boolean dynamicConfigurationListenersModified, HashSet<String> affectedContracts, boolean interceptionServicesModified)
private void	reupCache(HashSet<String> affectedContracts)
private void	reupClassAnalyzers()
private void	reupConfigListeners()
private void	reupErrorHandlers()
private void	reupInjectionResolvers()
private void	reupInstanceListenersHandlers(Collection<SystemDescriptor<?>> checkList)
private void	reupInterceptionServices()
private ActiveDescriptor<?>	secondChanceResolve(Injectee injectee)
public void	setDefaultClassAnalyzerName(String defaultClassAnalyzer) Implements org.glassfish.hk2.api.ServiceLocator.setDefaultClassAnalyzerName. Sets the name of the default class analyzer that should be used for all `Descriptor`s that return null as their class analyzer.
public void	setDefaultUnqualified(Unqualified unqualified) Implements org.glassfish.hk2.api.ServiceLocator.setDefaultUnqualified. This sets the default `Unqualified` annotation that will be put on all injection points that do not have any qualifiers.
public void	setNeutralContextClassLoader(boolean neutralContextClassLoader) Implements org.glassfish.hk2.api.ServiceLocator.setNeutralContextClassLoader. This sets the value of neutralContextClassLoader.
public void	shutdown() Implements org.glassfish.hk2.api.ServiceLocator.shutdown. This method will shutdown every service associated with this ServiceLocator.
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.
pack-priv int	unsortIndexes(int newRank, SystemDescriptor<?> desc, Set<IndexedListData> myLists)
private boolean	Returns: true if every validator returned true validate(SystemDescriptor<?> The descriptor to validate descriptor, Injectee The fella who is being validated (or null) onBehalfOf, Filter filter) Must be called under lock

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

public Class ServiceLocatorImpl

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary