org.cip4.jdflib.datatypes

Class JDFAttributeMapArray

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.ArrayList<JDFAttributeMap>

org.cip4.jdflib.datatypes.JDFAttributeMapArray

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Iterable<JDFAttributeMap>, java.util.Collection<JDFAttributeMap>, java.util.List<JDFAttributeMap>, java.util.RandomAccess

public class JDFAttributeMapArray
extends java.util.ArrayList<JDFAttributeMap>

Description: This class represents a vector of JDFAttributeMaps

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
JDFAttributeMapArray() constructor
JDFAttributeMapArray(java.util.Collection<JDFAttributeMap> toAdd) copy constructor, the map elements are cloned
JDFAttributeMapArray(JDFAttributeMap moreMap)
JDFAttributeMapArray(JDFAttributeMap[] toAdd) constructor from array, the map elements are not cloned

Method Summary

Modifier and Type	Method and Description
void	appendUnique(JDFAttributeMap map)
void	appendUnique(JDFAttributeMapArray maps) Method appendUnique.
JDFAttributeMapArray	clone()
boolean	containsKey(java.lang.String key)
boolean	equals(java.lang.Object other) equals - Compares two map vectors, returns true if content equal regardless of element order, otherwise false. If input is not of type VJDFAttributeMap, result of superclasses equals method is returned.
JDFAttributeMap	get(int i) Returns the element at the given position (may be<0 to count backwards)
JDFAttributeMapArray	getAndMaps(JDFAttributeMap map) andMap - builds a new vector of maps with identical pairs of both maps does not modify this
static JDFAttributeMapArray	getArray(JDFAttributeMap partMap)
JDFAttributeMap	getCommonMap() return the map that is common to all elements of this.
StringArray	getKeys() return list of all keys
JDFAttributeMapArray	getMatchingMaps(java.lang.String key, java.lang.String regExp, boolean ignoreCase) Method overlapMap.
static JDFAttributeMapArray	getNonEmpty(JDFAttributeMapArray v)
JDFAttributeMapArray	getOrMaps(JDFAttributeMap map) andMap - builds a new vector of maps with identical pairs of both maps does not modify this
JDFAttributeMapArray	getOrMaps(JDFAttributeMapArray vMap) andMap - builds a new vector of maps with identical pairs of both maps does not modify this
JDFAttributeMapArray	getOverlapMaps(JDFAttributeMap map) Method overlapMap.
java.util.List<java.lang.String>	getPartValues(java.lang.String strKey, boolean bUnique)
int	hashCode() hashCode complements equals() to fulfill the equals/hashCode contract
static boolean	isEmpty(java.util.Collection<JDFAttributeMap> v) are we null or empty or contain only an empty JDFAttributeMap
int	maxSize() Return the maximum size size of a JDFAttributeMap in this
int	minSize() Return the minimum size size of a JDFAttributeMap in this
JDFAttributeMapArray	overlapMap(JDFAttributeMap map) Method overlapMap.
JDFAttributeMapArray	overlapMap(JDFAttributeMapArray vMap) Method overlapMap.
boolean	overlapsMap(JDFAttributeMap map) Method overlapMap.
boolean	overlapsMap(JDFAttributeMapArray vMap) Method overlapsMap.
void	put(JDFAttributeMap commonMap) put the value of all keys into every existing map
void	put(java.lang.Object key, java.lang.Object value) put the key value pair into all entries
void	put(java.lang.String key, java.lang.String value) put the key value pair into all entries; if no entries are there, create exactly one entry with the given key value pair
void	reduceMap(java.util.Collection<java.lang.String> keySet) reduce each JDFAttributeMap in this by keySet (only entries in keyset are retained)
JDFAttributeMapArray	removeKey(java.lang.String key) remove the key specified and then erase any duplicates and emptys
JDFAttributeMapArray	removeKeys(java.util.Collection<java.lang.String> set) remove the keys specified in set and then erase any duplicates and emptys
void	removeMaps(JDFAttributeMap map) remove all matching maps from this i.e.
java.lang.String	showKeys(java.lang.String sepMap, java.lang.String sepEntry)
boolean	subMap(JDFAttributeMap map) Method subMap.
boolean	subMap(JDFAttributeMapArray vMap) Method subMap.
java.lang.String	toString() toString
void	unify() unify - make VElement unique, retaining initial order

