com.helger.commons.collections.attrs

Class MapBasedAttributeContainerThreadSafe

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

All Implemented Interfaces:

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

@ThreadSafe
public class MapBasedAttributeContainerThreadSafe
extends MapBasedAttributeContainer

Base class for all kind of string-object mapping container. This implementation is a thread-safe wrapper around MapBasedAttributeContainer!

Author:

Philip Helger

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected ReadWriteLock	m_aRWLock

Constructor Summary

Constructors

Constructor and Description
MapBasedAttributeContainerThreadSafe()
MapBasedAttributeContainerThreadSafe(IReadonlyAttributeContainer aCont)
MapBasedAttributeContainerThreadSafe(Map<String,?> aMap)

Method Summary

Methods

Modifier and Type	Method and Description
EChange	clear() Reset the contents of the element to the after-construction state.
boolean	containsAttribute(String sName) Check if an attribute of the given name is contained.
boolean	containsNoAttribute()
boolean	equals(Object o)
Set<String>	getAllAttributeNames()
Map<String,Object>	getAllAttributes()
Collection<Object>	getAllAttributeValues()
boolean	getAndSetAttributeFlag(String sName) Atomic operation to set a flag to true if it was previously set to false (meaning not existing).
int	getAttributeCount()
Enumeration<String>	getAttributeNames() Get an enumerator over all contained attribute names.
Object	getAttributeObject(String sName) Get the attribute value associated to the given attribute name.
MapBasedAttributeContainerThreadSafe	getClone()
int	hashCode()
EChange	removeAttribute(String sName) Remove the specified attribute from the container.
EChange	setAttribute(String sName, Object aValue) Set/overwrite an attribute value.

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, toString

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.collections.attrs.IGenericAttributeContainer

setAttributes, setAttributes

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

getAttributeAsBigDecimal, getAttributeAsBigDecimal, getAttributeAsBigInteger, getAttributeAsBigInteger, getAttributeAsBoolean, getAttributeAsBoolean, getAttributeAsDouble, getAttributeAsDouble, getAttributeAsInt, getAttributeAsInt, getAttributeAsLong, getAttributeAsLong, getAttributeAsString, getAttributeAsString, getCastedAttribute, getCastedAttribute, getTypedAttribute, getTypedAttribute

Field Detail

m_aRWLock

protected final ReadWriteLock m_aRWLock

Constructor Detail

MapBasedAttributeContainerThreadSafe

public MapBasedAttributeContainerThreadSafe()

MapBasedAttributeContainerThreadSafe

public MapBasedAttributeContainerThreadSafe(@Nonnull
                                    Map<String,?> aMap)

MapBasedAttributeContainerThreadSafe

public MapBasedAttributeContainerThreadSafe(@Nonnull
                                    IReadonlyAttributeContainer aCont)

Method Detail

containsAttribute

public boolean containsAttribute(@Nullable
                        String sName)

Description copied from interface: IGenericReadonlyAttributeContainer

Check if an attribute of the given name is contained.

Specified by:

containsAttribute in interface IGenericReadonlyAttributeContainer<String,Object>

Overrides:

containsAttribute in class MapBasedGenericAttributeContainer<String,Object>

Parameters:

sName - name of the attribute to check

Returns:

true if the attribute is contained, false otherwise

getAllAttributes

@Nonnull
@ReturnsMutableCopy
public Map<String,Object> getAllAttributes()

Specified by:

getAllAttributes in interface IGenericReadonlyAttributeContainer<String,Object>

Overrides:

getAllAttributes in class MapBasedGenericAttributeContainer<String,Object>

Returns:

The non-null map with all contained attributes.

getAttributeObject

@Nullable
public Object getAttributeObject(@Nullable
                                 String sName)

Description copied from interface: IGenericReadonlyAttributeContainer

Get the attribute value associated to the given attribute name.

Specified by:

getAttributeObject in interface IGenericReadonlyAttributeContainer<String,Object>

Overrides:

getAttributeObject in class MapBasedGenericAttributeContainer<String,Object>

Parameters:

sName - the attribute name

Returns:

null if no such value exists

setAttribute

@Nonnull
public EChange setAttribute(@Nonnull
                           String sName,
                           @Nullable
                           Object aValue)

Description copied from interface: IGenericAttributeContainer

Set/overwrite an attribute value.

Specified by:

setAttribute in interface IGenericAttributeContainer<String,Object>

