com.helger.commons.scopes

Interface IScope

All Superinterfaces:

IAttributeContainer, IClearable, IGenericAttributeContainer<String,Object>, IGenericReadonlyAttributeContainer<String,Object>, IHasID<String>, IReadonlyAttributeContainer, Serializable

All Known Subinterfaces:

IApplicationScope, IGlobalScope, IRequestScope, ISessionApplicationScope, ISessionScope

All Known Implementing Classes:

AbstractMapBasedScope, ApplicationScope, GlobalScope, RequestScope, SessionApplicationScope, SessionScope

public interface IScope
extends IAttributeContainer, IHasID<String>

This interface is used for all the common stuff of a scope. The following types of scopes are present:

• Global scope - once and only once
• Application context - scope for an application (e.g. public and secure application in one web application)
• Session scope - for each user created session
• Session application context - scope for an application within a session
• Request scope - for each user request

IMPORTANT: implementations of IScope must be thread safe!

Author:

Philip Helger

Method Summary

Methods

Modifier and Type	Method and Description
void	destroyScope() Destroys the scopes and all child scopes.
Map<String,IScopeRenewalAware>	getAllScopeRenewalAwareAttributes()
String	getID() Get the ID of this scope.
void	initScope() Init the scope.
boolean	isDestroyed()
boolean	isInDestruction()
boolean	isValid()
<T> T	runAtomic(INonThrowingCallableWithParameter<T,IScope> aCallable) Perform stuff as a single action.
void	runAtomic(INonThrowingRunnableWithParameter<IScope> aRunnable) Perform stuff as a single action.

Methods inherited from interface com.helger.commons.collections.attrs.IAttributeContainer

getAndSetAttributeFlag, setAttribute, setAttribute, setAttribute, setAttribute

Methods inherited from interface com.helger.commons.collections.attrs.IGenericAttributeContainer

removeAttribute, setAttribute, setAttributes, setAttributes

Methods inherited from interface com.helger.commons.collections.attrs.IGenericReadonlyAttributeContainer

containsAttribute, containsNoAttribute, getAllAttributeNames, getAllAttributes, getAllAttributeValues, getAttributeAsBigDecimal, getAttributeAsBigDecimal, getAttributeAsBigInteger, getAttributeAsBigInteger, getAttributeAsBoolean, getAttributeAsBoolean, getAttributeAsDouble, getAttributeAsDouble, getAttributeAsInt, getAttributeAsInt, getAttributeAsLong, getAttributeAsLong, getAttributeAsString, getAttributeAsString, getAttributeCount, getAttributeNames, getAttributeObject, getCastedAttribute, getCastedAttribute, getTypedAttribute, getTypedAttribute

Methods inherited from interface com.helger.commons.state.IClearable

clear

Method Detail

initScope

void initScope()

Init the scope. In contrast to the constructor of a scope, this happens after the scope has been registered in the scope manager.

getID

String getID()

Get the ID of this scope. Each scope retrieves a unique ID within its type of scope (request, session, application). This method needs to be callable anytime and should not throw any exception!

Specified by:

getID in interface IHasID<String>

Returns:

the non-null ID of this context.

isValid

boolean isValid()

Returns:

true if this scope is neither in destruction nor destroyed.

See Also:

isInDestruction(), isDestroyed()

isInDestruction

boolean isInDestruction()

Returns:

true if the scope is currently in the process of destruction.

isDestroyed

boolean isDestroyed()

Returns:

true if the scope was already destroyed. This is especially important for long running scopes.

destroyScope

void destroyScope()

Destroys the scopes and all child scopes. This method is only automatically called, when a scope goes out of scope.

runAtomic

void runAtomic(@Nonnull
             INonThrowingRunnableWithParameter<IScope> aRunnable)

Perform stuff as a single action. All actions are executed in a write-lock!

Parameters:

aRunnable - The action to be executed. May not be null.

runAtomic

@Nullable
<T> T runAtomic(@Nonnull
                       INonThrowingCallableWithParameter<T,IScope> aCallable)

Perform stuff as a single action. All actions are executed in a write-lock!

Parameters:

aCallable - The action to be executed. May not be null.

Returns:

The result from the callable. May be null.

getAllScopeRenewalAwareAttributes

@Nonnull
@ReturnsMutableCopy
Map<String,IScopeRenewalAware> getAllScopeRenewalAwareAttributes()

Returns:

The non-null map with all contained attributes that implement the IScopeRenewalAware interface. May be empty.