Class MapPathTable<T>

java.lang.Object

org.refcodes.struct.MapPathTable<T>

Type Parameters:

T - The type of the value elements.

All Implemented Interfaces:

Serializable, Map<String,T>, org.refcodes.mixin.AnnotatorAccessor, org.refcodes.mixin.Clearable, org.refcodes.mixin.DelimiterAccessor, org.refcodes.mixin.EmptyAccessor, org.refcodes.mixin.TypeAccessor<T>, Containable, ImmutablePathTable<T>, ImmutablePathTable.MutablePathTable<T>, ImmutableTable<String,T>, ImmutableTable.MutableTable<String,T>, Keys<String,T>, Keys.MutableKeys<String,T>, Keys.MutableValues<String,T>, PathTable<T>, Table<String,T,PathTable<T>>

Direct Known Subclasses:

MapCanonicalTable, MapClassStructTable, MapSimpleTypeTable

public class MapPathTable<T>
extends Object
implements PathTable<T>, Serializable

The MapPathTable class implements the PathTable using a backing Map instance.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface org.refcodes.mixin.AnnotatorAccessor

org.refcodes.mixin.AnnotatorAccessor.AnnotatorBuilder<B extends org.refcodes.mixin.AnnotatorAccessor.AnnotatorBuilder<B>>, org.refcodes.mixin.AnnotatorAccessor.AnnotatorMutator, org.refcodes.mixin.AnnotatorAccessor.AnnotatorProperty

Nested classes/interfaces inherited from interface org.refcodes.mixin.DelimiterAccessor

org.refcodes.mixin.DelimiterAccessor.DelimiterBuilder<B extends org.refcodes.mixin.DelimiterAccessor.DelimiterBuilder<B>>, org.refcodes.mixin.DelimiterAccessor.DelimiterMutator, org.refcodes.mixin.DelimiterAccessor.DelimiterProperty

Nested classes/interfaces inherited from interface org.refcodes.mixin.EmptyAccessor

org.refcodes.mixin.EmptyAccessor.EmptyBuilder<B extends org.refcodes.mixin.EmptyAccessor.EmptyBuilder<B>>, org.refcodes.mixin.EmptyAccessor.EmptyMutator, org.refcodes.mixin.EmptyAccessor.EmptyProperty

Nested classes/interfaces inherited from interface org.refcodes.struct.ImmutablePathTable

ImmutablePathTable.MutablePathTable<T>

Nested classes/interfaces inherited from interface org.refcodes.struct.ImmutableTable

ImmutableTable.MutableTable<K,V>

Nested classes/interfaces inherited from interface org.refcodes.struct.Keys

Keys.MutableKeys<K,V>, Keys.MutableValues<K,V>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Nested classes/interfaces inherited from interface org.refcodes.mixin.TypeAccessor

org.refcodes.mixin.TypeAccessor.TypeBuilder<T,B extends org.refcodes.mixin.TypeAccessor.TypeBuilder<T,B>>, org.refcodes.mixin.TypeAccessor.TypeMutator<T>, org.refcodes.mixin.TypeAccessor.TypeProperty<T>

Field Summary

Fields

Modifier and Type	Field	Description
protected final Map<String,T>	_backingMap

Fields inherited from interface org.refcodes.struct.ImmutablePathTable

ANNOTATOR, DELIMITER

Constructor Summary

Constructors

Constructor	Description
MapPathTable(char aDelimiter, Class<T> aType)	Create a PathTable instance using the provided path delimiter for the path declarations.
MapPathTable(char aDelimiter, Class<T> aType, Map<String,T> aBackingMap)	Create a PathTable instance using the provided path delimiter for the path declarations.
MapPathTable(Class<T> aType)	Create an empty PathTable instance using the default path delimiter "/" (Delimiter.PATH) for the path declarations.
MapPathTable(Class<T> aType, Map<String,T> aBackingMap)	Create an empty PathTable instance using the default path delimiter "/" (Delimiter.PATH) for the path declarations.
MapPathTable(Object aObj, char aDelimiter, Class<T> aType)	Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).
MapPathTable(Object aObj, char aDelimiter, Class<T> aType, Map<String,T> aBackingMap)	Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).
MapPathTable(Object aObj, Class<T> aType)	Create a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH) for the path declarations.
MapPathTable(Object aObj, Class<T> aType, Map<String,T> aBackingMap)	Create a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH) for the path declarations.
MapPathTable(Object aObj, String aFromPath, char aDelimiter, Class<T> aType)	Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).
MapPathTable(Object aObj, String aFromPath, char aDelimiter, Class<T> aType, Map<String,T> aBackingMap)	Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).
MapPathTable(Object aObj, String aFromPath, Class<T> aType)	Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH) for the path declarations.
MapPathTable(Object aObj, String aFromPath, Class<T> aType, Map<String,T> aBackingMap)	Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH) for the path declarations.
MapPathTable(String aToPath, Object aObj, char aDelimiter, Class<T> aType)	Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).
MapPathTable(String aToPath, Object aObj, char aDelimiter, Class<T> aType, Map<String,T> aBackingMap)	Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).
MapPathTable(String aToPath, Object aObj, Class<T> aType)	Create a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH) for the path declarations.
MapPathTable(String aToPath, Object aObj, Class<T> aType, Map<String,T> aBackingMap)	Create a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH) for the path declarations.
MapPathTable(String aToPath, Object aObj, String aFromPath, char aDelimiter, Class<T> aType)	Create a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).
MapPathTable(String aToPath, Object aObj, String aFromPath, char aDelimiter, Class<T> aType, Map<String,T> aBackingMap)	Create a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).
MapPathTable(String aToPath, Object aObj, String aFromPath, Class<T> aType)	Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH for the path declarations.
MapPathTable(String aToPath, Object aObj, String aFromPath, Class<T> aType, Map<String,T> aBackingMap)	Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH for the path declarations.

