org.glassfish.hk2.internal

Class PerThreadContext

java.lang.Object

org.glassfish.hk2.internal.PerThreadContext

All Implemented Interfaces:

Context<PerThread>

@Singleton
public class PerThreadContext
extends Object
implements Context<PerThread>

Author:

jwells

Constructor Summary

Constructors

Constructor and Description
PerThreadContext()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	containsKey(ActiveDescriptor<?> descriptor) Determines if this context has a value for the given key
void	destroyOne(ActiveDescriptor<?> descriptor) This method is called when ServiceHandle.destroy() method is called.
<U> U	findOrCreate(ActiveDescriptor<U> activeDescriptor, ServiceHandle<?> root) Creates a contextual instance of this ActiveDescriptor by calling its create method if there is no other matching contextual instance.
Class<? extends Annotation>	getScope() The scope for which this is the context
boolean	isActive() True if this context is active, false otherwise
void	shutdown() Shut down this context.
boolean	supportsNullCreation() Returns true if the findOrCreate method can return null

Methods inherited from class java.lang.Object

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

Constructor Detail

PerThreadContext

public PerThreadContext()

Method Detail

getScope

public Class<? extends Annotation> getScope()

Description copied from interface: Context

The scope for which this is the context

Specified by:

getScope in interface Context<PerThread>

Returns:

may not return null, must return the scope for which this is a context

findOrCreate

public <U> U findOrCreate(ActiveDescriptor<U> activeDescriptor,
                 ServiceHandle<?> root)

Description copied from interface: Context

Creates a contextual instance of this ActiveDescriptor by calling its create method if there is no other matching contextual instance. If there is already a contextual instance it is returned. If parent is null then this must work like the find call

Specified by:

findOrCreate in interface Context<PerThread>

Parameters:

activeDescriptor - The descriptor to use when creating instances

root - The extended provider for the outermost parent being created

Returns:

A context instance. This value may NOT be null

containsKey

public boolean containsKey(ActiveDescriptor<?> descriptor)

Description copied from interface: Context

Determines if this context has a value for the given key

Specified by:

containsKey in interface Context<PerThread>

Parameters:

descriptor - The descriptor to look for in this context

Returns:

true if this context has a value associated with this descriptor

isActive

public boolean isActive()

Description copied from interface: Context

True if this context is active, false otherwise

Specified by:

isActive in interface Context<PerThread>

Returns:

true if this context is active, false otherwise

supportsNullCreation

public boolean supportsNullCreation()

Description copied from interface: Context

Returns true if the findOrCreate method can return null

Specified by:

supportsNullCreation in interface Context<PerThread>

Returns:

true if null is a legal value from the findOrCreate method

shutdown

public void shutdown()

Description copied from interface: Context

Shut down this context.

Specified by:

shutdown in interface Context<PerThread>

destroyOne

public void destroyOne(ActiveDescriptor<?> descriptor)

Description copied from interface: Context

This method is called when ServiceHandle.destroy() method is called. It is up to the context implementation whether or not to honor this destruction request based on the lifecycle requirements of the context

Specified by:

destroyOne in interface Context<PerThread>

Parameters:

descriptor - A non-null descriptor upon which ServiceHandle.destroy() has been called