Methods inherited from class java.util.ArrayList

add, add, addAll, addAll, clear, contains, ensureCapacity, forEach, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeIf, removeRange, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray, trimToSize

Methods inherited from class java.util.AbstractCollection

containsAll

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.List

containsAll

Methods inherited from interface java.util.Collection

parallelStream, stream

Constructor Detail

JDFAttributeMapArray

public JDFAttributeMapArray()

constructor

JDFAttributeMapArray

public JDFAttributeMapArray(java.util.Collection<JDFAttributeMap> toAdd)

copy constructor, the map elements are cloned

Parameters:

toAdd - Vector of elements to clone

JDFAttributeMapArray

public JDFAttributeMapArray(JDFAttributeMap[] toAdd)

constructor from array, the map elements are not cloned

Parameters:

toAdd - the array

JDFAttributeMapArray

public JDFAttributeMapArray(JDFAttributeMap moreMap)

Parameters:

moreMap - the single attribute map to add

Method Detail

toString

public java.lang.String toString()

toString

Overrides:

toString in class java.util.AbstractCollection<JDFAttributeMap>

Returns:

String

getNonEmpty

public static JDFAttributeMapArray getNonEmpty(JDFAttributeMapArray v)

Parameters:

v -

Returns:

getArray

public static JDFAttributeMapArray getArray(JDFAttributeMap partMap)

Parameters:

partMap -

Returns:

isEmpty

public static boolean isEmpty(java.util.Collection<JDFAttributeMap> v)

are we null or empty or contain only an empty JDFAttributeMap

Parameters:

v -

Returns:

showKeys

public java.lang.String showKeys(java.lang.String sepMap,
                                 java.lang.String sepEntry)

Parameters:

sepMap - the separator between maps

sepEntry - the separator between map entries

Returns:

the string representation

getPartValues

public java.util.List<java.lang.String> getPartValues(java.lang.String strKey,
                                                      boolean bUnique)

Parameters:

strKey - the attribute to get values from

bUnique - if true, ensure unique vector, else the vector corresponds to the vector of values

Returns:

the Vector of all values

getAndMaps

public JDFAttributeMapArray getAndMaps(JDFAttributeMap map)

andMap - builds a new vector of maps with identical pairs of both maps does not modify this

Parameters:

map - the given map

Returns:

the anded map, null if mismatches occurred

getOrMaps

public JDFAttributeMapArray getOrMaps(JDFAttributeMap map)

andMap - builds a new vector of maps with identical pairs of both maps does not modify this

Parameters:

map - the given map

Returns:

the anded map, null if mismatches occurred

getOrMaps

public JDFAttributeMapArray getOrMaps(JDFAttributeMapArray vMap)

andMap - builds a new vector of maps with identical pairs of both maps does not modify this

Parameters:

map - the given map

Returns:

the anded map, null if mismatches occurred

containsKey

public boolean containsKey(java.lang.String key)

Parameters:

key - the key to check for

Returns:

true if any of the maps contains key

See Also:

Map.containsKey(java.lang.Object)

maxSize

public int maxSize()

Return the maximum size size of a JDFAttributeMap in this

Returns:

int - the size

minSize

public int minSize()

Return the minimum size size of a JDFAttributeMap in this

Returns:

int - the size

get

public JDFAttributeMap get(int i)

Returns the element at the given position (may be<0 to count backwards)

Specified by:

get in interface java.util.List<JDFAttributeMap>

Overrides:

get in class java.util.ArrayList<JDFAttributeMap>

Parameters:

i - the given position

Returns:

JDFAttributeMap - the selected element

removeKeys

public JDFAttributeMapArray removeKeys(java.util.Collection<java.lang.String> set)

remove the keys specified in set and then erase any duplicates and emptys

Parameters:

set -

removeKey

public JDFAttributeMapArray removeKey(java.lang.String key)

remove the key specified and then erase any duplicates and emptys

Parameters:

key -

reduceMap

public void reduceMap(java.util.Collection<java.lang.String> keySet)

reduce each JDFAttributeMap in this by keySet (only entries in keyset are retained)

Parameters:

keySet -

getKeys

public StringArray getKeys()