Method Summary

Modifier and Type	Method	Description
void	clear()
T	compute(String aPath, BiFunction<? super String,? super T,? extends T> remappingFunction)
T	computeIfAbsent(String aPath, Function<? super String,? extends T> mappingFunction)
T	computeIfPresent(String aPath, BiFunction<? super String,? super T,? extends T> remappingFunction)
boolean	containsKey(Object aPath)	Tests whether there is an element with the given key.
boolean	containsValue(Object value)	This method is defined for the sake of Map conformity.
protected Map<String,T>	createBackingMap()	Hook for creating an individual backing Map to be used by the UnmodifiablePathTableDecorator type (defaults to LinkedHashMap).
Set<Map.Entry<String,T>>	entrySet()
boolean	equals(Object obj)
void	forEach(BiConsumer<? super String,? super T> action)
protected T	fromInstance(Object aValue)	Hook method when introspecting an object to help conversion of that object to the target types.
protected ImmutablePathTable<T>	fromObject(Object aFrom)	Hook method when internally creating ImmutablePathTable sub-types in the according ImmutablePathTable sub-type implementations.
protected void	fromValue(String aToPath, Object aObj)	Hook method for intercepting or modifying the process of object introspection.
protected void	fromValue(String aToPath, Object aValue, Set<Object> aVisited)	Inserts the given Object (depending of its type) below the given path while tracking visited elements in case of introspection.
T	get(Object aPath)	Retrieves the element assigned to the given key.
char	getAnnotator()
char	getDelimiter()
T	getOrDefault(Object aPath, T publicValue)
Class<T>	getType()
int	hashCode()
void	insert(Object aFrom)	Inspects the given object and adds all elements found in the given object.
void	insertBetween(String aToPath, Object aFrom, String aFromPath)	Same as ImmutablePathTable.MutablePathTable.insert(Object) though starting insertion of object's introspected values at the given "to-path" and starting object introspection at the given "from-path", e.g. ignoring all paths not starting with the given path during the introspection process.
void	insertFrom(Object aFrom, String aFromPath)	Same as ImmutablePathTable.MutablePathTable.insert(Object) though starting object introspection at the given "path", e.g. ignoring all paths not starting with the given path during the introspection process.
void	insertTo(String aToPath, Object aFrom)	Same as ImmutablePathTable.MutablePathTable.insert(Object) though starting insertion of object's introspected values at the given "path".
boolean	isEmpty()
Set<String>	keySet()	Retrieves a collection containing all the keys found in the elements of this collection.
void	merge(Object aFrom)	Inspects the given object and adds all elements found in the given object in case the targeted path does not exist or points to a null value.
T	merge(String aPath, T value, BiFunction<? super T,? super T,? extends T> remappingFunction)
void	mergeBetween(String aToPath, Object aFrom, String aFromPath)	Same as ImmutablePathTable.MutablePathTable.merge(Object) though starting merging of object's introspected values at the given "to-path" and starting object introspection at the given "from-path", e.g. ignoring all paths not starting with the given path during the introspection process.
void	mergeFrom(Object aFrom, String aFromPath)	Same as ImmutablePathTable.MutablePathTable.merge(Object) though starting object introspection at the given "path", e.g. ignoring all paths not starting with the given path during the introspection process.
void	mergeTo(String aToPath, Object aFrom)	Same as ImmutablePathTable.MutablePathTable.merge(Object) though starting merging of object's introspected values at the given "path".
T	put(String aPath, T aValue)	Puts an element identified by the given key.
void	putAll(Map<? extends String,? extends T> m)
T	putIfAbsent(String aPath, T value)
T	remove(Object aPath)
boolean	remove(Object aPath, Object value)
T	replace(String aPath, T value)
boolean	replace(String aPath, T oldValue, T newValue)
void	replaceAll(BiFunction<? super String,? super T,? extends T> function)
PathTable<T>	retrieveFrom(String aFromPath)	Extracts a new PathTable from the elements of this instance found below the "from-path".
PathTable<T>	retrieveTo(String aToPath)	Extracts a new PathTable from this instance's elements with the paths relocated to the provided "to-path".
int	size()	Returns the number of data elements contained in the collection.
Object	toDataStructure(String aFromPath)	Similar to the ImmutablePathTable.toMap(String) method, though in case all the keys of a nested Map instance (applicable to the root Map as well) represent an array (as of ImmutablePathTable.getArray(String)), then an array is generated where the index of each value in the Map is represented by the number representation of the Map's key for that value.
protected <TYPE> TYPE	toInstance(T aValue, Class<TYPE> aType)	Hook method when reconstructing an object, opposite of fromInstance(Object), tries to convert the given value to the desired type.
String	toString()
<TYPE> TYPE	toType(String aFromPath, Class<TYPE> aType)	Creates an instance of the given type filled with this instance's data.
Collection<T>	values()	Returns a Collection view of the values related to the contained keys.
PathTable<T>	withPut(String aKey, T aValue)	Builder method for Keys.MutableValues.put(Object, Object).

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.refcodes.struct.ImmutablePathTable