Overrides:

setAttribute in class MapBasedGenericAttributeContainer<String,Object>

Parameters:

sName - The name of the attribute. May not be null.

aValue - The value of the attribute. If it is null, the value will be removed.

Returns:

EChange.CHANGED if something changed, EChange.UNCHANGED otherwise.

See Also:

IGenericAttributeContainer.removeAttribute(Object)

removeAttribute

@Nonnull
public EChange removeAttribute(@Nullable
                              String sName)

Description copied from interface: IGenericAttributeContainer

Remove the specified attribute from the container.

Specified by:

removeAttribute in interface IGenericAttributeContainer<String,Object>

Overrides:

removeAttribute in class MapBasedGenericAttributeContainer<String,Object>

Parameters:

sName - The attribute name to be removed. If it is null nothing happens.

Returns:

EChange.CHANGED if something changed, EChange.UNCHANGED otherwise.

getAttributeNames

@Nonnull
@ReturnsMutableCopy
public Enumeration<String> getAttributeNames()

Description copied from interface: IGenericReadonlyAttributeContainer

Get an enumerator over all contained attribute names.

Specified by:

getAttributeNames in interface IGenericReadonlyAttributeContainer<String,Object>

Overrides:

getAttributeNames in class MapBasedGenericAttributeContainer<String,Object>

Returns:

an Enumerator over all attribute names

getAllAttributeNames

@Nonnull
@ReturnsMutableCopy
public Set<String> getAllAttributeNames()

Specified by:

getAllAttributeNames in interface IGenericReadonlyAttributeContainer<String,Object>

Overrides:

getAllAttributeNames in class MapBasedGenericAttributeContainer<String,Object>

Returns:

A non-null set of all attribute names.

getAllAttributeValues

@Nonnull
@ReturnsMutableCopy
public Collection<Object> getAllAttributeValues()

Specified by:

getAllAttributeValues in interface IGenericReadonlyAttributeContainer<String,Object>

Overrides:

getAllAttributeValues in class MapBasedGenericAttributeContainer<String,Object>

Returns:

A non-null collection of all attribute values.

getAttributeCount

@Nonnegative
public int getAttributeCount()

Specified by:

getAttributeCount in interface IGenericReadonlyAttributeContainer<String,Object>

Overrides:

getAttributeCount in class MapBasedGenericAttributeContainer<String,Object>

Returns:

The number of contained attributes. Always ≥ 0.

containsNoAttribute

public boolean containsNoAttribute()

Specified by:

containsNoAttribute in interface IGenericReadonlyAttributeContainer<String,Object>

Overrides:

containsNoAttribute in class MapBasedGenericAttributeContainer<String,Object>

Returns:

true if this attribute container does not contain any attribute at all, false if at least one attribute is contained.

clear

@Nonnull
public EChange clear()

Description copied from interface: IClearable

Reset the contents of the element to the after-construction state.

Specified by:

clear in interface IClearable

Overrides:

clear in class MapBasedGenericAttributeContainer<String,Object>

Returns:

EChange.CHANGED if at least one element was cleared, EChange.UNCHANGED otherwise.

getAndSetAttributeFlag

public boolean getAndSetAttributeFlag(@Nonnull
                             String sName)

Description copied from interface: IAttributeContainer

Atomic operation to set a flag to true if it was previously set to false (meaning not existing). There is no possibility to define a value for this flag. The value used is Boolean.TRUE. #containsAttribute(String) can be used to check if the attribute is already present.

Specified by:

getAndSetAttributeFlag in interface IAttributeContainer

Overrides:

getAndSetAttributeFlag in class MapBasedAttributeContainer

Parameters:

sName - The name of the flag to set.

Returns:

The old value of the flag. If the flag was not present previously, than false is returned, whereas if the flag was already present, true is returned. Any other than the first call for the same flag is always returning true.

getClone

@Nonnull
public MapBasedAttributeContainerThreadSafe getClone()

Specified by:

getClone in interface ICloneable<MapBasedGenericAttributeContainer<String,Object>>

Overrides:

getClone in class MapBasedAttributeContainer

Returns:

A 100% deep-copy of the implementing class.

equals

public boolean equals(Object o)

Overrides:

equals in class MapBasedGenericAttributeContainer<String,Object>

hashCode

public int hashCode()

Overrides:

hashCode in class MapBasedGenericAttributeContainer<String,Object>