Package javax.enterprise.context.spi
Interface Context
-
- All Known Subinterfaces:
AlterableContext
public interface Context
Every webbeans component has an associated context that are defined by theNormalScope
annotation. Webbeans components that are contained in the context are managed by the webbeans container.Every context has a well-defined lifecycle. It means that in some time, context is active and some other time context may be passive. Moreover, each context is created and destroyed by the container according to the timing requirements. For example, request context is started by every http request and destroyed at the end of the http response. According to the current thread, active context is called an thread current context.
Context is responsible for creating and destroying the
Contextual
instances of the webbeans components.- Version:
- $Rev: 815435 $ $Date: 2009-09-15 20:18:44 +0200 (Tue, 15 Sep 2009) $
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description <T> T
get(Contextual<T> component)
Returns the instance of the webbeans in this context if exist otherwise return null.<T> T
get(Contextual<T> component, CreationalContext<T> creationalContext)
If the context is not active, throwsContextNotActiveException
.java.lang.Class<? extends java.lang.annotation.Annotation>
getScope()
Returns the scope type of the context.boolean
isActive()
Returns true if context is active according to the current thread, returns false otherwise.
-
-
-
Method Detail
-
getScope
java.lang.Class<? extends java.lang.annotation.Annotation> getScope()
Returns the scope type of the context.- Returns:
- the scope type of the context
-
get
<T> T get(Contextual<T> component, CreationalContext<T> creationalContext)
If the context is not active, throwsContextNotActiveException
. Otherwise, it looks for the given component instance in the context map. If this context contains the given webbeans component instance, it returns the component. If the component is not found in this context map, it looks for thecreationalContext
argument. If it is null, it returns null, otherwise new webbeans instance is created and puts into the context and returns it.- Type Parameters:
T
- type of the webbeans component- Parameters:
component
- webbeans componentcreationalContext
-CreationalContext
instance- Returns:
- the contextual instance or null
-
get
<T> T get(Contextual<T> component)
Returns the instance of the webbeans in this context if exist otherwise return null.- Type Parameters:
T
- type of the webbeans component- Parameters:
component
- webbeans component- Returns:
- the instance of the webbeans in this context if exist otherwise return null
-
isActive
boolean isActive()
Returns true if context is active according to the current thread, returns false otherwise.- Returns:
- true if context is active according to the current thread, return false otherwise
-
-