children, children, children, children, children, children, containsKey, containsKey, containsKey, dirs, dirs, dirs, dirs, dirs, dirs, findPaths, fromExternalPath, get, get, get, getArray, getArray, getArray, getArray, getArray, getArray, getArrayIndexes, getArrayIndexes, getArrayIndexes, getArrayIndexes, getArrayIndexes, getArrayOr, getArrayOr, getArrayOr, getArrayOr, getArrayOr, getArrayOr, getDir, getDir, getDir, getDir, getDir, getDirAt, getDirAt, getDirAt, getDirAt, getDirAt, getDirAt, getDirIndexes, getDirIndexes, getDirIndexes, getDirIndexes, getDirIndexes, getDirIndexes, getDirs, getDirs, getDirs, getDirs, getDirs, getRootPath, getValueAt, getValueAt, getValueAt, getValueAt, getValueAt, getValueAt, hasChildren, hasChildren, hasChildren, hasChildren, hasChildren, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasParentPath, hasPath, hasPath, hasPath, hasPath, hasPath, hasSubDirs, hasSubDirs, hasSubDirs, hasSubDirs, hasValue, hasValue, hasValue, hasValue, hasValue, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, isArray, isArray, isArray, isArray, isArray, isArray, isChild, isChild, isChild, isChild, isDir, isDir, isDir, isDir, isDir, isEqualTo, isIndexDir, isIndexDir, isIndexDir, isIndexDir, isIndexDir, isLeaf, isLeaf, isLeaf, isLeaf, isLeaf, isRootPath, keySet, keySet, keySet, keySet, keySet, lastArrayIndex, lastArrayIndex, lastArrayIndex, lastArrayIndex, lastArrayIndex, lastArrayIndex, lastDirIndex, lastDirIndex, lastDirIndex, lastDirIndex, lastDirIndex, lastDirIndex, leaves, leaves, leaves, leaves, leaves, leaves, nextArrayIndex, nextArrayIndex, nextArrayIndex, nextArrayIndex, nextArrayIndex, nextArrayIndex, nextDirIndex, nextDirIndex, nextDirIndex, nextDirIndex, nextDirIndex, nextDirIndex, paths, paths, paths, paths, paths, paths, query, query, query, query, query, queryBetween, queryBetween, queryBetween, queryBetween, queryBetween, queryBetween, queryFrom, queryFrom, queryFrom, queryFrom, queryFrom, queryFrom, queryPaths, queryPaths, queryPaths, queryPaths, queryPaths, queryPaths, queryTo, queryTo, queryTo, queryTo, queryTo, queryTo, retrieveBetween, retrieveBetween, retrieveBetween, retrieveBetween, retrieveBetween, retrieveFrom, retrieveFrom, retrieveFrom, retrieveFrom, retrieveTo, retrieveTo, retrieveTo, retrieveTo, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, toDataStructure, toExternalPath, toInstance, toInstance, toLeaf, toMap, toMap, toNormalizedPath, toParentPath, toPath, toPath, toPath, toPath, toPathElements, toPathList, toPathStack, toPrintable, toPropertyPath, toType, toType, toType, toType, toType, toType, toType

Methods inherited from interface org.refcodes.struct.ImmutablePathTable.MutablePathTable

