com.helger.commons.collection.attr

Interface IMutableAttributeContainer<KEYTYPE,VALUETYPE>

Type Parameters:

KEYTYPE - Key type

VALUETYPE - Value type

All Superinterfaces:

IAttributeContainer<KEYTYPE,VALUETYPE>, IClearable, ICommonsIterable<Map.Entry<KEYTYPE,VALUETYPE>>, Iterable<Map.Entry<KEYTYPE,VALUETYPE>>, Serializable

All Known Subinterfaces:

IApplicationScope, IGlobalScope, IMutableAttributeContainerAny<KEYTYPE>, IRequestScope, IScope, ISessionApplicationScope, ISessionScope

All Known Implementing Classes:

AbstractMapBasedScope, ApplicationScope, GlobalScope, MapBasedAttributeContainer, MapBasedAttributeContainerAny, RequestScope, SessionApplicationScope, SessionScope

public interface IMutableAttributeContainer<KEYTYPE,VALUETYPE>
extends IAttributeContainer<KEYTYPE,VALUETYPE>, IClearable

This is the writable extension of the IAttributeContainer. null values are not allowed in this attribute containers.

Author:

Philip Helger

Method Summary

Modifier and Type	Method and Description
default VALUETYPE	computeIfAbsent(KEYTYPE aName, Function<? super KEYTYPE,? extends VALUETYPE> aValueProvider) Compute an attribute value if it is not present.
EChange	removeAttribute(KEYTYPE aName) Remove the specified attribute from the container.
EChange	setAttribute(KEYTYPE aName, VALUETYPE aValue) Set/overwrite an attribute value.
EChange	setAttributes(IAttributeContainer<? extends KEYTYPE,? extends VALUETYPE> aValues) Set/overwrite an arbitrary number of attribute values.
EChange	setAttributes(Map<? extends KEYTYPE,? extends VALUETYPE> aValues) Set/overwrite an arbitrary number of attribute values.

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

Method Detail

setAttribute

@Nonnull
EChange setAttribute(@Nonnull
                               KEYTYPE aName,
                               @Nullable
                               VALUETYPE aValue)

Set/overwrite an attribute value.

Parameters:

aName - 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:

removeAttribute(Object)

setAttributes

@Nonnull
EChange setAttributes(@Nullable
                                Map<? extends KEYTYPE,? extends VALUETYPE> aValues)

Set/overwrite an arbitrary number of attribute values.

Parameters:

aValues - The map of attributes to be set. May be null.

Returns:

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

See Also:

setAttribute(Object,Object)

setAttributes

@Nonnull
EChange setAttributes(@Nullable
                                IAttributeContainer<? extends KEYTYPE,? extends VALUETYPE> aValues)

Set/overwrite an arbitrary number of attribute values.

Parameters:

aValues - The attributes to be set. May be null.

Returns:

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

See Also:

setAttribute(Object,Object)

removeAttribute

@Nonnull
EChange removeAttribute(@Nullable
                                  KEYTYPE aName)

Remove the specified attribute from the container.

Parameters:

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

Returns:

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

computeIfAbsent

@Nullable
default VALUETYPE computeIfAbsent(@Nonnull
                                             KEYTYPE aName,
                                             @Nonnull
                                             Function<? super KEYTYPE,? extends VALUETYPE> aValueProvider)

Compute an attribute value if it is not present.

Parameters:

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

aValueProvider - The value provider of the attribute. May not be null. Is only invoked, if the attribute is not present.

Returns:

Either the existing attribute value, or the newly calculated attribute value.

Since:

8.5.5