org.refcodes.structure

Interface CanonicalMap

All Superinterfaces:

Containable, org.refcodes.mixin.DelimiterAccessor, Dictionary<String,String>, org.refcodes.mixin.Dumpable, Keys<String,String>, PathMap<String>, PropertiesAccessorMixin, org.refcodes.mixin.TypeAccessor<String>

All Known Subinterfaces:

CanonicalMap.CanonicalMapBuilder, CanonicalMap.MutableCanonicalMap

All Known Implementing Classes:

CanonicalMapBuilderImpl, CanonicalMapImpl

public interface CanonicalMap
extends PathMap<String>, PropertiesAccessorMixin

The CanonicalMap is an "intermediate" type adding type and Data-Structure related functionality to any implementing class.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	CanonicalMap.CanonicalMapBuilder The Interface CanonicalMapBuilder.
static interface	CanonicalMap.MutableCanonicalMap The Interface MutableCanonicalMap.

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

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

Nested classes/interfaces inherited from interface org.refcodes.structure.Dictionary

Dictionary.MutableDictionary<K,V>

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

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

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

org.refcodes.mixin.TypeAccessor.TypeMutator<T>, org.refcodes.mixin.TypeAccessor.TypeProperty<T>

Nested classes/interfaces inherited from interface org.refcodes.structure.PropertiesAccessorMixin

PropertiesAccessorMixin.PropertiesBuilderMixin<T>, PropertiesAccessorMixin.PropertiesMixin, PropertiesAccessorMixin.PropertiesMutatorMixin

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_COMMENT

Method Summary

Modifier and Type	Method and Description
default boolean	containsValue(Object value) This method is defined for the sake of Map conformity.
default CanonicalMap	retrieve(String aFromPath, String aToPath) Extracts a new PathMap from the elements of this PathMap found below the "from-path".
CanonicalMap	retrieveFrom(String aFromPath) Extracts a new PathMap from the elements of this PathMap found below the "from-path".
CanonicalMap	retrieveTo(String aToPath) Extracts a new PathMap from this PathMap's elements with the paths relocated to the provided "to-path".
default <T> void	toInstance(String aFromPath, T aInstance) Updates the instance with this CanonicalMap's data.
default <T> void	toInstance(T aInstance) Updates the instance with this CanonicalMap's data.
default <T> T	toType(Class<T> aType) Creates an instance of the given type filled with this CanonicalMap's data.
default <T> T	toType(String aFromPath, Class<T> aType) Creates an instance of the given type filled with this CanonicalMap's data.

Methods inherited from interface org.refcodes.structure.PathMap

directories, directories, entries, entries, fromExternalKey, getArray, getArray, hasParentPath, isArray, isArray, isDirectory, isEntry, isRecord, isRootPath, keySet, paths, paths, records, records, toDataStructure, toDataStructure, toExternalKey, toMap, toMap, toNormalizedPath, toNormalizedPath, toParentPath, toRootPath

Methods inherited from interface org.refcodes.structure.Keys

containsKey, get, keySet, use, values

Methods inherited from interface org.refcodes.structure.Containable

isEmpty, size

Methods inherited from interface org.refcodes.mixin.DelimiterAccessor

getDelimiter

Methods inherited from interface org.refcodes.mixin.TypeAccessor

getType

Methods inherited from interface org.refcodes.mixin.Dumpable

toDump, toDump

Methods inherited from interface org.refcodes.structure.PropertiesAccessorMixin

containsKey, get, getBoolean, getBoolean, getByte, getByte, getCharacter, getCharacter, getDouble, getDouble, getFloat, getFloat, getInteger, getInteger, getLong, getLong, getShort, getShort, use, useBoolean, useBoolean, useByte, useByte, useDouble, useDouble, useFloat, useFloat, useInteger, useInteger, useLong, useLong, useShort, useShort

Field Detail

DEFAULT_COMMENT

static final String DEFAULT_COMMENT

Method Detail

toType

default <T> T toType(Class<T> aType)

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

Type Parameters:

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

Parameters:

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

Returns:

the instance initialized with the herein contained data.

toType

default <T> T toType(String aFromPath,
                     Class<T> aType)

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

Type Parameters:

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

Parameters:

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

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

Returns:

the instance initialized with the herein contained data.

toInstance

default <T> void toInstance(T aInstance)

Updates the instance with this CanonicalMap's data. Instances inside the instance may not be updated!

Type Parameters:

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

Parameters:

aInstance - The instance to be updated with the herein contained data.

toInstance

default <T> void toInstance(String aFromPath,
                            T aInstance)

Updates the instance with this CanonicalMap's data. Instances inside the instance may not be updated!

Type Parameters:

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

aInstance - The instance to be updated with the herein contained data.

containsValue

default boolean containsValue(Object value)

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

Specified by:

containsValue in interface Keys<String,String>

Parameters:

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

Returns:

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

retrieveFrom

CanonicalMap retrieveFrom(String aFromPath)

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

Specified by:

retrieveFrom in interface PathMap<String>

Parameters:

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

Returns:

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

retrieveTo

CanonicalMap retrieveTo(String aToPath)

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

Specified by:

retrieveTo in interface PathMap<String>

Parameters:

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

Returns:

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

retrieve

default CanonicalMap retrieve(String aFromPath,
                              String aToPath)

Extracts a new PathMap from the elements of this PathMap found below the "from-path". The sub-paths will be relocated to the provided "to-path".

Specified by:

retrieve in interface PathMap<String>

Parameters:

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

aToPath - The path where to relocate the extracted paths to.

Returns:

The PathMap with the elements below the provided path "from-path" relocated to the given "to-path".