add, add, add, add, add, add, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendValueTo, appendValueTo, appendValueTo, appendValueTo, appendValueTo, appendValueTo, delete, delete, delete, delete, delete, fromType, fromType, fromType, fromType, fromType, fromType, fromType, fromType, insert, insertBetween, insertBetween, insertBetween, insertBetween, insertBetween, insertBetween, insertBetween, insertBetween, insertBetween, insertFrom, insertFrom, insertFrom, insertFrom, insertFrom, insertFrom, insertFrom, insertFrom, insertFrom, insertTo, insertTo, insertTo, insertTo, insertTo, insertTo, insertTo, insertTo, insertTo, merge, mergeBetween, mergeBetween, mergeBetween, mergeBetween, mergeBetween, mergeBetween, mergeBetween, mergeBetween, mergeBetween, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeTo, mergeTo, mergeTo, mergeTo, mergeTo, mergeTo, mergeTo, mergeTo, mergeTo, put, put, put, put, putArray, putArray, putArray, putArray, putArray, putArray, putArray, putArray, putArray, putArray, putArray, putArray, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, putValueAt, putValueAt, putValueAt, putValueAt, putValueAt, putValueAt, remove, remove, remove, removeAll, removeAll, removeAll, removeAll, removeAll, removeAll, removeDirAt, removeDirAt, removeDirAt, removeDirAt, removeDirAt, removeFrom, removeFrom, removeFrom, removeFrom, removeFrom, removePaths, removePaths, removeValueAt, removeValueAt, removeValueAt, removeValueAt, removeValueAt, toSourceCode, toSourceCode

Methods inherited from interface org.refcodes.struct.Keys

getOr, use

Methods inherited from interface org.refcodes.struct.PathTable

withInsert, withInsert, withInsertBetween, withInsertBetween, withInsertBetween, withInsertBetween, withInsertBetween, withInsertBetween, withInsertBetween, withInsertBetween, withInsertBetween, withInsertBetween, withInsertFrom, withInsertFrom, withInsertFrom, withInsertFrom, withInsertFrom, withInsertFrom, withInsertFrom, withInsertFrom, withInsertFrom, withInsertFrom, withInsertTo, withInsertTo, withInsertTo, withInsertTo, withInsertTo, withInsertTo, withInsertTo, withInsertTo, withInsertTo, withInsertTo, withMerge, withMerge, withMergeBetween, withMergeBetween, withMergeBetween, withMergeBetween, withMergeBetween, withMergeBetween, withMergeBetween, withMergeBetween, withMergeBetween, withMergeBetween, withMergeFrom, withMergeFrom, withMergeFrom, withMergeFrom, withMergeFrom, withMergeFrom, withMergeFrom, withMergeFrom, withMergeFrom, withMergeFrom, withMergeTo, withMergeTo, withMergeTo, withMergeTo, withMergeTo, withMergeTo, withMergeTo, withMergeTo, withMergeTo, withMergeTo, withPut, withPut, withPut, withPut, withPutDirAt, withPutDirAt, withPutDirAt, withPutDirAt, withPutDirAt, withPutDirAt, withPutDirAt, withPutDirAt, withPutDirAt, withPutDirAt, withPutDirAt, withPutDirAt, withRemoveFrom, withRemoveFrom, withRemoveFrom, withRemoveFrom, withRemoveFrom, withRemovePaths

Field Details

_backingMap

protected final Map<String,T> _backingMap

Constructor Details

MapPathTable

public MapPathTable(char aDelimiter,
 Class<T> aType)

Create a PathTable instance using the provided path delimiter for the path declarations.

Parameters:

aDelimiter - The path delimiter to be used for the path declarations.

aType - The type of the values being referenced by the paths.

MapPathTable

public MapPathTable(Class<T> aType)

Create an empty PathTable instance using the default path delimiter "/" (Delimiter.PATH) for the path declarations.

Parameters:

aType - The type of the values being referenced by the paths.

MapPathTable

public MapPathTable(Object aObj,
 Class<T> aType)

Create a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH) for the path declarations.

Parameters:

aObj - The object from which the elements are to be added.

aType - The type of the values being referenced by the paths.

MapPathTable

public MapPathTable(String aToPath,
 Object aObj,
 Class<T> aType)

Create a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH) for the path declarations.

Parameters:

aToPath - The sub-path where to insert the object's introspected values to.

aObj - The object from which the elements are to be added.

aType - The type of the values being referenced by the paths.

MapPathTable

public MapPathTable(Object aObj,
 String aFromPath,
 Class<T> aType)

Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH) for the path declarations.

Parameters:

aObj - The object from which the elements are to be added.

aFromPath - The path from where to start adding elements of the provided object.

aType - The type of the values being referenced by the paths.

MapPathTable

public MapPathTable(String aToPath,
 Object aObj,
 String aFromPath,
 Class<T> aType)

Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH for the path declarations.

Parameters:

aToPath - The sub-path where to insert the object's introspected values to.

aObj - The object from which the elements are to be added.

aFromPath - The path from where to start adding elements of the provided object.

aType - The type of the values being referenced by the paths.

MapPathTable

public MapPathTable(Object aObj,
 char aDelimiter,
 Class<T> aType)

Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).

