Package com.yworkflow.definition.model.attribute

Class HashMutableAttributes

java.lang.Object

com.yworkflow.definition.model.attribute.AbstractAttributes

com.yworkflow.definition.model.attribute.AbstractMutableAttributes

com.yworkflow.definition.model.attribute.HashMutableAttributes

All Implemented Interfaces:

Attributes, MutableAttributes

public class HashMutableAttributes
extends AbstractMutableAttributes

A mutable attributes implementation using a HashMap for storage. HashMutableAttributes provides a thread-safe, mutable collection of attributes with type safety and validation capabilities.

Since:

1.0

See Also:

• AbstractMutableAttributes
• AttributeType
• AttributeEntry

Constructor Summary

Constructors

Constructor	Description
HashMutableAttributes()	Creates a new empty HashMutableAttributes instance.
HashMutableAttributes(HashMutableAttributes hashMutableAttributes)	Creates a new HashMutableAttributes instance by copying from another instance.
HashMutableAttributes(Map<String,String> argValues)	Creates a new HashMutableAttributes instance with the specified string values.

Method Summary

Modifier and Type	Method	Description
void	addAll(Attributes attributes)	Adds all attributes from the specified Attributes instance to this instance.
void	addAll(Map<String,Object> map)	Adds all key-value pairs from the specified Map to this instance.
boolean	containsKey(String key)	Checks if an attribute with the specified key exists.
HashMutableAttributes	copy()	Creates a copy of this HashMutableAttributes instance.
<T> Optional<T>	get(AttributeType<T> type, String key)	Gets an attribute value with the specified type and key.
Optional<AttributeEntry<?>>	getEntry(String key)	Gets the complete attribute entry for a key.
Collection<String>	getKeys(String prefix, AttributeType<?> type)	Gets all attribute keys with the specified prefix and type.
protected Map<String,AttributeEntry<?>>	getMap()	Gets the underlying map containing the attribute entries.
Optional<AttributeType<?>>	getType(String key)	Gets the type of an attribute.
Object	propertyMissing(String name)	Handles property missing for getting a value.
void	propertyMissing(String name, String value)	Handles property missing for setting a value.
void	remove()	Removes all attributes from this instance.
void	remove(String key)	Removes the attribute with the specified key.
protected <T> void	setImpl(AttributeType<T> type, String key, T value)	Sets an attribute value with the specified type and key.
protected boolean	shouldCheckType()	Determines whether type checking should be performed.
Attributes	toImmutable()	Converts this MutableAttributes instance to an ImmutableAttributes instance.
Map<String,Object>	toMap()	Converts this HashMutableAttributes to a Map of String keys to Object values.

Methods inherited from class com.yworkflow.definition.model.attribute.AbstractMutableAttributes

setAttributes, setBoolean, setData, setDouble, setInstant, setInt, setLong, setObject, setRaw, setRaw, setString, toString, withAttributes, withBoolean, withData, withDouble, withInstant, withInt, withLong, withObject, withString

Methods inherited from class com.yworkflow.definition.model.attribute.AbstractAttributes

get, getBoolean, getData, getDouble, getInstant, getInt, getKeys, getKeys, getKeys, getLong, getObject, getString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.yworkflow.definition.model.attribute.Attributes

get, getBoolean, getData, getDouble, getInstant, getInt, getKeys, getKeys, getKeys, getLong, getObject, getString

Constructor Details

HashMutableAttributes

public HashMutableAttributes()

Creates a new empty HashMutableAttributes instance.

HashMutableAttributes

public HashMutableAttributes(Map<String,String> argValues)
                      throws AttributeException

Creates a new HashMutableAttributes instance with the specified string values.

Parameters:

argValues - a map of key-value pairs to initialize the attributes with

Throws:

AttributeException - if there is an error setting the attributes

HashMutableAttributes

public HashMutableAttributes(HashMutableAttributes hashMutableAttributes)

Creates a new HashMutableAttributes instance by copying from another instance.

Parameters:

hashMutableAttributes - the HashMutableAttributes instance to copy from

Method Details

getKeys