return list of all keys

Returns:

the vector of all keys

getCommonMap

public JDFAttributeMap getCommonMap()

return the map that is common to all elements of this. All keys exist and have the same value

Returns:

the vector of all keys

unify

public void unify()

unify - make VElement unique, retaining initial order

appendUnique

public void appendUnique(JDFAttributeMap map)

Parameters:

map - map to append

appendUnique

public void appendUnique(JDFAttributeMapArray maps)

Method appendUnique.

Parameters:

maps - maps to append

overlapMap

public JDFAttributeMapArray overlapMap(JDFAttributeMap map)

Method overlapMap. removes all non-overlapping maps from this

Parameters:

map - the map to check against

Returns:

getOverlapMaps

public JDFAttributeMapArray getOverlapMaps(JDFAttributeMap map)

Method overlapMap. get a copy of this with all overlapping maps the maps are NOT cloned

Parameters:

map - the map to check against

Returns:

a new VJDFAttributemap with the overlapping entries of this - never null

getMatchingMaps

public JDFAttributeMapArray getMatchingMaps(java.lang.String key,
                                            java.lang.String regExp,
                                            boolean ignoreCase)

Method overlapMap. get a copy of this with all matching maps the maps are NOT cloned

Parameters:

key - the key to match

regExp - the simplified regexp

ignoreCase - duh...

Returns:

a new VJDFAttributemap with the matching entries of this - never null (may be safely daisy-chained)

overlapMap

public JDFAttributeMapArray overlapMap(JDFAttributeMapArray vMap)

Method overlapMap. only entries that contain at least one matching map entry are retained

Parameters:

vMap - the map to check against

overlapsMap

public boolean overlapsMap(JDFAttributeMap map)

Method overlapMap.

Parameters:

map - the map to check against

Returns:

subMap

public boolean subMap(JDFAttributeMap map)

Method subMap.

Parameters:

map - the submap to check against

Returns:

true if this has at least one entry that subMap is a submap of

subMap

public boolean subMap(JDFAttributeMapArray vMap)

Method subMap.

Parameters:

vMap - the vector submaps to check against

Returns:

true if this has at least one entry that vMap contains at least a submap of

overlapsMap

public boolean overlapsMap(JDFAttributeMapArray vMap)

Method overlapsMap. returns true if at least one element exists that has no non-matching key value pairs

Parameters:

vMap - the vector to check against

Returns:

true if this has at least one entry that vMap contains at least a submap of

equals

public boolean equals(java.lang.Object other)

equals - Compares two map vectors, returns true if content equal regardless of element order, otherwise false.
If input is not of type VJDFAttributeMap, result of superclasses equals method is returned.

Specified by:

equals in interface java.util.Collection<JDFAttributeMap>

Specified by:

equals in interface java.util.List<JDFAttributeMap>

Overrides:

equals in class java.util.AbstractList<JDFAttributeMap>

Parameters:

other - in this case VJDFAttributeMap to compare

Returns:

boolean - true if the maps are equal, otherwise false

put

public void put(java.lang.Object key,
                java.lang.Object value)

put the key value pair into all entries

Parameters:

key - the key to set - may be either String or Enum

value - the value to set - may be either String or Enum

Throws:

java.lang.IllegalArgumentException - if key or value have the wrong type

hashCode

public int hashCode()

hashCode complements equals() to fulfill the equals/hashCode contract

Specified by:

hashCode in interface java.util.Collection<JDFAttributeMap>

Specified by:

hashCode in interface java.util.List<JDFAttributeMap>

Overrides:

hashCode in class java.util.AbstractList<JDFAttributeMap>

Returns:

int

put

public void put(java.lang.String key,
                java.lang.String value)

put the key value pair into all entries; if no entries are there, create exactly one entry with the given key value pair

Parameters:

key - the key to set

value - the value to set

clone

public JDFAttributeMapArray clone()

Overrides:

clone in class java.util.ArrayList<JDFAttributeMap>

Returns:

See Also:

also clones the underlying maps

removeMaps

public void removeMaps(JDFAttributeMap map)

remove all matching maps from this i.e. if map is subMap of this

Parameters:

map -

put

public void put(JDFAttributeMap commonMap)

put the value of all keys into every existing map

Parameters:

commonMap -