Parameters:

aObj - The object from which the elements are to be added.

aDelimiter - The path delimiter to be used for the path declarations.

aType - The type of the values being referenced by the paths.

MapPathTable

public MapPathTable(String aToPath,
 Object aObj,
 char aDelimiter,
 Class<T> aType)

Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).

Parameters:

aToPath - The sub-path where to insert the object's introspected values to.

aObj - The object from which the elements are to be added.

aDelimiter - The path delimiter to be used for the path declarations.

aType - The type of the values being referenced by the paths.

MapPathTable

public MapPathTable(Object aObj,
 String aFromPath,
 char aDelimiter,
 Class<T> aType)

Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).

Parameters:

aObj - The object from which the elements are to be added.

aFromPath - The path from where to start adding elements of the provided object.

aDelimiter - The path delimiter to be used for the path declarations.

aType - The type of the values being referenced by the paths.

MapPathTable

public MapPathTable(String aToPath,
 Object aObj,
 String aFromPath,
 char aDelimiter,
 Class<T> aType)

Create a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).

Parameters:

aToPath - The sub-path where to insert the object's introspected values to.

aObj - The object from which the elements are to be added.

aFromPath - The path from where to start adding elements of the provided object.

aDelimiter - The path delimiter to be used for the path declarations.

aType - The type of the values being referenced by the paths.

MapPathTable

public MapPathTable(char aDelimiter,
 Class<T> aType,
 Map<String,T> aBackingMap)

Create a PathTable instance using the provided path delimiter for the path declarations.

Parameters:

aDelimiter - The path delimiter to be used for the path declarations.

aType - The type of the values being referenced by the paths.

aBackingMap - The backing map used as underlying Map instance.

MapPathTable

public MapPathTable(Class<T> aType,
 Map<String,T> aBackingMap)

Create an empty PathTable instance using the default path delimiter "/" (Delimiter.PATH) for the path declarations.

Parameters:

aType - The type of the values being referenced by the paths.

aBackingMap - The backing map used as underlying Map instance.

MapPathTable

public MapPathTable(Object aObj,
 Class<T> aType,
 Map<String,T> aBackingMap)

Create a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH) for the path declarations.

Parameters:

aObj - The object from which the elements are to be added.

aType - The type of the values being referenced by the paths.

aBackingMap - The backing map used as underlying Map instance.

MapPathTable

public MapPathTable(String aToPath,
 Object aObj,
 Class<T> aType,
 Map<String,T> aBackingMap)

Create a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH) for the path declarations.

Parameters:

aToPath - The sub-path where to insert the object's introspected values to.

aObj - The object from which the elements are to be added.

aType - The type of the values being referenced by the paths.

aBackingMap - The backing map used as underlying Map instance.

MapPathTable

public MapPathTable(Object aObj,
 String aFromPath,
 Class<T> aType,
 Map<String,T> aBackingMap)

Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH) for the path declarations.

Parameters:

aObj - The object from which the elements are to be added.

aFromPath - The path from where to start adding elements of the provided object.

aType - The type of the values being referenced by the paths.

aBackingMap - The backing map used as underlying Map instance.

MapPathTable

public MapPathTable(String aToPath,
 Object aObj,
 String aFromPath,
 Class<T> aType,
 Map<String,T> aBackingMap)

Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object) using the default path delimiter "/" (Delimiter.PATH for the path declarations.

Parameters:

aToPath - The sub-path where to insert the object's introspected values to.

aObj - The object from which the elements are to be added.

aFromPath - The path from where to start adding elements of the provided object.

aType - The type of the values being referenced by the paths.

aBackingMap - The backing map used as underlying Map instance.

MapPathTable

public MapPathTable(Object aObj,
 char aDelimiter,
 Class<T> aType,
 Map<String,T> aBackingMap)

Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).

Parameters:

aObj - The object from which the elements are to be added.

aDelimiter - The path delimiter to be used for the path declarations.

aType - The type of the values being referenced by the paths.

aBackingMap - The backing map used as underlying Map instance.

MapPathTable

public MapPathTable(String aToPath,
 Object aObj,
 char aDelimiter,
 Class<T> aType,
 Map<String,T> aBackingMap)

Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).

Parameters:

aToPath - The sub-path where to insert the object's introspected values to.

aObj - The object from which the elements are to be added.

aDelimiter - The path delimiter to be used for the path declarations.

aType - The type of the values being referenced by the paths.

aBackingMap - The backing map used as underlying Map instance.

MapPathTable

public MapPathTable(Object aObj,
 String aFromPath,
 char aDelimiter,
 Class<T> aType,
 Map<String,T> aBackingMap)

Creates a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).

Parameters:

aObj - The object from which the elements are to be added.

aFromPath - The path from where to start adding elements of the provided object.

aDelimiter - The path delimiter to be used for the path declarations.