public Collection<String> getKeys(String prefix,
 AttributeType<?> type)

Description copied from interface: Attributes

Gets all attribute keys with the specified prefix and type.

Parameters:

prefix - the prefix to filter by

type - the attribute type to filter by

Returns:

a collection of keys that start with the prefix and are of the specified type

getType

public Optional<AttributeType<?>> getType(String key)

Description copied from interface: Attributes

Gets the type of an attribute.

Parameters:

key - the attribute key

Returns:

an Optional containing the attribute type if the key exists, empty otherwise

getEntry

public Optional<AttributeEntry<?>> getEntry(String key)
                                     throws AttributeException

Description copied from interface: Attributes

Gets the complete attribute entry for a key.

Parameters:

key - the attribute key

Returns:

an Optional containing the attribute entry if found, empty otherwise

Throws:

AttributeException - if there's an error accessing the attribute

containsKey

public boolean containsKey(String key)

Description copied from interface: Attributes

Checks if an attribute with the specified key exists.

Parameters:

key - the attribute key to check

Returns:

true if the key exists, false otherwise

remove

public void remove(String key)

Description copied from interface: MutableAttributes

Removes the attribute with the specified key.

Parameters:

key - the key of the attribute to remove

remove

public void remove()
            throws AttributeException

Description copied from interface: MutableAttributes

Removes all attributes from this instance.

Throws:

AttributeException - if there's an error removing the attributes

toMap

public Map<String,Object> toMap()

Converts this HashMutableAttributes to a Map of String keys to Object values. Only entries with non-null values are included in the result.

Returns:

a Map containing the key-value pairs with non-null values

copy

public HashMutableAttributes copy()

Creates a copy of this HashMutableAttributes instance.

Returns:

a new HashMutableAttributes instance with the same attributes

setImpl

protected <T> void setImpl(AttributeType<T> type,
 String key,
 T value)
                    throws AttributeException

Sets an attribute value with the specified type and key.

Specified by:

setImpl in class AbstractMutableAttributes

Type Parameters:

T - the type of the value

Parameters:

type - the attribute type

key - the attribute key

value - the attribute value

Throws:

AttributeException - if there is a type mismatch or other error

shouldCheckType

protected boolean shouldCheckType()

Determines whether type checking should be performed.

Returns:

true if type checking should be performed, false otherwise

getMap

protected Map<String,AttributeEntry<?>> getMap()

Gets the underlying map containing the attribute entries.

Returns:

the map of attribute entries

get

public <T> Optional<T> get(AttributeType<T> type,
 String key)
                    throws AttributeException

Gets an attribute value with the specified type and key.

Specified by:

get in class AbstractAttributes

Type Parameters:

T - the type of the value

Parameters:

type - the attribute type

key - the attribute key

Returns:

an Optional containing the value if found and compatible, empty otherwise

Throws:

AttributeException - if there is a type mismatch

addAll

public void addAll(Attributes attributes)
            throws AttributeException

Adds all attributes from the specified Attributes instance to this instance.

Parameters:

attributes - the Attributes instance to copy from

Throws:

AttributeException - if there is an error setting the attributes

addAll

public void addAll(Map<String,Object> map)
            throws AttributeException

Adds all key-value pairs from the specified Map to this instance.

Parameters:

map - the Map containing key-value pairs to add

Throws:

AttributeException - if there is an error setting the attributes

toImmutable

public Attributes toImmutable()

Description copied from interface: MutableAttributes

Converts this MutableAttributes instance to an ImmutableAttributes instance. This is useful for passing attributes to workflow operations that require immutable data.

Returns:

an ImmutableAttributes instance containing all attributes from this instance

propertyMissing

public void propertyMissing(String name,
 String value)
                     throws AttributeException

Handles property missing for setting a value.

Parameters:

name - the property name

value - the property value as a string

Throws:

AttributeException - if there is an error setting the property

propertyMissing

public Object propertyMissing(String name)
                       throws AttributeException

Handles property missing for getting a value.

Parameters:

name - the property name

Returns:

the property value as an Object

Throws:

AttributeException - if there is an error getting the property