Package com.electronwill.nightconfig.core.utils

Class TransformingMap<K,InternalV,ExternalV>

java.lang.Object

java.util.AbstractMap<K,ExternalV>

com.electronwill.nightconfig.core.utils.TransformingMap<K,InternalV,ExternalV>

All Implemented Interfaces:

Map<K,ExternalV>

public final class TransformingMap<K,InternalV,ExternalV>
extends AbstractMap<K,ExternalV>

A TransformingMap contains an internal Map<K, InternalV> values, and exposes the features of a Map<K, ExternalV> applying transformations to the values.

The transformations are applied "just in time", that is, the values are converted only when they are used, not during the construction of the TransformingMap.

For instance, if you have a Map<String, String> and you want to convert its values "just in time" to integers, you use a TransformingMap<String, String, Integer>. To get one, you create these three functions:

• one that converts a String to an Integer: that's the parse transformation. It converts an Integer read from the internal map to a String.
• one that converts an Integer to a String: that's the write transformation. It converts a String given to the TransformingMap to an Integer.
• one that converts an Object to another Object: that's the search transformation. It is used (mainly) by the containsKey(Object) method of the TransformingMap. If its argument is an Integer then it should convert it to an String in the same way as the write transformation. Otherwise, it is free to try to convert it to a String if possible, or not to.

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

AbstractMap.SimpleEntry<K extends Object,V extends Object>, AbstractMap.SimpleImmutableEntry<K extends Object,V extends Object>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K extends Object,V extends Object>

Constructor Summary

Constructors

Constructor	Description
TransformingMap(Map<K,InternalV> map, Function<? super InternalV,? extends ExternalV> readTransformation, Function<? super ExternalV,? extends InternalV> writeTransformation, Function<Object,Object> searchTransformation)	Create a new TransformingMap.

Method Summary

Modifier and Type	Method	Description
void	clear()
ExternalV	compute(K key, BiFunction<? super K,? super ExternalV,? extends ExternalV> remappingFunction)
ExternalV	computeIfAbsent(K key, Function<? super K,? extends ExternalV> mappingFunction)
ExternalV	computeIfPresent(K key, BiFunction<? super K,? super ExternalV,? extends ExternalV> remappingFunction)
boolean	containsKey(Object key)
boolean	containsValue(Object value)
Set<Map.Entry<K,ExternalV>>	entrySet()
void	forEach(BiConsumer<? super K,? super ExternalV> action)
ExternalV	get(Object key)
ExternalV	getOrDefault(Object key, ExternalV defaultValue)
boolean	isEmpty()
Set<K>	keySet()
ExternalV	merge(K key, ExternalV value, BiFunction<? super ExternalV,? super ExternalV,? extends ExternalV> remappingFunction)
ExternalV	put(K key, ExternalV value)
void	putAll(Map<? extends K,? extends ExternalV> m)
ExternalV	putIfAbsent(K key, ExternalV value)
ExternalV	remove(Object key)
boolean	remove(Object key, Object value)
ExternalV	replace(K key, ExternalV value)
boolean	replace(K key, ExternalV oldValue, ExternalV newValue)
void	replaceAll(BiFunction<? super K,? super ExternalV,? extends ExternalV> function)
int	size()
Collection<ExternalV>	values()

Methods inherited from class java.util.AbstractMap

clone, equals, hashCode, toString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

TransformingMap

public TransformingMap(Map<K,InternalV> map,
 Function<? super InternalV,? extends ExternalV> readTransformation,
 Function<? super ExternalV,? extends InternalV> writeTransformation,
 Function<Object,Object> searchTransformation)

Create a new TransformingMap.

Parameters:

map - the internal map to use

readTransformation - the parse transformation (see javadoc of the class)

writeTransformation - the write transformation (see javadoc of the class)

searchTransformation - the search transformation (see javadoc of the class)

Method Details

size

public int size()

Specified by:

size in interface Map<K,InternalV>

Overrides:

size in class AbstractMap<K,ExternalV>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Map<K,InternalV>

Overrides:

isEmpty in class AbstractMap<K,ExternalV>

containsKey

public boolean containsKey(Object key)

Specified by:

containsKey in interface Map<K,InternalV>

Overrides:

containsKey in class AbstractMap<K,ExternalV>

containsValue

public boolean containsValue(Object value)

Specified by:

containsValue in interface Map<K,InternalV>

Overrides:

containsValue in class AbstractMap<K,ExternalV>

get

public ExternalV get(Object key)

Specified by:

get in interface Map<K,InternalV>

Overrides:

get in class AbstractMap<K,ExternalV>

put

public ExternalV put(K key,
 ExternalV value)

Specified by:

put in interface Map<K,InternalV>

Overrides:

put in class AbstractMap<K,ExternalV>

remove

public ExternalV remove(Object key)

Specified by:

remove in interface Map<K,InternalV>

Overrides:

remove in class AbstractMap<K,ExternalV>

putAll

public void putAll(Map<? extends K,? extends ExternalV> m)

Specified by:

putAll in interface Map<K,InternalV>

Overrides:

putAll in class AbstractMap<K,ExternalV>

clear

public void clear()

Specified by:

clear in interface Map<K,InternalV>

Overrides:

clear in class AbstractMap<K,ExternalV>

keySet

public Set<K> keySet()

Specified by:

keySet in interface Map<K,InternalV>

Overrides:

keySet in class AbstractMap<K,ExternalV>

values

public Collection<ExternalV> values()

Specified by:

values in interface Map<K,InternalV>

Overrides:

values in class AbstractMap<K,ExternalV>

entrySet

public Set<Map.Entry<K,ExternalV>> entrySet()

Specified by:

entrySet in interface Map<K,InternalV>

Specified by:

entrySet in class AbstractMap<K,ExternalV>

getOrDefault

public ExternalV getOrDefault(Object key,
 ExternalV defaultValue)

forEach

public void forEach(BiConsumer<? super K,? super ExternalV> action)

replaceAll

public void replaceAll(BiFunction<? super K,? super ExternalV,? extends ExternalV> function)

putIfAbsent

public ExternalV putIfAbsent(K key,
 ExternalV value)

remove

public boolean remove(Object key,
 Object value)

replace

public boolean replace(K key,
 ExternalV oldValue,
 ExternalV newValue)

replace

public ExternalV replace(K key,
 ExternalV value)

computeIfAbsent

public ExternalV computeIfAbsent(K key,
 Function<? super K,? extends ExternalV> mappingFunction)

computeIfPresent

public ExternalV computeIfPresent(K key,
 BiFunction<? super K,? super ExternalV,? extends ExternalV> remappingFunction)

compute

public ExternalV compute(K key,
 BiFunction<? super K,? super ExternalV,? extends ExternalV> remappingFunction)

merge

public ExternalV merge(K key,
 ExternalV value,
 BiFunction<? super ExternalV,? super ExternalV,? extends ExternalV> remappingFunction)