aType - The type of the values being referenced by the paths.

aBackingMap - The backing map used as underlying Map instance.

MapPathTable

public MapPathTable(String aToPath,
 Object aObj,
 String aFromPath,
 char aDelimiter,
 Class<T> aType,
 Map<String,T> aBackingMap)

Create a PathTable instance containing the elements as of ImmutablePathTable.MutablePathTable.insert(Object).

Parameters:

aToPath - The sub-path where to insert the object's introspected values to.

aObj - The object from which the elements are to be added.

aFromPath - The path from where to start adding elements of the provided object.

aDelimiter - The path delimiter to be used for the path declarations.

aType - The type of the values being referenced by the paths.

aBackingMap - The backing map used as underlying Map instance.

Method Details

containsKey

public boolean containsKey(Object aPath)

Tests whether there is an element with the given key.

Specified by:

containsKey in interface Keys<String,T>

Specified by:

containsKey in interface Map<String,T>

Parameters:

aPath - The key for which to test whether there is an element.

Returns:

True in case there is an element for the given key.

get

public T get(Object aPath)

Retrieves the element assigned to the given key.

Specified by:

get in interface Keys<String,T>

Specified by:

get in interface Map<String,T>

Parameters:

aPath - The key for which to get the element.

Returns:

The value for the key in question or null if there is none such value.

put

public T put(String aPath,
 T aValue)

Puts an element identified by the given key.

Specified by:

put in interface Keys.MutableValues<String,T>

Specified by:

put in interface Map<String,T>

Parameters:

aPath - The key which's element is to be put.

aValue - the value

Returns:

The value being overwritten.

remove

public T remove(Object aPath)

Specified by:

remove in interface Map<String,T>

getOrDefault

public T getOrDefault(Object aPath,
 T publicValue)

Specified by:

getOrDefault in interface Map<String,T>

putIfAbsent

public T putIfAbsent(String aPath,
 T value)

Specified by:

putIfAbsent in interface Map<String,T>

remove

public boolean remove(Object aPath,
 Object value)

Specified by:

remove in interface Map<String,T>

replace

public boolean replace(String aPath,
 T oldValue,
 T newValue)

Specified by:

replace in interface Map<String,T>

replace

public T replace(String aPath,
 T value)

Specified by:

replace in interface Map<String,T>

computeIfAbsent

public T computeIfAbsent(String aPath,
 Function<? super String,? extends T> mappingFunction)

Specified by:

computeIfAbsent in interface Map<String,T>

computeIfPresent

public T computeIfPresent(String aPath,
 BiFunction<? super String,? super T,? extends T> remappingFunction)

Specified by:

computeIfPresent in interface Map<String,T>

compute

public T compute(String aPath,
 BiFunction<? super String,? super T,? extends T> remappingFunction)

Specified by:

compute in interface Map<String,T>

merge

public T merge(String aPath,
 T value,
 BiFunction<? super T,? super T,? extends T> remappingFunction)

Specified by:

merge in interface Map<String,T>

retrieveTo

public PathTable<T> retrieveTo(String aToPath)

Extracts a new PathTable from this instance's elements with the paths relocated to the provided "to-path". Given we have a value for path "/dog/cat" in the PathTable and we call ImmutablePathTable.retrieveTo(String) with "/animals", then the resulting PathTable will contain the path "/animals/dog/cat" for that value.

Specified by:

retrieveTo in interface ImmutablePathTable<T>

Parameters:

aToPath - The path where to relocate the paths of this PathTable to.

Returns:

The PathTable with the elements from the provided PathTable with accordingly relocated paths.

retrieveFrom

public PathTable<T> retrieveFrom(String aFromPath)

Extracts a new PathTable from the elements of this instance found below the "from-path". The sub-paths will be the root paths for the new PathTable. Given we have a value for path "/dog/cat" in the PathTable and we call ImmutablePathTable.retrieveFrom(String) with "/dog", then the resulting PathTable will contain the path "/cat" for that value.

Specified by:

retrieveFrom in interface ImmutablePathTable<T>

Parameters:

aFromPath - The path from where to start extracting the paths.

Returns:

The PathTable with the elements below the provided path which are root elements in the new PathTable.

getDelimiter

public char getDelimiter()

Specified by:

getDelimiter in interface org.refcodes.mixin.DelimiterAccessor

getAnnotator

public char getAnnotator()

Specified by:

getAnnotator in interface org.refcodes.mixin.AnnotatorAccessor

getType

public Class<T> getType()

Specified by:

getType in interface org.refcodes.mixin.TypeAccessor<T>

toDataStructure

public Object toDataStructure(String aFromPath)

Similar to the ImmutablePathTable.toMap(String) method, though in case all the keys of a nested Map instance (applicable to the root Map as well) represent an array (as of ImmutablePathTable.getArray(String)), then an array is generated where the index of each value in the Map is represented by the number representation of the Map's key for that value. The result is a data structure consisting of Map instances and arrays.

