com.helger.commons.collection.attr

Interface IAttributeContainer<KEYTYPE,VALUETYPE>

Type Parameters:

KEYTYPE - Key type

VALUETYPE - Value type

All Superinterfaces:

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

All Known Subinterfaces:

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

All Known Implementing Classes:

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

public interface IAttributeContainer<KEYTYPE,VALUETYPE>
extends ICommonsIterable<Map.Entry<KEYTYPE,VALUETYPE>>, Serializable

Base interface for a generic read-only attribute container. It maps keys to values.

Author:

Philip Helger

Method Summary

Modifier and Type	Method and Description
boolean	containsAttribute(KEYTYPE aName) Check if an attribute of the given name is contained.
void	forAllAttributes(BiConsumer<? super KEYTYPE,? super VALUETYPE> aConsumer) Perform an operation on all contained attributes.
void	forAllAttributeValues(Consumer<? super VALUETYPE> aConsumer) Perform an operation on all contained attribute values.
ICommonsSet<KEYTYPE>	getAllAttributeNames()
ICommonsMap<KEYTYPE,VALUETYPE>	getAllAttributes()
ICommonsCollection<VALUETYPE>	getAllAttributeValues()
default BigDecimal	getAttributeAsBigDecimal(KEYTYPE aName) Get the attribute value associated to the given attribute name.
default BigDecimal	getAttributeAsBigDecimal(KEYTYPE aName, BigDecimal aDefault) Get the attribute value associated to the given attribute name.
default BigInteger	getAttributeAsBigInteger(KEYTYPE aName) Get the attribute value associated to the given attribute name.
default BigInteger	getAttributeAsBigInteger(KEYTYPE aName, BigInteger aDefault) Get the attribute value associated to the given attribute name.
default boolean	getAttributeAsBoolean(KEYTYPE aName) Get the attribute value associated to the given attribute name.
default boolean	getAttributeAsBoolean(KEYTYPE aName, boolean bDefault) Get the attribute value associated to the given attribute name.
default double	getAttributeAsDouble(KEYTYPE aName) Get the attribute value associated to the given attribute name.
default double	getAttributeAsDouble(KEYTYPE aName, double dDefault) Get the attribute value associated to the given attribute name.
default int	getAttributeAsInt(KEYTYPE aName) Get the attribute value associated to the given attribute name.
default int	getAttributeAsInt(KEYTYPE aName, int nDefault) Get the attribute value associated to the given attribute name.
default long	getAttributeAsLong(KEYTYPE aName) Get the attribute value associated to the given attribute name.
default long	getAttributeAsLong(KEYTYPE aName, long nDefault) Get the attribute value associated to the given attribute name.
default String	getAttributeAsString(KEYTYPE aName) Get the attribute value associated to the given attribute name.
default String	getAttributeAsString(KEYTYPE aName, String sDefault) Get the attribute value associated to the given attribute name or the passed default value if no such attribute is present.
int	getAttributeCount()
VALUETYPE	getAttributeObject(KEYTYPE aName) Get the attribute value associated to the given attribute name.
default <DATATYPE> DATATYPE	getCastedAttribute(KEYTYPE aName) Get the attribute value associated to the given attribute name.
default <DATATYPE> DATATYPE	getCastedAttribute(KEYTYPE aName, DATATYPE aDefault) Get the attribute value associated to the given attribute name.
default <DATATYPE> DATATYPE	getTypedAttribute(KEYTYPE aName, Class<DATATYPE> aDstClass) Get the attribute value associated to the given attribute name.
default <DATATYPE> DATATYPE	getTypedAttribute(KEYTYPE aName, Class<DATATYPE> aDstClass, DATATYPE aDefault) Get the attribute value associated to the given attribute name.
boolean	isEmpty()
default boolean	isNotEmpty()
Iterator<Map.Entry<KEYTYPE,VALUETYPE>>	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

Method Detail

getAttributeCount

@Nonnegative
int getAttributeCount()

Returns:

The number of contained attributes. Always ≥ 0.

isEmpty

boolean isEmpty()

Returns:

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

isNotEmpty

default boolean isNotEmpty()

containsAttribute

boolean containsAttribute(@Nullable
                          KEYTYPE aName)

Check if an attribute of the given name is contained.

Parameters:

aName - name of the attribute to check

Returns:

true if the attribute is contained, false otherwise

getAllAttributes

