com.helger.commons.scopes

Class AbstractMapBasedScope

java.lang.Object

com.helger.commons.collections.attrs.AbstractGenericReadonlyAttributeContainer<KEYTYPE,VALUETYPE>

com.helger.commons.collections.attrs.MapBasedGenericAttributeContainer<String,Object>

com.helger.commons.collections.attrs.MapBasedAttributeContainer

com.helger.commons.collections.attrs.MapBasedAttributeContainerThreadSafe

com.helger.commons.scopes.AbstractMapBasedScope

All Implemented Interfaces:

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

Direct Known Subclasses:

ApplicationScope, GlobalScope, RequestScope, SessionApplicationScope, SessionScope

@ThreadSafe
public abstract class AbstractMapBasedScope
extends MapBasedAttributeContainerThreadSafe
implements IScope

Abstract scope implementation based on a Map containing the attribute values.

Author:

Philip Helger

See Also:

Serialized Form

Field Summary

Fields inherited from class com.helger.commons.collections.attrs.MapBasedAttributeContainerThreadSafe

m_aRWLock

Constructor Summary

Constructors

Constructor and Description
AbstractMapBasedScope(String sScopeID) Ctor.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	destroyOwnedScopes() Override this method to destroy all scopes owned by this scope.
void	destroyScope() Destroys the scopes and all child scopes.
boolean	equals(Object o)
Map<String,IScopeRenewalAware>	getAllScopeRenewalAwareAttributes()
String	getID() Get the ID of this scope.
int	hashCode()
boolean	isDestroyed()
boolean	isInDestruction()
boolean	isValid()
protected void	postDestroy() Override this method to perform further actions AFTER the scope was destroyed.
protected void	preDestroy() Override this method to perform further actions BEFORE the scope is destroyed.
<T> T	runAtomic(INonThrowingCallableWithParameter<T,IScope> aCallable) Perform stuff as a single action.
void	runAtomic(INonThrowingRunnableWithParameter<IScope> aRunnable) Perform stuff as a single action.
String	toString()

Methods inherited from class com.helger.commons.collections.attrs.MapBasedAttributeContainerThreadSafe

clear, containsAttribute, containsNoAttribute, getAllAttributeNames, getAllAttributes, getAllAttributeValues, getAndSetAttributeFlag, getAttributeCount, getAttributeNames, getAttributeObject, getClone, removeAttribute, setAttribute

Methods inherited from class com.helger.commons.collections.attrs.MapBasedAttributeContainer

setAttribute, setAttribute, setAttribute, setAttribute

Methods inherited from class com.helger.commons.collections.attrs.MapBasedGenericAttributeContainer

onBeforeRemoveAttribute, onBeforeSetAttributeValue, setAttributes, setAttributes

Methods inherited from class com.helger.commons.collections.attrs.AbstractGenericReadonlyAttributeContainer

getAsBigDecimal, getAsBigInteger, getAsBoolean, getAsDouble, getAsInt, getAsLong, getAsString, getAttributeAsBigDecimal, getAttributeAsBigDecimal, getAttributeAsBigInteger, getAttributeAsBigInteger, getAttributeAsBoolean, getAttributeAsBoolean, getAttributeAsDouble, getAttributeAsDouble, getAttributeAsInt, getAttributeAsInt, getAttributeAsLong, getAttributeAsLong, getAttributeAsString, getAttributeAsString, getCastedAttribute, getCastedAttribute, getTypedAttribute, getTypedAttribute

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.helger.commons.scopes.IScope

initScope

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

Constructor Detail

AbstractMapBasedScope

public AbstractMapBasedScope(@Nonnull@Nonempty
                     String sScopeID)

Ctor.

Parameters:

sScopeID - The scope ID. May neither be null nor empty.

Method Detail

getID

@Nonnull
@Nonempty
public final String getID()

Description copied from interface: IScope

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>

Specified by:

getID in interface IScope

Returns:

the non-null ID of this context.

isValid

public final boolean isValid()

Specified by:

isValid in interface IScope

Returns:

true if this scope is neither in destruction nor destroyed.

See Also:

IScope.isInDestruction(), IScope.isDestroyed()

isInDestruction

public final boolean isInDestruction()

Specified by:

isInDestruction in interface IScope

Returns:

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

isDestroyed

public final boolean isDestroyed()

Specified by:

isDestroyed in interface IScope

Returns:

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

preDestroy

@OverrideOnDemand
protected void preDestroy()

Override this method to perform further actions BEFORE the scope is destroyed.

destroyOwnedScopes

@OverrideOnDemand
protected void destroyOwnedScopes()

Override this method to destroy all scopes owned by this scope.

postDestroy

@OverrideOnDemand
protected void postDestroy()

Override this method to perform further actions AFTER the scope was destroyed.

destroyScope

public final void destroyScope()

Description copied from interface: IScope

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

Specified by:

destroyScope in interface IScope

runAtomic

public final void runAtomic(@Nonnull
             INonThrowingRunnableWithParameter<IScope> aRunnable)

Description copied from interface: IScope

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

Specified by:

runAtomic in interface IScope

Parameters:

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

runAtomic

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

Description copied from interface: IScope

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

Specified by:

runAtomic in interface IScope

Parameters:

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

Returns:

The result from the callable. May be null.

getAllScopeRenewalAwareAttributes

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

Specified by:

getAllScopeRenewalAwareAttributes in interface IScope

Returns:

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

equals

public boolean equals(Object o)

Overrides:

equals in class MapBasedAttributeContainerThreadSafe

hashCode

public int hashCode()

Overrides:

hashCode in class MapBasedAttributeContainerThreadSafe

toString

public String toString()

Overrides:

toString in class MapBasedGenericAttributeContainer<String,Object>