Specified by:

toDataStructure in interface ImmutablePathTable<T>

Parameters:

aFromPath - The path below which this instance is to be converted into a data structure.

Returns:

A data structure being a mixture of Map instances and arrays representing the data below the given path.

insert

public void insert(Object aFrom)

Inspects the given object and adds all elements found in the given object. Elements of type Map, Collection and arrays are identified and handled as of their type: The path for each value in a Map is appended with its according key. The path for each value in a Collection or array is appended with its according index of occurrence (in case of a List or an array, its actual index). In case of reflection, the path for each member is appended with its according mamber's name. All elements (e.g. the members and values) are inspected recursively which results in the according paths of the terminating values.

Specified by:

insert in interface ImmutablePathTable.MutablePathTable<T>

Parameters:

aFrom - The object which is to be inspected with the therein contained values being added with their according determined paths.

insertBetween

public void insertBetween(String aToPath,
 Object aFrom,
 String aFromPath)

Same as ImmutablePathTable.MutablePathTable.insert(Object) though starting insertion of object's introspected values at the given "to-path" and starting object introspection at the given "from-path", e.g. ignoring all paths not starting with the given path during the introspection process. The resulting paths do not start with the "from-path" path, them start with the given "to-path".

Specified by:

insertBetween in interface ImmutablePathTable.MutablePathTable<T>

Parameters:

aToPath - The sub-path where to insert the object's introspected values to.

aFrom - The object which is to be inspected with the therein contained values being added with their according determined paths.

aFromPath - The path from where to start adding elements of the provided object.

insertFrom

public void insertFrom(Object aFrom,
 String aFromPath)

Same as ImmutablePathTable.MutablePathTable.insert(Object) though starting object introspection at the given "path", e.g. ignoring all paths not starting with the given path during the introspection process. The resulting paths do not start with the provided path.

Specified by:

insertFrom in interface ImmutablePathTable.MutablePathTable<T>

Parameters:

aFrom - The object which is to be inspected with the therein contained values being added with their according determined paths.

aFromPath - The path from where to start adding elements of the provided object.

insertTo

public void insertTo(String aToPath,
 Object aFrom)

Same as ImmutablePathTable.MutablePathTable.insert(Object) though starting insertion of object's introspected values at the given "path".

Specified by:

insertTo in interface ImmutablePathTable.MutablePathTable<T>

Parameters:

aToPath - The sub-path where to insert the object's introspected values to.

aFrom - The object which is to be inspected with the therein contained values being added with their according determined paths.

merge

public void merge(Object aFrom)

Inspects the given object and adds all elements found in the given object in case the targeted path does not exist or points to a null value. E.g. existing path/value pairs are not overwritten. Elements of type Map, Collection and arrays are identified and handled as of their type: The path for each value in a Map is appended with its according key. The path for each value in a Collection or array is appended with its according index of occurrence (in case of a List or an array, its actual index). In case of reflection, the path for each member is appended with its according mamber's name. All elements (e.g. the members and values) are inspected recursively which results in the according paths of the terminating values.

Specified by:

merge in interface ImmutablePathTable.MutablePathTable<T>

Parameters:

aFrom - The object which is to be inspected with the therein contained values being added with their according determined paths.

mergeBetween

public void mergeBetween(String aToPath,
 Object aFrom,
 String aFromPath)

Same as ImmutablePathTable.MutablePathTable.merge(Object) though starting merging of object's introspected values at the given "to-path" and starting object introspection at the given "from-path", e.g. ignoring all paths not starting with the given path during the introspection process. The resulting paths do not start with the "from-path" path, them start with the given "to-path".

Specified by:

mergeBetween in interface ImmutablePathTable.MutablePathTable<T>

Parameters:

aToPath - The sub-path where to merge the object's introspected values to.

aFrom - The object which is to be inspected with the therein contained values being added with their according determined paths.

aFromPath - The path from where to start adding elements of the provided object.

mergeFrom

public void mergeFrom(Object aFrom,
 String aFromPath)

Same as ImmutablePathTable.MutablePathTable.merge(Object) though starting object introspection at the given "path", e.g. ignoring all paths not starting with the given path during the introspection process. The resulting paths do not start with the provided path.

Specified by:

mergeFrom in interface ImmutablePathTable.MutablePathTable<T>

Parameters:

aFrom - The object which is to be inspected with the therein contained values being added with their according determined paths.

aFromPath - The path from where to start adding elements of the provided object.

mergeTo

public void mergeTo(String aToPath,
 Object aFrom)

Same as ImmutablePathTable.MutablePathTable.merge(Object) though starting merging of object's introspected values at the given "path".

Specified by:

mergeTo in interface ImmutablePathTable.MutablePathTable<T>

Parameters:

aToPath - The sub-path where to merge the object's introspected values to.

