- Type Parameters:
T
- The type of the value elements.
- All Superinterfaces:
org.refcodes.mixin.AnnotatorAccessor
,org.refcodes.mixin.Clearable
,Containable
,org.refcodes.mixin.DelimiterAccessor
,org.refcodes.mixin.Dumpable
,org.refcodes.mixin.EmptyAccessor
,Keys<String,
,T> Keys.MutableKeys<String,
,T> Keys.MutableValues<String,
,T> Map<String,
,T> PathMap<T>
,Table<String,
,T> Table.TableDictionary<String,
,T> org.refcodes.mixin.TypeAccessor<T>
- All Known Subinterfaces:
CanonicalMap.CanonicalMapBuilder
,CanonicalMap.MutableCanonicalMap
,ClassStructMap.ClassStructMapBuilder
,ClassStructMap.MutableClassStructMap
,InterOperableMap.InterOperableMapBuilder<T>
,InterOperableMap.MutableInterOperableMap<T>
,PathMap.PathMapBuilder<T>
,SimpleTypeMap.MutableSimpleTypeMap
,SimpleTypeMap.SimpleTypeMapBuilder
- All Known Implementing Classes:
CanonicalMapBuilderImpl
,ClassStructMapBuilderImpl
,PathMapBuilderImpl
,SimpleTypeMapBuilderImpl
public static interface PathMap.MutablePathMap<T>
extends PathMap<T>, Table.TableDictionary<String,T>, Map<String,T>
The
PathMap.MutablePathMap
adds mutable functionality to the
PathMap
.-
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.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 java.util.Map
Map.Entry<K extends Object,
V extends Object> 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.struct.Table.TableDictionary
Table.TableDictionary.TableBuilder<K,
V, B extends Table.TableDictionary.TableBuilder<K, V, B>> Nested classes/interfaces inherited from interface org.refcodes.mixin.TypeAccessor
org.refcodes.mixin.TypeAccessor.TypeBuilder<T extends Object,
B extends org.refcodes.mixin.TypeAccessor.TypeBuilder<T, B>>, org.refcodes.mixin.TypeAccessor.TypeMutator<T extends Object>, org.refcodes.mixin.TypeAccessor.TypeProperty<T extends Object> -
Field Summary
-
Method Summary
Modifier and TypeMethodDescriptiondefault void
Adds the given value to the path not overwriting any existing values: If the path points to a single value (and not to an array), then that value's path is converted to an array representation and the given value is appended to that array.default void
Adds the given value to the path not overwriting any existing values: If the path points to a single value (and not to an array), then that value's path is converted to an array representation and the given value is appended to that array.default void
Adds the given value to the path not overwriting any existing values: If the path points to a single value (and not to an array), then that value's path is converted to an array representation and the given value is appended to that array.default void
Adds the given value to the path not overwriting any existing values: If the path points to a single value (and not to an array), then that value's path is converted to an array representation and the given value is appended to that array.default void
add
(Collection<?> aPathElements, T aValue) Adds the given value to the path not overwriting any existing values: If the path points to a single value (and not to an array), then that value's path is converted to an array representation and the given value is appended to that array.default void
Adds an element to the next index as ofPathMap.nextArrayIndex(String[])
.default void
appendDirTo
(Object aDir) An indexed directory represents all elements which begin with a path which's last path element represents an index.default void
appendDirTo
(Object[] aPathElements, Object aDir) An indexed directory represents all elements which begin with a path which's last path element represents an index.default void
appendDirTo
(Object[] aPathElements, PathMap<T> aDir) An indexed directory represents all elements which begin with a path which's last path element represents an index.default void
appendDirTo
(Object aPath, Object aDir) An indexed directory represents all elements which begin with a path which's last path element represents an index.default void
appendDirTo
(Object aPath, PathMap<T> aDir) An indexed directory represents all elements which begin with a path which's last path element represents an index.default void
appendDirTo
(String[] aPathElements, Object aDir) An indexed directory represents all elements which begin with a path which's last path element represents an index.default void
appendDirTo
(String[] aPathElements, PathMap<T> aDir) An indexed directory represents all elements which begin with a path which's last path element represents an index.default void
appendDirTo
(String aPath, Object aDir) An indexed directory represents all elements which begin with a path which's last path element represents an index.default void
appendDirTo
(String aPath, PathMap<T> aDir) An indexed directory represents all elements which begin with a path which's last path element represents an index.default void
appendDirTo
(Collection<?> aPathElements, Object aDir) An indexed directory represents all elements which begin with a path which's last path element represents an index.default void
appendDirTo
(Collection<?> aPathElements, PathMap<T> aDir) An indexed directory represents all elements which begin with a path which's last path element represents an index.default void
appendDirTo
(PathMap<T> aDir) An indexed directory represents all elements which begin with a path which's last path element represents an index.default void
appendValueTo
(Object[] aPathElements, T aValue) Adds an element to the next index as ofPathMap.nextArrayIndex(String[])
.default void
appendValueTo
(Object aPath, T aValue) Adds an element to the next index as ofPathMap.nextArrayIndex(String[])
.default void
appendValueTo
(String[] aPathElements, T aValue) Adds an element to the next index as ofPathMap.nextArrayIndex(String)
.default void
appendValueTo
(String aPath, T aValue) Adds an element to the next index as ofPathMap.nextArrayIndex(String)
.default void
appendValueTo
(Collection<?> aPathElements, T aValue) Adds an element to the next index as ofPathMap.nextArrayIndex(String[])
.default void
appendValueTo
(T aValue) Adds an element to the next index as ofPathMap.nextArrayIndex()
.default T
Removes an element identified by the given key.default T
Removes an element identified by the given key.default T
Removes an element identified by the given key.default T
Removes an element identified by the given key.default T
delete
(Collection<?> aPathElements) Removes an element identified by the given key.default <TYPE> void
Fills thisPathMap
from the given type instance's data (e.g.default <TYPE> void
Fills thisPathMap
from the given type instance's data (e.g.default <TYPE> void
Fills thisPathMap
from the given type instance's data (e.g.default <TYPE> void
Fills thisPathMap
from the given type instance's data (e.g.default <TYPE> void
fromType
(Collection<?> aFromPathElements, TYPE aType) Fills thisPathMap
from the given type instance's data (e.g.default <TYPE> void
fromType
(TYPE aType) Fills thisPathMap
from the given type instance's data (e.g.default <TYPE> void
Fills thisPathMap
from the given type instance's data (e.g.default <TYPE> void
Fills thisPathMap
from the given type instance's data (e.g.void
Inspects the given object and adds all elements found in the given object.default void
Method to semantically emphasize that we support our own types.default void
insertBetween
(Object[] aToPathElements, Object aFrom, Object[] aFromPathElements) Same asinsert(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.default void
insertBetween
(Object[] aToPathElements, PathMap<T> aFrom, Object[] aFromPathElements) Method to semantically emphasize that we support our own types.default void
insertBetween
(Object aToPath, Object aFrom, Object aFromPath) Same asinsert(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.default void
insertBetween
(Object aToPath, PathMap<T> aFromMap, Object aFromPath) Method to semantically emphasize that we support our own types.default void
insertBetween
(String[] aToPathElements, Object aFrom, String[] aFromPathElements) Same asinsert(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.default void
insertBetween
(String[] aToPathElements, PathMap<T> aFrom, String[] aFromPathElements) Method to semantically emphasize that we support our own types.void
insertBetween
(String aToPath, Object aFrom, String aFromPath) Same asinsert(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.default void
insertBetween
(String aToPath, PathMap<T> aFrom, String aFromPath) Method to semantically emphasize that we support our own types.default void
insertBetween
(Collection<?> aToPathElements, Object aFrom, Collection<?> aFromPathElements) Same asinsert(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.default void
insertBetween
(Collection<?> aToPathElements, PathMap<T> aFrom, Collection<?> aFromPathElements) Method to semantically emphasize that we support our own types.default void
insertFrom
(Object aFrom, Object aFromPath) Same asinsert(Object)
though starting object introspection at the given "path", e.g. ignoring all paths not starting with the given path during the introspection process.default void
insertFrom
(Object aFrom, Object... aFromPathElements) Same asinsert(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
insertFrom
(Object aFrom, String aFromPath) Same asinsert(Object)
though starting object introspection at the given "path", e.g. ignoring all paths not starting with the given path during the introspection process.default void
insertFrom
(Object aFrom, String... aFromPathElements) Same asinsert(Object)
though starting object introspection at the given "path", e.g. ignoring all paths not starting with the given path during the introspection process.default void
insertFrom
(Object aFrom, Collection<?> aFromPathElements) Same asinsert(Object)
though starting object introspection at the given "path", e.g. ignoring all paths not starting with the given path during the introspection process.default void
insertFrom
(PathMap<T> aFrom, Object aFromPath) Method to semantically emphasize that we support our own types.default void
insertFrom
(PathMap<T> aFrom, Object... aFromPathElements) Method to semantically emphasize that we support our own types.default void
insertFrom
(PathMap<T> aFrom, String aFromPath) Method to semantically emphasize that we support our own types.default void
insertFrom
(PathMap<T> aFrom, String... aFromPathElements) Method to semantically emphasize that we support our own types.default void
insertFrom
(PathMap<T> aFrom, Collection<?> aFromPathElements) Method to semantically emphasize that we support our own types.default void
Same asinsert(Object)
though starting insertion of object's introspected values at the given "path".default void
Method to semantically emphasize that we support our own types.default void
Same asinsert(Object)
though starting insertion of object's introspected values at the given "path".default void
Method to semantically emphasize that we support our own types.default void
Same asinsert(Object)
though starting insertion of object's introspected values at the given "path".default void
Method to semantically emphasize that we support our own types.void
Same asinsert(Object)
though starting insertion of object's introspected values at the given "path".default void
Method to semantically emphasize that we support our own types.default void
insertTo
(Collection<?> aToPathElements, Object aFrom) Same asinsert(Object)
though starting insertion of object's introspected values at the given "path".default void
insertTo
(Collection<?> aToPathElements, PathMap<T> aFrom) Method to semantically emphasize that we support our own types.void
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.default void
Method to semantically emphasize that we support our own types.default void
mergeBetween
(Object[] aToPathElements, Object aFrom, Object[] aFromPathElements) Same asmerge(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.default void
mergeBetween
(Object[] aToPathElements, PathMap<T> aFrom, Object[] aFromPathElements) Method to semantically emphasize that we support our own types.default void
mergeBetween
(Object aToPath, Object aFromObj, Object aFromPath) Same asmerge(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.default void
mergeBetween
(Object aToPath, PathMap<T> aFromMap, Object aFromPath) Method to semantically emphasize that we support our own types.default void
mergeBetween
(String[] aToPathElements, Object aFrom, String[] aFromPathElements) Same asmerge(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.default void
mergeBetween
(String[] aToPathElements, PathMap<T> aFrom, String[] aFromPathElements) Method to semantically emphasize that we support our own types.void
mergeBetween
(String aToPath, Object aFrom, String aFromPath) Same asmerge(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.default void
mergeBetween
(String aToPath, PathMap<T> aFrom, String aFromPath) Method to semantically emphasize that we support our own types.default void
mergeBetween
(Collection<?> aToPathElements, Object aFrom, Collection<?> aFromPathElements) Same asmerge(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.default void
mergeBetween
(Collection<?> aToPathElements, PathMap<T> aFrom, Collection<?> aFromPathElements) Method to semantically emphasize that we support our own types.default void
Same asmerge(Object)
though starting object introspection at the given "path", e.g. ignoring all paths not starting with the given path during the introspection process.default void
Same asmerge(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
Same asmerge(Object)
though starting object introspection at the given "path", e.g. ignoring all paths not starting with the given path during the introspection process.default void
Same asmerge(Object)
though starting object introspection at the given "path", e.g. ignoring all paths not starting with the given path during the introspection process.default void
mergeFrom
(Object aFrom, Collection<?> aFromPathElements) Same asmerge(Object)
though starting object introspection at the given "path", e.g. ignoring all paths not starting with the given path during the introspection process.default void
Method to semantically emphasize that we support our own types.default void
Method to semantically emphasize that we support our own types.default void
Method to semantically emphasize that we support our own types.default void
Method to semantically emphasize that we support our own types.default void
mergeFrom
(PathMap<T> aFrom, Collection<?> aFromPathElements) Method to semantically emphasize that we support our own types.default void
Same asmerge(Object)
though starting merging of object's introspected values at the given "path".default void
Method to semantically emphasize that we support our own types.default void
Same asmerge(Object)
though starting merging of object's introspected values at the given "path".default void
Method to semantically emphasize that we support our own types.default void
Same asmerge(Object)
though starting merging of object's introspected values at the given "path".default void
Method to semantically emphasize that we support our own types.void
Same asmerge(Object)
though starting merging of object's introspected values at the given "path".default void
Method to semantically emphasize that we support our own types.default void
mergeTo
(Collection<?> aToPathElements, Object aFrom) Same asmerge(Object)
though starting merging of object's introspected values at the given "path".default void
mergeTo
(Collection<?> aToPathElements, PathMap<T> aFrom) Method to semantically emphasize that we support our own types.default T
Puts the given value into the child's path, relative to the given parent's path.default T
Puts the given value into the child's path, relative to the given parent's path.default T
put
(Collection<?> aPathElements, T aValue) Puts the given value into the child's path, relative to the given parent's path.default T
Adds the given element related to the given key.default T[]
putArray
(Object[] aPathElements, Collection<T> aValues) Sets the leaves below the given path in an array and replaces any existing array.default T[]
Sets the leaves below the given path in an array and replaces any existing array.default T[]
putArray
(Object aPath, Collection<T> aValues) Sets the leaves below the given path in an array and replaces any existing array.default T[]
Sets the leaves below the given path in an array and replaces any existing array.default T[]
putArray
(String[] aPathElements, Collection<T> aValues) Sets the leaves below the given path in an array and replaces any existing array.default T[]
Sets the leaves below the given path in an array and replaces any existing array.default T[]
putArray
(String aPath, Collection<T> aValues) Sets the leaves below the given path in an array and replaces any existing array.default T[]
Sets the leaves below the given path in an array and replaces any existing array.default T[]
putArray
(Collection<?> aPathElements, Collection<T> aValues) Sets the leaves below the given path in an array and replaces any existing array.default T[]
putArray
(Collection<?> aPathElements, T[] aValues) Sets the leaves below the given path in an array and replaces any existing array.default T[]
putArray
(Collection<T> aValues) Applies theputArray(Object[])
method for the root path "/".default T[]
Applies theputArray(Object[])
method for the root path "/".An indexed directory represents all elements which begin with a path which's last path element represents an index.An indexed directory represents all elements which begin with a path which's last path element represents an index.An indexed directory represents all elements which begin with a path which's last path element represents an index.An indexed directory represents all elements which begin with a path which's last path element represents an index.An indexed directory represents all elements which begin with a path which's last path element represents an index.An indexed directory represents all elements which begin with a path which's last path element represents an index.An indexed directory represents all elements which begin with a path which's last path element represents an index.An indexed directory represents all elements which begin with a path which's last path element represents an index.An indexed directory represents all elements which begin with a path which's last path element represents an index.An indexed directory represents all elements which begin with a path which's last path element represents an index.putDirAt
(Collection<?> aPathElements, int aIndex, Object aDir) An indexed directory represents all elements which begin with a path which's last path element represents an index.putDirAt
(Collection<?> aPathElements, int aIndex, PathMap<T> aDir) An indexed directory represents all elements which begin with a path which's last path element represents an index.default T
putValueAt
(int aIndex, T aValue) Puts a value below the root path at the given index as ofputArray(String, Object[])
.default T
putValueAt
(Object[] aPathElements, int aIndex, T aValue) Puts a value below the path at the given index as ofputArray(String, Object[])
.default T
putValueAt
(Object aPath, int aIndex, T aValue) Puts a value below the path at the given index as ofputArray(String, Object[])
.default T
putValueAt
(String[] aPathElements, int aIndex, T aValue) Puts a value below the path at the given index as ofputArray(String, Object[])
.default T
putValueAt
(String aPath, int aIndex, T aValue) Puts a value below the path at the given index as ofputArray(String, Object[])
.default T
putValueAt
(Collection<?> aPathElements, int aIndex, T aValue) Puts a value below the path at the given index as ofputArray(String, Object[])
.default T
Removes the property as ofMap.remove(Object)
for the provided path elements (as ofPathMap.toPath(Object...)
).default T
Removes the property as ofMap.remove(Object)
for the provided path elements (as ofPathMap.toPath(String...)
).default T
Removes the property as ofMap.remove(Object)
for the provided path elements (as ofPathMap.toPath(String...)
).Removes all elements which's keys match the provided path query.Removes all elements which's keys match the provided path query.Removes all elements which's keys match the provided path query.Removes all elements which's keys match the provided path query.removeAll
(Collection<?> aPathQueryElements) Removes all elements which's keys match the provided path query.Removes all elements which's keys match the provided regular expression: Queries the keys of the instance using the providedPattern
.removeDirAt
(int aIndex) An indexed directory represents all elements which begin with a path which's last path element represents an index.removeDirAt
(Object[] aPathElements, int aIndex) An indexed directory represents all elements which begin with a path which's last path element represents an index.removeDirAt
(Object aPath, int aIndex) An indexed directory represents all elements which begin with a path which's last path element represents an index.removeDirAt
(String[] aPathElements, int aIndex) An indexed directory represents all elements which begin with a path which's last path element represents an index.removeDirAt
(String aPath, int aIndex) An indexed directory represents all elements which begin with a path which's last path element represents an index.removeFrom
(Object aPath) Removes all properties below the provided path and returns thePathMap
with the removed elements, by which the paths exclude the parent's path.removeFrom
(Object... aPathElements) Removes all properties below the provided path and returns thePathMap
with the removed elements, by which the paths exclude the parent's path.removeFrom
(String aPath) Removes all properties below the provided path and returns thePathMap
with the removed elements, by which the paths exclude the parent's path.removeFrom
(String... aPathElements) Removes all properties below the provided path and returns thePathMap
with the removed elements, by which the paths exclude the parent's path.removeFrom
(Collection<?> aPathElements) Removes all properties below the provided path and returns thePathMap
with the removed elements, by which the paths exclude the parent's path.removePaths
(String... aPaths) Removes the paths contained in the provided collection.removePaths
(Collection<?> aPaths) Removes the paths contained in the provided collection.default T
removeValueAt
(int aIndex) Removes the value of an array at the root path with the given array index.default T
removeValueAt
(Object[] aPathElements, int aIndex) Removes the value of an array at the given path path with the given array index.default T
removeValueAt
(Object aPath, int aIndex) Removes the value of an array at the given path path with the given array index.default T
removeValueAt
(String[] aPathElements, int aIndex) Removes the value of an array at the given path path with the given array index.default T
removeValueAt
(String aPath, int aIndex) Removes the value of an array at the given path path with the given array index.default String
Beta, don't know whether to keep this or not: Creates a class (aString
text to be copy'n'pasted) with getters and setters for the herein contained paths and their values.default String
toSourceCode
(String aClassName, String aPackage) Beta, don't know whether to keep this or not: Creates a class (aString
text to be copy'n'pasted) with getters and setters for the herein contained paths and their values.Methods inherited from interface org.refcodes.mixin.AnnotatorAccessor
getAnnotator
Methods inherited from interface org.refcodes.mixin.Clearable
clear
Methods inherited from interface org.refcodes.struct.Containable
size
Methods inherited from interface org.refcodes.mixin.DelimiterAccessor
getDelimiter
Methods inherited from interface org.refcodes.mixin.Dumpable
toDump, toDump
Methods inherited from interface org.refcodes.mixin.EmptyAccessor
isEmpty
Methods inherited from interface org.refcodes.struct.Keys
containsKey, containsValue, get, getOr, keySet, use, values
Methods inherited from interface org.refcodes.struct.Keys.MutableValues
put
Methods inherited from interface java.util.Map
clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keySet, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values
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, retrieveFrom, retrieveTo, retrieveTo, retrieveTo, retrieveTo, retrieveTo, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, toDataStructure, 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
Methods inherited from interface org.refcodes.mixin.TypeAccessor
getType
-
Method Details
-
add
Adds the given value to the path not overwriting any existing values: If the path points to a single value (and not to an array), then that value's path is converted to an array representation and the given value is appended to that array.- Parameters:
aPathElements
- The path elements to which to add the element.aValue
- The value to be added.
-
add
Adds the given value to the path not overwriting any existing values: If the path points to a single value (and not to an array), then that value's path is converted to an array representation and the given value is appended to that array.- Parameters:
aPath
- The path to which to add the element.aValue
- The value to be added.
-
add
Adds the given value to the path not overwriting any existing values: If the path points to a single value (and not to an array), then that value's path is converted to an array representation and the given value is appended to that array.- Parameters:
aPathElements
- The path elements to which to add the element.aValue
- The value to be added.
-
add
Adds the given value to the path not overwriting any existing values: If the path points to a single value (and not to an array), then that value's path is converted to an array representation and the given value is appended to that array.- Parameters:
aPath
- The path to which to add the element.aValue
- The value to be added.
-
add
Adds the given value to the path not overwriting any existing values: If the path points to a single value (and not to an array), then that value's path is converted to an array representation and the given value is appended to that array.- Parameters:
aPathElements
- The path elements to which to add the element.aValue
- The value to be added.
-
add
Adds an element to the next index as ofPathMap.nextArrayIndex(String[])
. If the path points to a single value (and not to an array), then that value's path is converted to an array representation and the given value is appended to that array.- Parameters:
aValue
- The value to be appended.
-
appendDirTo
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Adds all given properties to the next index as ofPathMap.nextDirIndex(String[])
.- Parameters:
aPathElements
- The path elements of the path to which to append the given elements.aDir
- The values to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
appendDirTo
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Adds all given properties to the next index as ofPathMap.nextDirIndex(String[])
.- Parameters:
aPathElements
- The path elements of the path to which to append the given elements.aDir
- The values to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
appendDirTo
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Adds all given properties to the next index as ofPathMap.nextDirIndex()
.- Parameters:
aDir
- The values to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir()
.
-
appendDirTo
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Adds all given properties to the next index as ofPathMap.nextDirIndex(String[])
.- Parameters:
aPath
- The path to which to append the given elements.aDir
- The values to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
appendDirTo
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Adds all given properties to the next index as ofPathMap.nextDirIndex(String[])
.- Parameters:
aPath
- The path to which to append the given elements.aDir
- The values to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
appendDirTo
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Adds all given properties to the next index as ofPathMap.nextDirIndex(String[])
.- Parameters:
aPathElements
- The path elements of the path to which to append the given elements.aDir
- The values to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
appendDirTo
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Adds all given properties to the next index as ofPathMap.nextDirIndex(String[])
.- Parameters:
aPathElements
- The path elements of the path to which to append the given elements.aDir
- The values to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
appendDirTo
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Adds all given properties to the next index as ofPathMap.nextDirIndex()
.- Parameters:
aDir
- The values to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir()
.
-
appendDirTo
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Adds all given properties to the next index as ofPathMap.nextDirIndex(String)
.- Parameters:
aPath
- The path to which to append the given elements.aDir
- The values to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
appendDirTo
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Adds all given properties to the next index as ofPathMap.nextDirIndex(String)
.- Parameters:
aPath
- The path to which to append the given elements.aDir
- The values to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
appendDirTo
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Adds all given properties to the next index as ofPathMap.nextDirIndex(String)
.- Parameters:
aPathElements
- The path elements of the path to which to append the given elements.aDir
- The values to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
appendDirTo
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Adds all given properties to the next index as ofPathMap.nextDirIndex(String)
.- Parameters:
aPathElements
- The path elements of the path to which to append the given elements.aDir
- The values to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
appendValueTo
Adds an element to the next index as ofPathMap.nextArrayIndex(String[])
.- Parameters:
aPathElements
- The path elements of the path to which to append the next indexed element.aValue
- The value to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isArray(String)
.
-
appendValueTo
Adds an element to the next index as ofPathMap.nextArrayIndex(String[])
.- Parameters:
aPath
- The path to which to append the next indexed element.aValue
- The value to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isArray(String)
.
-
appendValueTo
Adds an element to the next index as ofPathMap.nextArrayIndex(String[])
.- Parameters:
aPathElements
- The path elements of the path to which to append the next indexed element.aValue
- The value to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isArray(String)
.
-
appendValueTo
Adds an element to the next index as ofPathMap.nextArrayIndex(String)
.- Parameters:
aPath
- The path to which to append the next indexed element.aValue
- The value to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isArray(String)
.
-
appendValueTo
Adds an element to the next index as ofPathMap.nextArrayIndex(String)
.- Parameters:
aPathElements
- The path elements of the path to which to append the next indexed element.aValue
- The value to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isArray(String)
.
-
appendValueTo
Adds an element to the next index as ofPathMap.nextArrayIndex()
.- Parameters:
aValue
- The value to be appended.- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isArray()
.
-
delete
Removes an element identified by the given key.- Parameters:
aPathElements
- The path elements of the path which's element is to be removed.- Returns:
- The value being removed.
-
delete
Removes an element identified by the given key.- Parameters:
aPath
- The path which's element is to be removed.- Returns:
- The value being removed.
-
delete
Removes an element identified by the given key.- Parameters:
aPathElements
- The path elements of the path which's element is to be removed.- Returns:
- The value being removed.
-
delete
Removes an element identified by the given key.- Specified by:
delete
in interfaceKeys.MutableKeys<String,
T> - Parameters:
aPath
- The key which's element is to be removed.- Returns:
- The value being removed.
-
delete
Removes an element identified by the given key.- Parameters:
aPathElements
- The path elements of the path which's element is to be removed.- Returns:
- The value being removed.
-
insert
Inspects the given object and adds all elements found in the given object. Elements of typeMap
,Collection
and arrays are identified and handled as of their type: The path for each value in aMap
is appended with its according key. The path for each value in aCollection
or array is appended with its according index of occurrence (in case of aList
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.- Parameters:
aFrom
- The object which is to be inspected with the therein contained values being added with their according determined paths.
-
insert
Method to semantically emphasize that we support our own types. Actually delegates toinsert(Object)
.- Parameters:
aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.
-
insertBetween
default void insertBetween(Collection<?> aToPathElements, Object aFrom, Collection<?> aFromPathElements) Same asinsert(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".- Parameters:
aToPathElements
- The path elements of 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.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
insertBetween
default void insertBetween(Collection<?> aToPathElements, PathMap<T> aFrom, Collection<?> aFromPathElements) Method to semantically emphasize that we support our own types. Actually delegates toinsertBetween(String, Object, String)
.- Parameters:
aToPathElements
- The path elements of the sub-path where to insert the object's introspected values to.aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
insertBetween
Same asinsert(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".- 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.
-
insertBetween
Method to semantically emphasize that we support our own types. Actually delegates toinsertBetween(String, Object, String)
.- Parameters:
aToPath
- The sub-path where to insert the object's introspected values to.aFromMap
- ThePathMap
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.
-
insertBetween
Same asinsert(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".- Parameters:
aToPathElements
- The path elements of 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.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
insertBetween
Method to semantically emphasize that we support our own types. Actually delegates toinsertBetween(String, Object, String)
.- Parameters:
aToPathElements
- The path elements of the sub-path where to insert the object's introspected values to.aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
insertBetween
Same asinsert(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".- 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.
-
insertBetween
Method to semantically emphasize that we support our own types. Actually delegates toinsertBetween(String, Object, String)
.- Parameters:
aToPath
- The sub-path where to insert the object's introspected values to.aFrom
- ThePathMap
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.
-
insertBetween
Same asinsert(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".- Parameters:
aToPathElements
- The path elements of 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.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
insertBetween
Method to semantically emphasize that we support our own types. Actually delegates toinsertBetween(String, Object, String)
.- Parameters:
aToPathElements
- The path elements of the sub-path where to insert the object's introspected values to.aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
insertFrom
Same asinsert(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.- Parameters:
aFrom
- The object which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
insertFrom
Same asinsert(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.- 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.
-
insertFrom
Same asinsert(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.- Parameters:
aFrom
- The object which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
insertFrom
Same asinsert(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.- 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.
-
insertFrom
Same asinsert(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.- Parameters:
aFrom
- The object which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
insertFrom
Method to semantically emphasize that we support our own types. Actually delegates toinsertFrom(Object, String)
.- Parameters:
aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
insertFrom
Method to semantically emphasize that we support our own types. Actually delegates toinsertFrom(Object, String)
.- Parameters:
aFrom
- ThePathMap
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
Method to semantically emphasize that we support our own types. Actually delegates toinsertFrom(Object, String)
.- Parameters:
aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
insertFrom
Method to semantically emphasize that we support our own types. Actually delegates toinsertFrom(Object, String)
.- Parameters:
aFrom
- ThePathMap
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
Method to semantically emphasize that we support our own types. Actually delegates toinsertFrom(Object, String)
.- Parameters:
aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
insertTo
Same asinsert(Object)
though starting insertion of object's introspected values at the given "path".- Parameters:
aToPathElements
- The path elements of 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.
-
insertTo
Method to semantically emphasize that we support our own types. Actually delegates toinsertTo(String, Object)
.- Parameters:
aToPathElements
- The path elements of the sub-path where to insert the object's introspected values to.aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.
-
insertTo
Same asinsert(Object)
though starting insertion of object's introspected values at the given "path".- 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.
-
insertTo
Method to semantically emphasize that we support our own types. Actually delegates toinsertTo(String, Object)
.- Parameters:
aToPath
- The sub-path where to insert the object's introspected values to.aFromMap
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.
-
insertTo
Same asinsert(Object)
though starting insertion of object's introspected values at the given "path".- Parameters:
aToPathElements
- The path elements of 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.
-
insertTo
Method to semantically emphasize that we support our own types. Actually delegates toinsertTo(String, Object)
.- Parameters:
aToPathElements
- The path elements of the sub-path where to insert the object's introspected values to.aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.
-
insertTo
Same asinsert(Object)
though starting insertion of object's introspected values at the given "path".- 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.
-
insertTo
Method to semantically emphasize that we support our own types. Actually delegates toinsertTo(String, Object)
.- Parameters:
aToPath
- The sub-path where to insert the object's introspected values to.aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.
-
insertTo
Same asinsert(Object)
though starting insertion of object's introspected values at the given "path".- Parameters:
aToPathElements
- The path elements of 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.
-
insertTo
Method to semantically emphasize that we support our own types. Actually delegates toinsertTo(String, Object)
.- Parameters:
aToPathElements
- The path elements of the sub-path where to insert the object's introspected values to.aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.
-
merge
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 typeMap
,Collection
and arrays are identified and handled as of their type: The path for each value in aMap
is appended with its according key. The path for each value in aCollection
or array is appended with its according index of occurrence (in case of aList
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.- Parameters:
aFrom
- The object which is to be inspected with the therein contained values being added with their according determined paths.
-
merge
Method to semantically emphasize that we support our own types. Actually delegates tomerge(Object)
.- Parameters:
aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.
-
mergeBetween
default void mergeBetween(Collection<?> aToPathElements, Object aFrom, Collection<?> aFromPathElements) Same asmerge(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".- Parameters:
aToPathElements
- The path elements of 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.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
mergeBetween
default void mergeBetween(Collection<?> aToPathElements, PathMap<T> aFrom, Collection<?> aFromPathElements) Method to semantically emphasize that we support our own types. Actually delegates tomergeBetween(String, Object, String)
.- Parameters:
aToPathElements
- The path elements of the sub-path where to merge the object's introspected values to.aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
mergeBetween
Same asmerge(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".- Parameters:
aToPath
- The sub-path where to merge the object's introspected values to.aFromObj
- 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.
-
mergeBetween
Method to semantically emphasize that we support our own types. Actually delegates tomergeBetween(String, Object, String)
.- Parameters:
aToPath
- The sub-path where to merge the object's introspected values to.aFromMap
- ThePathMap
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.
-
mergeBetween
Same asmerge(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".- Parameters:
aToPathElements
- The path elements of 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.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
mergeBetween
Method to semantically emphasize that we support our own types. Actually delegates tomergeBetween(String, Object, String)
.- Parameters:
aToPathElements
- The path elements of the sub-path where to merge the object's introspected values to.aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
mergeBetween
Same asmerge(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".- 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.
-
mergeBetween
Method to semantically emphasize that we support our own types. Actually delegates tomergeBetween(String, Object, String)
.- Parameters:
aToPath
- The sub-path where to merge the object's introspected values to.aFrom
- ThePathMap
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.
-
mergeBetween
Same asmerge(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".- Parameters:
aToPathElements
- The path elements of 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.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
mergeBetween
Method to semantically emphasize that we support our own types. Actually delegates tomergeBetween(String, Object, String)
.- Parameters:
aToPathElements
- The path elements of the sub-path where to merge the object's introspected values to.aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
mergeFrom
Same asmerge(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.- Parameters:
aFrom
- The object which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
mergeFrom
Same asmerge(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.- 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.
-
mergeFrom
Same asmerge(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.- Parameters:
aFrom
- The object which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
mergeFrom
Same asmerge(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.- 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.
-
mergeFrom
Same asmerge(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.- Parameters:
aFrom
- The object which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
mergeFrom
Method to semantically emphasize that we support our own types. Actually delegates tomergeFrom(Object, String)
.- Parameters:
aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
mergeFrom
Method to semantically emphasize that we support our own types. Actually delegates tomergeFrom(Object, String)
.- Parameters:
aFrom
- ThePathMap
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
Method to semantically emphasize that we support our own types. Actually delegates tomergeFrom(Object, String)
.- Parameters:
aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
mergeFrom
Method to semantically emphasize that we support our own types. Actually delegates tomergeFrom(Object, String)
.- Parameters:
aFrom
- ThePathMap
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
Method to semantically emphasize that we support our own types. Actually delegates tomergeFrom(Object, String)
.- Parameters:
aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.aFromPathElements
- The path elements of the path from where to start adding elements of the provided object.
-
mergeTo
Same asmerge(Object)
though starting merging of object's introspected values at the given "path".- Parameters:
aToPathElements
- The path elements of 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.
-
mergeTo
Method to semantically emphasize that we support our own types. Actually delegates tomergeTo(String, Object)
.- Parameters:
aToPathElements
- The path elements of the sub-path where to merge the object's introspected values to.aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.
-
mergeTo
Same asmerge(Object)
though starting merging of object's introspected values at the given "path".- Parameters:
aToPath
- The sub-path where to merge the object's introspected values to.aFromObj
- The object which is to be inspected with the therein contained values being added with their according determined paths.
-
mergeTo
Method to semantically emphasize that we support our own types. Actually delegates tomergeTo(String, Object)
.- Parameters:
aToPath
- The sub-path where to merge the object's introspected values to.aFromMap
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.
-
mergeTo
Same asmerge(Object)
though starting merging of object's introspected values at the given "path".- Parameters:
aToPathElements
- The path elements of 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.
-
mergeTo
Method to semantically emphasize that we support our own types. Actually delegates tomergeTo(String, Object)
.- Parameters:
aToPathElements
- The path elements of the sub-path where to merge the object's introspected values to.aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.
-
mergeTo
Same asmerge(Object)
though starting merging of object's introspected values at the given "path".- 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.
-
mergeTo
Method to semantically emphasize that we support our own types. Actually delegates tomergeTo(String, Object)
.- Parameters:
aToPath
- The sub-path where to merge the object's introspected values to.aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.
-
mergeTo
Same asmerge(Object)
though starting merging of object's introspected values at the given "path".- Parameters:
aToPathElements
- The path elements of 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.
-
mergeTo
Method to semantically emphasize that we support our own types. Actually delegates tomergeTo(String, Object)
.- Parameters:
aToPathElements
- The path elements of the sub-path where to merge the object's introspected values to.aFrom
- ThePathMap
which is to be inspected with the therein contained values being added with their according determined paths.
-
put
Puts the given value into the child's path, relative to the given parent's path.- Parameters:
aPathElements
- The path elements of the path relative to which to put the value.aValue
- The value to be added.- Returns:
- The replaced value in case a value has already been set for the resulting path, or null.
-
put
Puts the given value into the child's path, relative to the given parent's path.- Parameters:
aPathElements
- The path elements of the path relative to which to put the value.aValue
- The value to be added.- Returns:
- The replaced value in case a value has already been set for the resulting path, or null.
-
put
Adds the given element related to the given key.- Specified by:
put
in interfaceTable.TableDictionary<String,
T> - Parameters:
aRelation
- the relation- Returns:
- The value being replaced by the provided value or null if none value has been replaced.
-
put
Puts the given value into the child's path, relative to the given parent's path.- Parameters:
aPathElements
- The path elements of the path relative to which to put the value.aValue
- The value to be added.- Returns:
- The replaced value in case a value has already been set for the resulting path, or null.
-
putArray
Sets the leaves below the given path in an array and replaces any existing array. Leaves in aPathMap
are reckoned to be part of an array when they belong to the same hierarchy level and when their keys represent integer numbers. Given the below example, the elements below "/animals/dogs" can be represented as an array with five elements (the path is denoted at the left hand side of the assignment ":=" operator and the value at the right and side accordingly):- "/animals/dogs/0" := "ace"
- "/animals/dogs/1" := "bandit"
- "/animals/dogs/2" := "radar"
- "/animals/dogs/3" := "echo"
- "/animals/dogs/4" := "snoopy"
PathMap.getArray(String)
for the path "/animals/dogs" would contain {"ace", "bandit", "radar", "echo", "snoopy"}. CallingisArray("/animals/dogs")
would returntrue
whereas callingisArray("/animals")
would return false.- Parameters:
aPathElements
- The elements of the path below where to put the array.aValues
- The values to be put.- Returns:
- An array of the leaves being replaced by the provided elements.
-
putArray
Sets the leaves below the given path in an array and replaces any existing array. Leaves in aPathMap
are reckoned to be part of an array when they belong to the same hierarchy level and when their keys represent integer numbers. Given the below example, the elements below "/animals/dogs" can be represented as an array with five elements (the path is denoted at the left hand side of the assignment ":=" operator and the value at the right and side accordingly):- "/animals/dogs/0" := "ace"
- "/animals/dogs/1" := "bandit"
- "/animals/dogs/2" := "radar"
- "/animals/dogs/3" := "echo"
- "/animals/dogs/4" := "snoopy"
PathMap.getArray(String)
for the path "/animals/dogs" would contain {"ace", "bandit", "radar", "echo", "snoopy"}. CallingisArray("/animals/dogs")
would returntrue
whereas callingisArray("/animals")
would return false.- Parameters:
aPathElements
- The elements of the path below where to put the array.aValues
- The values to be put.- Returns:
- An array of the leaves being replaced by the provided elements.
-
putArray
Applies theputArray(Object[])
method for the root path "/".- Parameters:
aValues
- The values to be put.- Returns:
- An array of the leaves being replaced by the provided elements.
-
putArray
Sets the leaves below the given path in an array and replaces any existing array. Leaves in aPathMap
are reckoned to be part of an array when they belong to the same hierarchy level and when their keys represent integer numbers. Given the below example, the elements below "/animals/dogs" can be represented as an array with five elements (the path is denoted at the left hand side of the assignment ":=" operator and the value at the right and side accordingly):- "/animals/dogs/0" := "ace"
- "/animals/dogs/1" := "bandit"
- "/animals/dogs/2" := "radar"
- "/animals/dogs/3" := "echo"
- "/animals/dogs/4" := "snoopy"
PathMap.getArray(String)
for the path "/animals/dogs" would contain {"ace", "bandit", "radar", "echo", "snoopy"}. CallingisArray("/animals/dogs")
would returntrue
whereas callingisArray("/animals")
would return false.- Parameters:
aPath
- The path below where to put the array.aValues
- The values to be put.- Returns:
- An array of the leaves being replaced by the provided elements.
-
putArray
Sets the leaves below the given path in an array and replaces any existing array. Leaves in aPathMap
are reckoned to be part of an array when they belong to the same hierarchy level and when their keys represent integer numbers. Given the below example, the elements below "/animals/dogs" can be represented as an array with five elements (the path is denoted at the left hand side of the assignment ":=" operator and the value at the right and side accordingly):- "/animals/dogs/0" := "ace"
- "/animals/dogs/1" := "bandit"
- "/animals/dogs/2" := "radar"
- "/animals/dogs/3" := "echo"
- "/animals/dogs/4" := "snoopy"
PathMap.getArray(String)
for the path "/animals/dogs" would contain {"ace", "bandit", "radar", "echo", "snoopy"}. CallingisArray("/animals/dogs")
would returntrue
whereas callingisArray("/animals")
would return false.- Parameters:
aPath
- The path below where to put the array.aValues
- The values to be put.- Returns:
- An array of the leaves being replaced by the provided elements.
-
putArray
Sets the leaves below the given path in an array and replaces any existing array. Leaves in aPathMap
are reckoned to be part of an array when they belong to the same hierarchy level and when their keys represent integer numbers. Given the below example, the elements below "/animals/dogs" can be represented as an array with five elements (the path is denoted at the left hand side of the assignment ":=" operator and the value at the right and side accordingly):- "/animals/dogs/0" := "ace"
- "/animals/dogs/1" := "bandit"
- "/animals/dogs/2" := "radar"
- "/animals/dogs/3" := "echo"
- "/animals/dogs/4" := "snoopy"
PathMap.getArray(String)
for the path "/animals/dogs" would contain {"ace", "bandit", "radar", "echo", "snoopy"}. CallingisArray("/animals/dogs")
would returntrue
whereas callingisArray("/animals")
would return false.- Parameters:
aPathElements
- The elements of the path below where to put the array.aValues
- The values to be put.- Returns:
- An array of the leaves being replaced by the provided elements.
-
putArray
Sets the leaves below the given path in an array and replaces any existing array. Leaves in aPathMap
are reckoned to be part of an array when they belong to the same hierarchy level and when their keys represent integer numbers. Given the below example, the elements below "/animals/dogs" can be represented as an array with five elements (the path is denoted at the left hand side of the assignment ":=" operator and the value at the right and side accordingly):- "/animals/dogs/0" := "ace"
- "/animals/dogs/1" := "bandit"
- "/animals/dogs/2" := "radar"
- "/animals/dogs/3" := "echo"
- "/animals/dogs/4" := "snoopy"
PathMap.getArray(String)
for the path "/animals/dogs" would contain {"ace", "bandit", "radar", "echo", "snoopy"}. CallingisArray("/animals/dogs")
would returntrue
whereas callingisArray("/animals")
would return false.- Parameters:
aPathElements
- The elements of the path below where to put the array.aValues
- The values to be put.- Returns:
- An array of the leaves being replaced by the provided elements.
-
putArray
Sets the leaves below the given path in an array and replaces any existing array. Leaves in aPathMap
are reckoned to be part of an array when they belong to the same hierarchy level and when their keys represent integer numbers. Given the below example, the elements below "/animals/dogs" can be represented as an array with five elements (the path is denoted at the left hand side of the assignment ":=" operator and the value at the right and side accordingly):- "/animals/dogs/0" := "ace"
- "/animals/dogs/1" := "bandit"
- "/animals/dogs/2" := "radar"
- "/animals/dogs/3" := "echo"
- "/animals/dogs/4" := "snoopy"
PathMap.getArray(String)
for the path "/animals/dogs" would contain {"ace", "bandit", "radar", "echo", "snoopy"}. CallingisArray("/animals/dogs")
would returntrue
whereas callingisArray("/animals")
would return false.- Parameters:
aPath
- The path below where to put the array.aValues
- The values to be put.- Returns:
- An array of the leaves being replaced by the provided elements.
-
putArray
Sets the leaves below the given path in an array and replaces any existing array. Leaves in aPathMap
are reckoned to be part of an array when they belong to the same hierarchy level and when their keys represent integer numbers. Given the below example, the elements below "/animals/dogs" can be represented as an array with five elements (the path is denoted at the left hand side of the assignment ":=" operator and the value at the right and side accordingly):- "/animals/dogs/0" := "ace"
- "/animals/dogs/1" := "bandit"
- "/animals/dogs/2" := "radar"
- "/animals/dogs/3" := "echo"
- "/animals/dogs/4" := "snoopy"
PathMap.getArray(String)
for the path "/animals/dogs" would contain {"ace", "bandit", "radar", "echo", "snoopy"}. CallingisArray("/animals/dogs")
would returntrue
whereas callingisArray("/animals")
would return false.- Parameters:
aPath
- The path below where to put the array.aValues
- The values to be put.- Returns:
- An array of the leaves being replaced by the provided elements.
-
putArray
Sets the leaves below the given path in an array and replaces any existing array. Leaves in aPathMap
are reckoned to be part of an array when they belong to the same hierarchy level and when their keys represent integer numbers. Given the below example, the elements below "/animals/dogs" can be represented as an array with five elements (the path is denoted at the left hand side of the assignment ":=" operator and the value at the right and side accordingly):- "/animals/dogs/0" := "ace"
- "/animals/dogs/1" := "bandit"
- "/animals/dogs/2" := "radar"
- "/animals/dogs/3" := "echo"
- "/animals/dogs/4" := "snoopy"
PathMap.getArray(String)
for the path "/animals/dogs" would contain {"ace", "bandit", "radar", "echo", "snoopy"}. CallingisArray("/animals/dogs")
would returntrue
whereas callingisArray("/animals")
would return false.- Parameters:
aPathElements
- The elements of the path below where to put the array.aValues
- The values to be put.- Returns:
- An array of the leaves being replaced by the provided elements.
-
putArray
Sets the leaves below the given path in an array and replaces any existing array. Leaves in aPathMap
are reckoned to be part of an array when they belong to the same hierarchy level and when their keys represent integer numbers. Given the below example, the elements below "/animals/dogs" can be represented as an array with five elements (the path is denoted at the left hand side of the assignment ":=" operator and the value at the right and side accordingly):- "/animals/dogs/0" := "ace"
- "/animals/dogs/1" := "bandit"
- "/animals/dogs/2" := "radar"
- "/animals/dogs/3" := "echo"
- "/animals/dogs/4" := "snoopy"
PathMap.getArray(String)
for the path "/animals/dogs" would contain {"ace", "bandit", "radar", "echo", "snoopy"}. CallingisArray("/animals/dogs")
would returntrue
whereas callingisArray("/animals")
would return false.- Parameters:
aPathElements
- The elements of the path below where to put the array.aValues
- The values to be put.- Returns:
- An array of the leaves being replaced by the provided elements.
-
putArray
Applies theputArray(Object[])
method for the root path "/".- Parameters:
aValues
- The values to be put.- Returns:
- An array of the leaves being replaced by the provided elements.
-
putDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Puts the given values below the path at the given index.- Parameters:
aPathElements
- The path elements of the path where to put the indexed element.aIndex
- The index of the indexed element.aDir
- The values to be put at the index.- Returns:
- The directory which has been replaced by the given directory.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
putDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Puts the given values below the path at the given index.- Parameters:
aPathElements
- The path elements of the path where to put the indexed element.aIndex
- The index of the indexed element.aDir
- The values to be put at the index.- Returns:
- The directory which has been replaced by the given directory.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
putDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Puts the given values below the root path at the given index.- Parameters:
aIndex
- The index of the indexed element.aDir
- The values to be put at the index.- Returns:
- The directory which has been replaced by the given directory.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
putDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Puts the given values below the root path at the given index.- Parameters:
aIndex
- The index of the indexed element.aDir
- The values to be put at the index.- Returns:
- The directory which has been replaced by the given directory.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
putDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Puts the given values below the path at the given index.- Parameters:
aPath
- The path where to put the indexed element.aIndex
- The index of the indexed element.aDir
- The values to be put at the index.- Returns:
- The directory which has been replaced by the given directory.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
putDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Puts the given values below the path at the given index.- Parameters:
aPath
- The path where to put the indexed element.aIndex
- The index of the indexed element.aDir
- The values to be put at the index.- Returns:
- The directory which has been replaced by the given directory.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
putDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Puts the given values below the path at the given index.- Parameters:
aPathElements
- The path elements of the path where to put the indexed element.aIndex
- The index of the indexed element.aDir
- The values to be put at the index.- Returns:
- The directory which has been replaced by the given directory.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
putDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Puts the given values below the path at the given index.- Parameters:
aPathElements
- The path elements of the path where to put the indexed element.aIndex
- The index of the indexed element.aDir
- The values to be put at the index.- Returns:
- The directory which has been replaced by the given directory.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
putDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Puts the given values below the path at the given index.- Parameters:
aPath
- The path where to put the indexed element.aIndex
- The index of the indexed element.aDir
- The values to be put at the index.- Returns:
- The directory which has been replaced by the given directory.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
putDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Puts the given values below the path at the given index.- Parameters:
aPath
- The path where to put the indexed element.aIndex
- The index of the indexed element.aDir
- The values to be put at the index.- Returns:
- The directory which has been replaced by the given directory.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
putDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Puts the given values below the path at the given index.- Parameters:
aPathElements
- The path elements of the path where to put the indexed element.aIndex
- The index of the indexed element.aDir
- The values to be put at the index.- Returns:
- The directory which has been replaced by the given directory.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
putDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Puts the given values below the path at the given index.- Parameters:
aPathElements
- The path elements of the path where to put the indexed element.aIndex
- The index of the indexed element.aDir
- The values to be put at the index.- Returns:
- The directory which has been replaced by the given directory.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isIndexDir(String)
.
-
putValueAt
Puts a value below the path at the given index as ofputArray(String, Object[])
.- Parameters:
aPathElements
- The path elements of the path where to put the indexed element.aIndex
- The index of the indexed element.aValue
- The value to be put at the index.- Returns:
- The value which has been replaced by the given value.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isArray(String)
.
-
putValueAt
Puts a value below the root path at the given index as ofputArray(String, Object[])
.- Parameters:
aIndex
- The index of the indexed element.aValue
- The value to be put at the index.- Returns:
- The value which has been replaced by the given value.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isArray(String)
.
-
putValueAt
Puts a value below the path at the given index as ofputArray(String, Object[])
.- Parameters:
aPath
- The path where to put the indexed element.aIndex
- The index of the indexed element.aValue
- The value to be put at the index.- Returns:
- The value which has been replaced by the given value.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isArray(String)
.
-
putValueAt
Puts a value below the path at the given index as ofputArray(String, Object[])
.- Parameters:
aPathElements
- The path elements of the path where to put the indexed element.aIndex
- The index of the indexed element.aValue
- The value to be put at the index.- Returns:
- The value which has been replaced by the given value.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isArray(String)
.
-
putValueAt
Puts a value below the path at the given index as ofputArray(String, Object[])
.- Parameters:
aPath
- The path where to put the indexed element.aIndex
- The index of the indexed element.aValue
- The value to be put at the index.- Returns:
- The value which has been replaced by the given value.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isArray(String)
.
-
putValueAt
Puts a value below the path at the given index as ofputArray(String, Object[])
.- Parameters:
aPathElements
- The path elements of the path where to put the indexed element.aIndex
- The index of the indexed element.aValue
- The value to be put at the index.- Returns:
- The value which has been replaced by the given value.
- Throws:
IllegalArgumentException
- in case the path does not represent indexed elements as ofPathMap.isArray(String)
.
-
remove
Removes the property as ofMap.remove(Object)
for the provided path elements (as ofPathMap.toPath(Object...)
). BEWARE: The method with two arguments as ofMap.remove(Object, Object)
behaves https://www.metacodes.pro as of its inheritance fromMap.remove(Object, Object)
.- Parameters:
aPathElements
- The elements of the path from where to remove the property.- Returns:
- the previous value associated with the according path, or null if there was no mapping for the according path.
-
remove
Removes the property as ofMap.remove(Object)
for the provided path elements (as ofPathMap.toPath(String...)
).- Parameters:
aPathElements
- The elements of the path from where to remove the property.- Returns:
- the previous value associated with the according path, or null if there was no mapping for the according path.
-
remove
Removes the property as ofMap.remove(Object)
for the provided path elements (as ofPathMap.toPath(String...)
). This method overloads the methodMap.remove(Object, Object)
in order to prevent unexpected behavior of theremove(String...)
method!- Parameters:
aPathElement1
- The first path element of the path from where to remove the property.aPathElement2
- The second path element of the path from where to remove the property.- Returns:
- the previous value associated with the according path, or null if there was no mapping for the according path.
-
removeAll
Removes all elements which's keys match the provided path query. Queries the keys of the instance using thePathMatcher
' matching patterns, similar to the wildcards '*', '?' and '**' known when querying folders of a filesystem: ThePathMatcher
applies the following rules from the ANT path pattern to the query provided: A single asterisk ("*" as ofWildcard.FILE
) matches zero or more characters within a path name. A double asterisk ("**" as ofWildcard.PATH
) matches zero or more characters across directory levels. A question mark ("?" as ofWildcard.CHAR
) matches exactly one character within a path name. The single asterisk ("*" as ofWildcard.FILE
), the double asterisk ("**" as ofWildcard.PATH
) and the question mark ("?" as ofWildcard.CHAR
) we refer to as wildcards.- Parameters:
aPathQueryElements
- The elements representing your path query including your wildcards.- Returns:
- The removed properties.
-
removeAll
Removes all elements which's keys match the provided path query. Queries the keys of the instance using thePathMatcher
' matching patterns, similar to the wildcards '*', '?' and '**' known when querying folders of a filesystem: ThePathMatcher
applies the following rules from the ANT path pattern to the query provided: A single asterisk ("*" as ofWildcard.FILE
) matches zero or more characters within a path name. A double asterisk ("**" as ofWildcard.PATH
) matches zero or more characters across directory levels. A question mark ("?" as ofWildcard.CHAR
) matches exactly one character within a path name. The single asterisk ("*" as ofWildcard.FILE
), the double asterisk ("**" as ofWildcard.PATH
) and the question mark ("?" as ofWildcard.CHAR
) we refer to as wildcards.- Parameters:
aPathQueryElements
- The elements representing your path query including your wildcards.- Returns:
- The removed properties.
-
removeAll
Removes all elements which's keys match the provided path query. Queries the keys of the instance using thePathMatcher
' matching patterns, similar to the wildcards '*', '?' and '**' known when querying folders of a filesystem: ThePathMatcher
applies the following rules from the ANT path pattern to the query provided: A single asterisk ("*" as ofWildcard.FILE
) matches zero or more characters within a path name. A double asterisk ("**" as ofWildcard.PATH
) matches zero or more characters across directory levels. A question mark ("?" as ofWildcard.CHAR
) matches exactly one character within a path name. The single asterisk ("*" as ofWildcard.FILE
), the double asterisk ("**" as ofWildcard.PATH
) and the question mark ("?" as ofWildcard.CHAR
) we refer to as wildcards.- Parameters:
aPathQuery
- The path query including your wildcards.- Returns:
- The removed properties.
-
removeAll
Removes all elements which's keys match the provided regular expression: Queries the keys of the instance using the providedPattern
.- Parameters:
aRegExp
- The regular expression to be used for the query.- Returns:
- The removed properties.
-
removeAll
Removes all elements which's keys match the provided path query. Queries the keys of the instance using thePathMatcher
' matching patterns, similar to the wildcards '*', '?' and '**' known when querying folders of a filesystem: ThePathMatcher
applies the following rules from the ANT path pattern to the query provided: A single asterisk ("*" as ofWildcard.FILE
) matches zero or more characters within a path name. A double asterisk ("**" as ofWildcard.PATH
) matches zero or more characters across directory levels. A question mark ("?" as ofWildcard.CHAR
) matches exactly one character within a path name. The single asterisk ("*" as ofWildcard.FILE
), the double asterisk ("**" as ofWildcard.PATH
) and the question mark ("?" as ofWildcard.CHAR
) we refer to as wildcards.- Parameters:
aPathQueryElements
- The elements representing your path query including your wildcards.- Returns:
- The removed properties.
-
removeAll
Removes all elements which's keys match the provided path query. Queries the keys of the instance using thePathMatcher
' matching patterns, similar to the wildcards '*', '?' and '**' known when querying folders of a filesystem: ThePathMatcher
applies the following rules from the ANT path pattern to the query provided: A single asterisk ("*" as ofWildcard.FILE
) matches zero or more characters within a path name. A double asterisk ("**" as ofWildcard.PATH
) matches zero or more characters across directory levels. A question mark ("?" as ofWildcard.CHAR
) matches exactly one character within a path name. The single asterisk ("*" as ofWildcard.FILE
), the double asterisk ("**" as ofWildcard.PATH
) and the question mark ("?" as ofWildcard.CHAR
) we refer to as wildcards.- Parameters:
aPathQuery
- The path query including your wildcards.- Returns:
- The removed properties.
-
removeDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Removes the elements of the given index below the root path. Given the following paths and index = 1:/0/0aaa /0/0bbb /0/0bbb /1/1aaa /1/1bbb /1/1bbb
You will get a result containing all the elements which's keys begin with "/1/". The keys of the result will exclude the path "prefix" "/1".- Parameters:
aIndex
- The index which to use.- Returns:
- The indexed elements without the indexed path "prefixes".
-
removeDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Removes the elements of the given index below the given path. Given the following paths and index = 1 with a queried path "/root/child":/root/child/0/0aaa /root/child/0/0bbb /root/child/0/0bbb /root/child/1/1aaa /root/child/1/1bbb /root/child/1/1bbb
You will get a result containing all the elements which's keys begin with "/root/child/1/". The keys of the result will exclude the path "prefix" "/root/child/1".- Parameters:
aPath
- The path from which to remove the indexed elements.aIndex
- The index which to use.- Returns:
- The indexed elements without the indexed path "prefixes".
-
removeDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Removes the elements of the given index below the given path. Given the following paths and index = 1 with a queried path "/root/child":/root/child/0/0aaa /root/child/0/0bbb /root/child/0/0bbb /root/child/1/1aaa /root/child/1/1bbb /root/child/1/1bbb
You will get a result containing all the elements which's keys begin with "/root/child/1/".The keys of the result will exclude the path "prefix" "/root/child/1".- Parameters:
aPathElements
- The elements of the path from which to remove the indexed elements.aIndex
- The index which to use.- Returns:
- The indexed elements without the indexed path "prefixes".
-
removeDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Removes the elements of the given index below the given path. Given the following paths and index = 1 with a queried path "/root/child":/root/child/0/0aaa /root/child/0/0bbb /root/child/0/0bbb /root/child/1/1aaa /root/child/1/1bbb /root/child/1/1bbb
You will get a result containing all the elements which's keys begin with "/root/child/1/".The keys of the result will exclude the path "prefix" "/root/child/1".- Parameters:
aPath
- The path from which to remove the indexed elements.aIndex
- The index which to use.- Returns:
- The indexed elements without the indexed path "prefixes".
-
removeDirAt
An indexed directory represents all elements which begin with a path which's last path element represents an index. There may by many sub-paths for the same indexed path which are all are included by the according directory. Removes the elements of the given index below the given path. Given the following paths and index = 1 with a queried path "/root/child":/root/child/0/0aaa /root/child/0/0bbb /root/child/0/0bbb /root/child/1/1aaa /root/child/1/1bbb /root/child/1/1bbb
You will get a result containing all the elements which's keys begin with "/root/child/1/".The keys of the result will exclude the path "prefix" "/root/child/1".- Parameters:
aPathElements
- The elements of the path from which to remove the indexed elements.aIndex
- The index which to use.- Returns:
- The indexed elements without the indexed path "prefixes".
-
removeFrom
Removes all properties below the provided path and returns thePathMap
with the removed elements, by which the paths exclude the parent's path.- Parameters:
aPathElements
- The path elements for the path from where to remove all properties.- Returns:
- The removed properties.
-
removeFrom
Removes all properties below the provided path and returns thePathMap
with the removed elements, by which the paths exclude the parent's path.- Parameters:
aPathElements
- The path elements for the path from where to remove all properties.- Returns:
- The removed properties.
-
removeFrom
Removes all properties below the provided path and returns thePathMap
with the removed elements, by which the paths exclude the parent's path.- Parameters:
aPath
- The path from where to remove all properties.- Returns:
- The removed properties.
-
removeFrom
Removes all properties below the provided path and returns thePathMap
with the removed elements, by which the paths exclude the parent's path.- Parameters:
aPath
- The path from where to remove all properties.- Returns:
- The removed properties.
-
removeFrom
Removes all properties below the provided path and returns thePathMap
with the removed elements, by which the paths exclude the parent's path.- Parameters:
aPathElements
- The path elements for the path from where to remove all properties.- Returns:
- The removed properties.
-
removePaths
Removes the paths contained in the provided collection.- Parameters:
aPaths
- The paths to be removed.- Returns:
- The removed properties.
-
removePaths
Removes the paths contained in the provided collection.- Parameters:
aPaths
- The paths to be removed.- Returns:
- The removed properties.
-
removeValueAt
Removes the value of an array at the root path with the given array index.- Parameters:
aIndex
- The index inside the array for which to remove the value.- Returns:
- The removed value.
-
removeValueAt
Removes the value of an array at the given path path with the given array index.- Parameters:
aPath
- The path pointing to the array.aIndex
- The index inside the array for which to remove the value.- Returns:
- The removed value.
-
removeValueAt
Removes the value of an array at the given path path with the given array index.- Parameters:
aPathElements
- The path elements for the path pointing to the array.aIndex
- The index inside the array for which to remove the value.- Returns:
- The removed value.
-
removeValueAt
Removes the value of an array at the given path path with the given array index.- Parameters:
aPath
- The path pointing to the array.aIndex
- The index inside the array for which to remove the value.- Returns:
- The removed value.
-
removeValueAt
Removes the value of an array at the given path path with the given array index.- Parameters:
aPathElements
- The path elements for the path pointing to the array.aIndex
- The index inside the array for which to remove the value.- Returns:
- The removed value.
-
fromType
default <TYPE> void fromType(TYPE aType) Fills thisPathMap
from the given type instance's data (e.g. bean properties). This is a counterpart method forPathMap.toType(Class)
, though in fact it is the same asinsert(Object)
and provided for semantic emphasis and convenience. See also the methodsinsertFrom(Object, String)
,insertTo(String, PathMap)
orinsertBetween(String, Object, String)
as well as them variants.- Type Parameters:
TYPE
- the generic type if which to create an instance.- Parameters:
aType
- the type if the instance to be filled with the herein contained data.
-
fromType
Fills thisPathMap
from the given type instance's data (e.g. bean properties). This is a counterpart method forPathMap.toType(Object, Class)
, though in fact it is the same asinsertTo(Object, Object)
and provided for semantic emphasis and convenience. See also the methodsinsertFrom(Object, String)
,insertTo(String, PathMap)
orinsertBetween(String, Object, String)
as well as them variants.- 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.
-
fromType
Fills thisPathMap
from the given type instance's data (e.g. bean properties). This is a counterpart method forPathMap.toType(Object[], Class)
, though in fact it is the same asinsertTo(Object[], Object)
and provided for semantic emphasis and convenience. See also the methodsinsertFrom(Object, String)
,insertTo(String, PathMap)
orinsertBetween(String, Object, String)
as well as them variants.- Type Parameters:
TYPE
- the generic type if which to create an instance.- Parameters:
aFromPathElements
- The path elements 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.
-
fromType
Fills thisPathMap
from the given type instance's data (e.g. bean properties). This is a counterpart method forPathMap.toType(Object[], Class)
, though in fact it is the same asinsertTo(Object[], Object)
and provided for semantic emphasis and convenience. See also the methodsinsertFrom(Object, String)
,insertTo(String, PathMap)
orinsertBetween(String, Object, String)
as well as them variants.- Type Parameters:
TYPE
- the generic type if which to create an instance.- Parameters:
aType
- the type if the instance to be filled with the herein contained data.aFromPathElements
- The path elements representing the root from which to take the data for the instance.
-
fromType
Fills thisPathMap
from the given type instance's data (e.g. bean properties). This is a counterpart method forPathMap.toType(String[], Class)
, though in fact it is the same asinsertTo(String[], Object)
and provided for semantic emphasis and convenience. See also the methodsinsertFrom(Object, String)
,insertTo(String, PathMap)
orinsertBetween(String, Object, String)
as well as them variants.- Type Parameters:
TYPE
- the generic type if which to create an instance.- Parameters:
aFromPathElements
- The path elements 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.
-
fromType
Fills thisPathMap
from the given type instance's data (e.g. bean properties). This is a counterpart method forPathMap.toType(String[], Class)
, though in fact it is the same asinsertTo(String[], Object)
and provided for semantic emphasis and convenience. See also the methodsinsertFrom(Object, String)
,insertTo(String, PathMap)
orinsertBetween(String, Object, String)
as well as them variants.- Type Parameters:
TYPE
- the generic type if which to create an instance.- Parameters:
aType
- the type if the instance to be filled with the herein contained data.aFromPathElements
- The path elements representing the root from which to take the data for the instance.
-
fromType
Fills thisPathMap
from the given type instance's data (e.g. bean properties). This is a counterpart method forPathMap.toType(Collection, Class)
, though in fact it is the same asinsertTo(Collection, Object)
and provided for semantic emphasis and convenience. See also the methodsinsertFrom(Object, String)
,insertTo(String, PathMap)
orinsertBetween(String, Object, String)
as well as them variants.- Type Parameters:
TYPE
- the generic type if which to create an instance.- Parameters:
aFromPathElements
- The path elements 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.
-
fromType
Fills thisPathMap
from the given type instance's data (e.g. bean properties). This is a counterpart method forPathMap.toType(String, Class)
, though in fact it is the same asinsertTo(String, Object)
and provided for semantic emphasis and convenience. See also the methodsinsertFrom(Object, String)
,insertTo(String, PathMap)
orinsertBetween(String, Object, String)
as well as them variants.- 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.
-
toSourceCode
Beta, don't know whether to keep this or not: Creates a class (aString
text to be copy'n'pasted) with getters and setters for the herein contained paths and their values.- Returns:
- The text representing the source code to be copy'n'pasted.
-
toSourceCode
Beta, don't know whether to keep this or not: Creates a class (aString
text to be copy'n'pasted) with getters and setters for the herein contained paths and their values.- Parameters:
aClassName
- The class name for the class to be generated.aPackage
- The package to which the class is to belong.- Returns:
- The text representing the source code to be copy'n'pasted.
-