@Nonnull
 @ReturnsMutableCopy
ICommonsMap<KEYTYPE,VALUETYPE> getAllAttributes()

Returns:

The non-null map with all contained attributes.

forAllAttributes

void forAllAttributes(@Nonnull
                      BiConsumer<? super KEYTYPE,? super VALUETYPE> aConsumer)

Perform an operation on all contained attributes. Use this method only for read-only operations, other you will most likely end up in a ConcurrentModificationException!

Parameters:

aConsumer - The consumer to be invoked.

forAllAttributeValues

void forAllAttributeValues(@Nonnull
                           Consumer<? super VALUETYPE> aConsumer)

Perform an operation on all contained attribute values. Use this method only for read-only operations, other you will most likely end up in a ConcurrentModificationException!

Parameters:

aConsumer - The consumer to be invoked.

getAttributeObject

@Nullable
VALUETYPE getAttributeObject(@Nullable
                                        KEYTYPE aName)

Get the attribute value associated to the given attribute name.

Parameters:

aName - the attribute name

Returns:

null if no such value exists

getCastedAttribute

@Nullable
default <DATATYPE> DATATYPE getCastedAttribute(@Nullable
                                                          KEYTYPE aName)

Get the attribute value associated to the given attribute name. If the type of the attribute in the scope does not match, a ClassCastException is thrown! If you just want to retrieve a String, use getAttributeAsString(Object)!
This call is identical to the call getCastedAttribute(aName, null)

Type Parameters:

DATATYPE - return type

Parameters:

aName - the attribute name

Returns:

null if no such value exists

getCastedAttribute

@Nullable
default <DATATYPE> DATATYPE getCastedAttribute(@Nullable
                                                          KEYTYPE aName,
                                                          @Nullable
                                                          DATATYPE aDefault)

Get the attribute value associated to the given attribute name. If the type of the attribute in the scope does not match, a ClassCastException is thrown! If you just want to retrieve a String, use getAttributeAsString(Object, String)!

Type Parameters:

DATATYPE - return type

Parameters:

aName - The attribute name.

aDefault - The default value to be returned if no such attribute exists

Returns:

The passed default value if no such attribute exists

getTypedAttribute

@Nullable
default <DATATYPE> DATATYPE getTypedAttribute(@Nullable
                                                         KEYTYPE aName,
                                                         @Nonnull
                                                         Class<DATATYPE> aDstClass)

Get the attribute value associated to the given attribute name. If the type of the attribute in the scope does not match, the TypeConverter is invoked! If you just want to retrieve a String, use getAttributeAsString(Object)!
This call is identical to the call getTypedAttribute(aName, null)

Type Parameters:

DATATYPE - return type

Parameters:

aName - the attribute name

aDstClass - The destination class to convert to. May not be null.

Returns:

null if no such value exists

getTypedAttribute

@Nullable
default <DATATYPE> DATATYPE getTypedAttribute(@Nullable
                                                         KEYTYPE aName,
                                                         @Nonnull
                                                         Class<DATATYPE> aDstClass,
                                                         @Nullable
                                                         DATATYPE aDefault)

Get the attribute value associated to the given attribute name. If the type of the attribute in the scope does not match, the TypeConverter is invoked! If you just want to retrieve a String, use getAttributeAsString(Object, String)!

Type Parameters:

DATATYPE - return type

Parameters:

aName - The attribute name.

aDstClass - The destination class to convert to. May not be null.

aDefault - The default value to be returned if no such attribute exists

Returns:

The passed default value if no such attribute exists

getAttributeAsString

@Nullable
default String getAttributeAsString(@Nullable
                                               KEYTYPE aName)

Get the attribute value associated to the given attribute name.
This is a shortcut for the following call: getAttributeAsString (aName, null)

Parameters:

aName - the attribute name

Returns:

The attribute value or null if no such attribute exists

getAttributeAsString

@Nullable
default String getAttributeAsString(@Nullable
                                               KEYTYPE aName,
                                               @Nullable
                                               String sDefault)

Get the attribute value associated to the given attribute name or the passed default value if no such attribute is present.

Parameters:

aName - the attribute name

sDefault - The default value to be returned, if the passed attribute name is unknown

Returns:

The attribute value or sDefault if no such attribute exists

getAttributeAsInt

default int getAttributeAsInt(@Nullable
                              KEYTYPE aName)

Get the attribute value associated to the given attribute name.