aFrom - The object which is to be inspected with the therein contained values being added with their according determined paths.

withPut

public PathTable<T> withPut(String aKey,
 T aValue)

Builder method for Keys.MutableValues.put(Object, Object).

Specified by:

withPut in interface Table<String,T,PathTable<T>>

Parameters:

aKey - the key for the property to be put.

aValue - the value for the property to be put.

Returns:

The implementing instance as of the builder pattern.

size

public int size()

Returns the number of data elements contained in the collection.

Specified by:

size in interface Containable

Specified by:

size in interface Map<String,T>

Returns:

An integer representing the number of items stored in the accumulation.

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface org.refcodes.mixin.EmptyAccessor

Specified by:

isEmpty in interface Map<String,T>

containsValue

public boolean containsValue(Object value)

This method is defined for the sake of Map conformity. Tests whether the provided value has a key assigned.

Specified by:

containsValue in interface Keys<String,T>

Specified by:

containsValue in interface Map<String,T>

Parameters:

value - The value to test if a key references this value.

Returns:

True in case the given value is referenced by a key.

putAll

public void putAll(Map<? extends String,? extends T> m)

Specified by:

putAll in interface Map<String,T>

clear

public void clear()

Specified by:

clear in interface org.refcodes.mixin.Clearable

Specified by:

clear in interface Map<String,T>

keySet

public Set<String> keySet()

Retrieves a collection containing all the keys found in the elements of this collection.

Specified by:

keySet in interface Keys<String,T>

Specified by:

keySet in interface Map<String,T>

Returns:

A collection with key objects being the keys of all elements in this collection.

values

public Collection<T> values()

Returns a Collection view of the values related to the contained keys.

Specified by:

values in interface Keys<String,T>

Specified by:

values in interface Map<String,T>

Returns:

A Collection view of the values related to the contained keys.

entrySet

public Set<Map.Entry<String,T>> entrySet()

Specified by:

entrySet in interface Map<String,T>

forEach

public void forEach(BiConsumer<? super String,? super T> action)

Specified by:

forEach in interface Map<String,T>

replaceAll

public void replaceAll(BiFunction<? super String,? super T,? extends T> function)

Specified by:

replaceAll in interface Map<String,T>

toType

public <TYPE> TYPE toType(String aFromPath,
 Class<TYPE> aType)

Creates an instance of the given type filled with this instance's data.

Specified by:

toType in interface ImmutablePathTable<T>

Type Parameters:

TYPE - the generic type if which to create an instance.

Parameters:

aFromPath - The path representing the root from which to take the data for the instance.

aType - the type if the instance to be filled with the herein contained data.

Returns:

the instance initialized with the herein contained data.

equals

public boolean equals(Object obj)

Specified by:

equals in interface Map<String,T>

Overrides:

equals in class Object

hashCode

public int hashCode()

Specified by:

hashCode in interface Map<String,T>

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

fromValue

protected void fromValue(String aToPath,
 Object aValue,
 Set<Object> aVisited)

Inserts the given Object (depending of its type) below the given path while tracking visited elements in case of introspection.

Parameters:

aToPath - The path below which to insert.

aValue - The value to be inserted.

aVisited - The visited elements for preventing turning circles (cyclic references).

fromValue

protected void fromValue(String aToPath,
 Object aObj)

Hook method for intercepting or modifying the process of object introspection.

Parameters:

aToPath - The sub-path where to insert the object's introspected values to.

aObj - The object from which the elements are to be added.

fromObject

protected ImmutablePathTable<T> fromObject(Object aFrom)

Hook method when internally creating ImmutablePathTable sub-types in the according ImmutablePathTable sub-type implementations.

Parameters:

aFrom - The Object from which to create a ImmutablePathTable (sub-type) instance.

Returns:

The according ImmutablePathTable (sub-type) instance.

fromInstance

protected T fromInstance(Object aValue)

Hook method when introspecting an object to help conversion of that object to the target types. By default this methods just tests for assignment conformity as of Class.isAssignableFrom(Class) with the type retrieved by getType().

Parameters:

aValue - The value which is to be transformed to the expected type as of getType().

Returns:

The converted type or null if conversion is not possible.

toInstance

protected <TYPE> TYPE toInstance(T aValue,
 Class<TYPE> aType)

Hook method when reconstructing an object, opposite of fromInstance(Object), tries to convert the given value to the desired type.

Type Parameters:

TYPE - The type to which to convert to.

Parameters:

aValue - The value to by converted from this instance's type as of getType() to the desired type.

aType - The type to which to convert to.

Returns:

The converted type or null if conversion is not possible.

createBackingMap

protected Map<String,T> createBackingMap()

Hook for creating an individual backing Map to be used by the UnmodifiablePathTableDecorator type (defaults to LinkedHashMap).

Returns:

The backing Map to be used.