Package org.refcodes.structure

Class CanonicalMapImpl

java.lang.Object

org.refcodes.structure.CanonicalMapImpl

All Implemented Interfaces:

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

public class CanonicalMapImpl
extends Object
implements CanonicalMap

The Class CanonicalMapImpl.

Nested Class Summary

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

CanonicalMap.CanonicalMapBuilder, CanonicalMap.MutableCanonicalMap

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.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.structure.PathMap

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

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

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

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

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

Field Summary

Fields

Modifier and Type	Field	Description
protected CanonicalMap.CanonicalMapBuilder	_canonicalMap

Fields inherited from interface org.refcodes.structure.CanonicalMap

DEFAULT_COMMENT

Constructor Summary

Constructors

Constructor	Description
CanonicalMapImpl(Object aObject)	Instantiates a new canonical map impl.
CanonicalMapImpl(Map<?,?> aProperties)	Instantiates a new canonical map impl.

Method Summary

Modifier and Type	Method	Description
CanonicalMap	childrenOf(String aParentPath)	Gets the children elements of the provided parent's path, excluding the parent's path.
boolean	containsKey(Object aKey)	Tests whether there is an element with the given key.
String	get(Object aKey)	Retrieves the element assigned to the given key.
char	getDelimiter()
Class<String>	getType()
boolean	isEmpty()	Tests whether the accumulation is empty or not.
Set<String>	keySet()	Retrieves a collection containing all the keys found in the elements of this collection.
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".
int	size()	Returns the number of data elements contained in the collection.
Object	toDataStructure(String aFromPath)	Similar to the PathMap.toMap(String) method, though in case all the keys of a nested Map instance (applicable to the root Map as well) represent an array (as of PathMap.getArray( String)), then an array is generated where the index of each value in the Map is represented by the number representation of the Map's key for that value.
Collection<String>	values()	Returns a Collection view of the values related to the contained keys.

Methods inherited from interface org.refcodes.structure.CanonicalMap

containsValue, retrieve, toInstance, toInstance, toType, toType

Methods inherited from interface org.refcodes.mixin.Dumpable

toDump, toDump

Methods inherited from interface org.refcodes.structure.Keys

get, use

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.refcodes.structure.PathMap

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

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

_canonicalMap

protected CanonicalMap.CanonicalMapBuilder _canonicalMap

Constructor Detail

CanonicalMapImpl

public CanonicalMapImpl(Object aObject)

Instantiates a new canonical map impl.

Parameters:

aObject - the object

CanonicalMapImpl

public CanonicalMapImpl(Map<?,?> aProperties)

Instantiates a new canonical map impl.

Parameters:

aProperties - the properties

Method Detail

containsKey

public boolean containsKey(Object aKey)

Tests whether there is an element with the given key.

Specified by:

containsKey in interface Keys<String,T>

Parameters:

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

Returns:

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

get

public String get(Object aKey)

Retrieves the element assigned to the given key.

Specified by:

get in interface Keys<String,T>

Parameters:

aKey - The key for which to get the element.

Returns:

The column in question or null if there is none such column.

keySet

public Set<String> keySet()

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

Specified by:

keySet in interface Keys<String,T>

Returns:

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

values

public Collection<String> values()

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

Specified by:

values in interface Keys<String,T>

Returns:

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

size

public int size()

Returns the number of data elements contained in the collection.

Specified by:

size in interface Containable

Returns:

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

isEmpty

public boolean isEmpty()

Tests whether the accumulation is empty or not. Returns true if the accumulation is empty, else false is returned.

Specified by:

isEmpty in interface Containable

Returns:

True if no element is contained in the accumulation - else false is returned.

retrieveFrom

public 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 CanonicalMap

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

public 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 CanonicalMap

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.

childrenOf

public CanonicalMap childrenOf(String aParentPath)

Gets the children elements of the provided parent's path, excluding the parent's path.

Specified by:

childrenOf in interface CanonicalMap

Specified by:

childrenOf in interface PathMap<String>

Parameters:

aParentPath - The path from where to retrieve the children.

Returns:

The children of the given parent's path.

getDelimiter

public char getDelimiter()

Specified by:

getDelimiter in interface org.refcodes.mixin.DelimiterAccessor

getType

public Class<String> getType()

Specified by:

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

toDataStructure

public Object toDataStructure(String aFromPath)

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

Specified by:

toDataStructure in interface PathMap<String>

Parameters:

aFromPath - The path below which the PathMap to be converted into a data structure.

Returns:

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