Module org.refcodes.struct

Package org.refcodes.struct

Class StructureUtility

java.lang.Object

org.refcodes.struct.StructureUtility

public class StructureUtility
extends Object

Utility class to avoid redundant code regarding various PathMap implementations.

Method Summary

Modifier and Type	Method	Description
static <T> void	retrieveFrom(PathMap<T> aFromPathMap, String aFromPath, PathMap.PathMapBuilder<T> aToPathMap)	Hook method for implementing the PathMap.retrieveFrom(String) method.
static <T> void	retrieveTo(PathMap<T> aFromPathMap, String aToPath, PathMap.PathMapBuilder<T> aToPathMap)	Hook method for implementing the PathMap.retrieveTo(String) method.
static Object	toDataStructure(PathMap<?> aPathMap, String aFromPath)	Hook method for implementing the PathMap.toDataStructure() method.
static String	toGenericPath(PathMap<?> aPathMap, String aPath)	Normalizes the path as of PathMap.toNormalizedPath(String) and unifies it so that a path never ends with a delimiter (DelimiterAccessor.getDelimiter()).

Methods inherited from class java.lang.Object

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

Method Detail

retrieveFrom

public static <T> void retrieveFrom(PathMap<T> aFromPathMap,
                                    String aFromPath,
                                    PathMap.PathMapBuilder<T> aToPathMap)

Hook method for implementing the PathMap.retrieveFrom(String) method.

Type Parameters:

T - The type of the PathMap the functionality is to be applied to.

Parameters:

aFromPathMap - The PathMap from which to retrieve.

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

aToPathMap - The PathMap.PathMapBuilder which to put the result in.

retrieveTo

public static <T> void retrieveTo(PathMap<T> aFromPathMap,
                                  String aToPath,
                                  PathMap.PathMapBuilder<T> aToPathMap)

Hook method for implementing the PathMap.retrieveTo(String) method.

Type Parameters:

T - The type of the PathMap the functionality is to be applied to.

Parameters:

aFromPathMap - The PathMap from which to retrieve.

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

aToPathMap - The PathMap.PathMapBuilder which to put the result in.

toDataStructure

public static Object toDataStructure(PathMap<?> aPathMap,
                                     String aFromPath)

Hook method for implementing the PathMap.toDataStructure() method.

Parameters:

aPathMap - The PathMap from which to get the data structure.

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.

toGenericPath

public static String toGenericPath(PathMap<?> aPathMap,
                                   String aPath)

Normalizes the path as of PathMap.toNormalizedPath(String) and unifies it so that a path never ends with a delimiter (DelimiterAccessor.getDelimiter()). This is necessary as the root path is represented just by the delimiter, meaning that it also ends with the delimiter, though generic operations may require that a path must not end with the delimiter. This means that the root path is an empty String.

Parameters:

aPathMap - The PathMap for which to unify the path.

aPath - The path to be unified.

Returns:

The resulting generic path never ending with a delimiter.