com.helger.commons.scope

Interface IScope

All Superinterfaces:

IAttributeContainer<String,Object>, IClearable, ICommonsIterable<Map.Entry<String,Object>>, IHasID<String>, IMutableAttributeContainer<String,Object>, IMutableAttributeContainerAny<String>, Iterable<Map.Entry<String,Object>>, Serializable

All Known Subinterfaces:

IApplicationScope, IGlobalScope, IRequestScope, ISessionApplicationScope, ISessionScope

All Known Implementing Classes:

AbstractMapBasedScope, ApplicationScope, GlobalScope, RequestScope, SessionApplicationScope, SessionScope

public interface IScope
extends IMutableAttributeContainerAny<String>, 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

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

Methods inherited from interface com.helger.commons.collection.attr.IMutableAttributeContainerAny

getAndSetAttributeFlag, setAttribute, setAttribute, setAttribute, setAttribute

Methods inherited from interface com.helger.commons.collection.attr.IMutableAttributeContainer

computeIfAbsent, removeAttribute, setAttribute, setAttributes, setAttributes

Methods inherited from interface com.helger.commons.collection.attr.IAttributeContainer

containsAttribute, forAllAttributes, forAllAttributeValues, getAllAttributeNames, getAllAttributes, getAllAttributeValues, getAttributeAsBigDecimal, getAttributeAsBigDecimal, getAttributeAsBigInteger, getAttributeAsBigInteger, getAttributeAsBoolean, getAttributeAsBoolean, getAttributeAsDouble, getAttributeAsDouble, getAttributeAsInt, getAttributeAsInt, getAttributeAsLong, getAttributeAsLong, getAttributeAsString, getAttributeAsString, getAttributeCount, getAttributeObject, getCastedAttribute, getCastedAttribute, getTypedAttribute, getTypedAttribute, isEmpty, isNotEmpty, iterator

Methods inherited from interface com.helger.commons.collection.ext.ICommonsIterable

containsAny, containsNone, containsOnly, findAll, findAllInstanceOf, findAllMapped, findAllMapped, findAllMapped, findFirst, findFirst, findFirstMapped, findFirstMapped, forEach, forEach, forEachBreakable, getIteratorCount, getIteratorCount

Methods inherited from interface java.lang.Iterable

forEach, spliterator

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

clear

Methods inherited from interface com.helger.commons.id.IHasID

getComparatorID

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
               Consumer<IScope> aConsumer)

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

Parameters:

aConsumer - The consumer to be executed. May not be null. The parameter to the runnable is this scope.

runAtomic

@Nullable
<T> T runAtomic(@Nonnull
                           Function<IScope,T> aFunction)

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

Type Parameters:

T - The return type of the callable

Parameters:

aFunction - The function to be executed. May not be null. The parameter to the callable is this scope.

Returns:

The result from the callable. May be null.

getAllScopeRenewalAwareAttributes

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

Returns:

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