Module org.refcodes.struct

Package org.refcodes.struct

Class PathMapImpl<T>

java.lang.Object

org.refcodes.struct.PathMapImpl<T>

Type Parameters:

T - The type of the value elements.

All Implemented Interfaces:

org.refcodes.mixin.AnnotatorAccessor, org.refcodes.mixin.DelimiterAccessor, org.refcodes.mixin.Dumpable, org.refcodes.mixin.EmptyAccessor, org.refcodes.mixin.TypeAccessor<T>, Containable, Keys<String,T>, PathMap<T>, Table<String,T>

public class PathMapImpl<T>
extends Object
implements PathMap<T>

The PathMapImpl class implements the PathMap interface and provides a hook createBackingMap() method which may be overridden for providing another Map type as backing map than the default one.

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.Keys

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

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

PathMap.MutablePathMap<T>, PathMap.PathMapBuilder<T>

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

Table.TableDictionary<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 inherited from interface org.refcodes.struct.PathMap

ANNOTATOR, DELIMITER

Constructor Summary

Constructors

Modifier	Constructor	Description
	PathMapImpl(char aDelimiter, Class<T> aType)	Create a PathMap instance using the provided path delimiter for the path declarations.
	PathMapImpl(Object aObj, char aDelimiter, Class<T> aType)	Creates a PathMap instance containing the elements as of PathMap.MutablePathMap.insert(Object).
	PathMapImpl(Object aObj, Class<T> aType)	Create a PathMap instance containing the elements as of PathMap.MutablePathMap.insert(Object) using the default path delimiter "/" (Delimiter.PATH) for the path declarations.
	PathMapImpl(Object aObj, String aFromPath, char aDelimiter, Class<T> aType)	Creates a PathMap instance containing the elements as of PathMap.MutablePathMap.insert(Object).
	PathMapImpl(Object aObj, String aFromPath, Class<T> aType)	Creates a PathMap instance containing the elements as of PathMap.MutablePathMap.insert(Object) using the default path delimiter "/" (Delimiter.PATH) for the path declarations.
	PathMapImpl(String aToPath, Object aObj, char aDelimiter, Class<T> aType)	Creates a PathMap instance containing the elements as of PathMap.MutablePathMap.insert(Object).
	PathMapImpl(String aToPath, Object aObj, Class<T> aType)	Create a PathMap instance containing the elements as of PathMap.MutablePathMap.insert(Object) using the default path delimiter "/" (Delimiter.PATH) for the path declarations.
	PathMapImpl(String aToPath, Object aObj, String aFromPath, char aDelimiter, Class<T> aType)	Create a PathMap instance containing the elements as of PathMap.MutablePathMap.insert(Object).
	PathMapImpl(String aToPath, Object aObj, String aFromPath, Class<T> aType)	Creates a PathMap instance containing the elements as of PathMap.MutablePathMap.insert(Object) using the default path delimiter "/" (Delimiter.PATH for the path declarations.
protected	PathMapImpl(PathMap<T> aPathMap)	Create a PathMap instance from the provided PathMap instance containing the elements as of PathMap.MutablePathMap.insert(Object) using the PathMap's path delimiter for the path declarations the the type of the PathMap.

Method Summary

Modifier and Type	Method	Description
boolean	containsKey(Object aKey)	Tests whether there is an element with the given key.
boolean	containsValue(Object aValue)	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 PathMapImpl type (defaults to LinkedHashMap).
T	get(Object aKey)	Retrieves the element assigned to the given key.
char	getAnnotator()
char	getDelimiter()
Class<T>	getType()
boolean	isEmpty()
Set<String>	keySet()	Retrieves a collection containing all the keys found in the elements of this collection.
PathMap<T>	retrieveFrom(String aFromPath)	Extracts a new PathMap from the elements of this PathMap found below the "from-path".
PathMap<T>	retrieveTo(String aToPath)	Extracts a new PathMap from this PathMap'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 PathMap.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 PathMap.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.
Collection<T>	values()	Returns a Collection view of the values related to the contained keys.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.refcodes.mixin.Dumpable

toDump, toDump

Methods inherited from interface org.refcodes.struct.Keys

getOr, use

Methods inherited from interface org.refcodes.struct.PathMap

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, toType

Constructor Details

PathMapImpl

protected PathMapImpl(PathMap<T> aPathMap)

Create a PathMap instance from the provided PathMap instance containing the elements as of PathMap.MutablePathMap.insert(Object) using the PathMap's path delimiter for the path declarations the the type of the PathMap.

Parameters:

aPathMap - The PathMap from which the elements are to be added.

PathMapImpl

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

Create a PathMap 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.

PathMapImpl

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

Create a PathMap instance containing the elements as of PathMap.MutablePathMap.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.

PathMapImpl

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

Create a PathMap instance containing the elements as of PathMap.MutablePathMap.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.

PathMapImpl

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

Creates a PathMap instance containing the elements as of PathMap.MutablePathMap.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.

PathMapImpl

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

Creates a PathMap instance containing the elements as of PathMap.MutablePathMap.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.

PathMapImpl

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

Creates a PathMap instance containing the elements as of PathMap.MutablePathMap.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.

PathMapImpl

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

Creates a PathMap instance containing the elements as of PathMap.MutablePathMap.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.

PathMapImpl

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

Creates a PathMap instance containing the elements as of PathMap.MutablePathMap.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.

PathMapImpl

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

Create a PathMap instance containing the elements as of PathMap.MutablePathMap.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.

Method Details

containsKey

public boolean containsKey(Object aKey)

Tests whether there is an element with the given key.

Specified by:

containsKey in interface Keys<String,T>

Parameters:

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

Returns:

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

containsValue

public boolean containsValue(Object aValue)

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>

Parameters:

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

Returns:

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

get

public T get(Object aKey)

Retrieves the element assigned to the given key.

Specified by:

get in interface Keys<String,T>

Parameters:

aKey - The key for which to get the element.

Returns:

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

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>

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>

Returns:

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

size

public int size()

Returns the number of data elements contained in the collection.

Specified by:

size in interface Containable

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

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

retrieveFrom

public PathMap<T> retrieveFrom(String aFromPath)

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

Specified by:

retrieveFrom in interface PathMap<T>

Parameters:

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

Returns:

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

retrieveTo

public PathMap<T> retrieveTo(String aToPath)

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

Specified by:

retrieveTo in interface PathMap<T>

Parameters:

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

Returns:

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

getType

public Class<T> getType()

Specified by:

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

toDataStructure

public Object toDataStructure(String aFromPath)

Similar to the PathMap.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 PathMap.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 PathMap<T>

Parameters:

aFromPath - The path below which the PathMap 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.

createBackingMap

protected Map<String,T> createBackingMap()

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

Returns:

The backing Map to be used.