Parameters:

aName - the attribute name

Returns:

The attribute value or CGlobal.ILLEGAL_UINT if no such attribute exists

getAttributeAsInt

default int getAttributeAsInt(@Nullable
                              KEYTYPE aName,
                              int nDefault)

Get the attribute value associated to the given attribute name.

Parameters:

aName - the attribute name

nDefault - the default value to be returned if the value is not present or not convertible

Returns:

The attribute value or nDefault if no such attribute exists

getAttributeAsLong

default long getAttributeAsLong(@Nullable
                                KEYTYPE aName)

Get the attribute value associated to the given attribute name.

Parameters:

aName - the attribute name

Returns:

The attribute value or CGlobal.ILLEGAL_ULONG if no such attribute exists

getAttributeAsLong

default long getAttributeAsLong(@Nullable
                                KEYTYPE aName,
                                long nDefault)

Get the attribute value associated to the given attribute name.

Parameters:

aName - the attribute name

nDefault - the default value to be returned if the value is not present or not convertible

Returns:

The attribute value or nDefault if no such attribute exists

getAttributeAsDouble

default double getAttributeAsDouble(@Nullable
                                    KEYTYPE aName)

Get the attribute value associated to the given attribute name.

Parameters:

aName - the attribute name

Returns:

The attribute value or CGlobal.ILLEGAL_UINT if no such attribute exists

getAttributeAsDouble

default double getAttributeAsDouble(@Nullable
                                    KEYTYPE aName,
                                    double dDefault)

Get the attribute value associated to the given attribute name.

Parameters:

aName - the attribute name

dDefault - the default value to be returned if the value is not present or not convertible

Returns:

The attribute value or nDefault if no such attribute exists

getAttributeAsBoolean

default boolean getAttributeAsBoolean(@Nullable
                                      KEYTYPE aName)

Get the attribute value associated to the given attribute name.

Parameters:

aName - the attribute name

Returns:

The attribute value or false if no such attribute exists

getAttributeAsBoolean

default boolean getAttributeAsBoolean(@Nullable
                                      KEYTYPE aName,
                                      boolean bDefault)

Get the attribute value associated to the given attribute name.

Parameters:

aName - the attribute name

bDefault - the default value to be returned if the value is not present or not convertible

Returns:

The attribute value or bDefault if no such attribute exists

getAttributeAsBigInteger

@Nullable
default BigInteger getAttributeAsBigInteger(@Nullable
                                                       KEYTYPE aName)

Get the attribute value associated to the given attribute name.

Parameters:

aName - the attribute name

Returns:

The attribute value or null if no such attribute exists

getAttributeAsBigInteger

@Nullable
default BigInteger getAttributeAsBigInteger(@Nullable
                                                       KEYTYPE aName,
                                                       @Nullable
                                                       BigInteger aDefault)

Get the attribute value associated to the given attribute name.

Parameters:

aName - the attribute name

aDefault - the default value to be returned if the value is not present or not convertible

Returns:

The attribute value or aDefault if no such attribute exists

getAttributeAsBigDecimal

@Nullable
default BigDecimal getAttributeAsBigDecimal(@Nullable
                                                       KEYTYPE aName)

Get the attribute value associated to the given attribute name.

Parameters:

aName - the attribute name

Returns:

The attribute value or null if no such attribute exists

getAttributeAsBigDecimal

@Nullable
default BigDecimal getAttributeAsBigDecimal(@Nullable
                                                       KEYTYPE aName,
                                                       @Nullable
                                                       BigDecimal aDefault)

Get the attribute value associated to the given attribute name.

Parameters:

aName - the attribute name

aDefault - the default value to be returned if the value is not present or not convertible

Returns:

The attribute value or aDefault if no such attribute exists

getAllAttributeNames

@Nonnull
 @ReturnsMutableCopy
ICommonsSet<KEYTYPE> getAllAttributeNames()

Returns:

A non-null set of all attribute names.

getAllAttributeValues

@Nonnull
 @ReturnsMutableCopy
ICommonsCollection<VALUETYPE> getAllAttributeValues()

Returns:

A non-null collection of all attribute values.

iterator

@Nonnull
Iterator<Map.Entry<KEYTYPE,VALUETYPE>> iterator()

Specified by:

iterator in interface Iterable<Map.Entry<KEYTYPE,VALUETYPE>>

Returns:

An iterator over all entries.