com.codepoetics.protonpack.maps

Interface MapStream<K,V>

All Superinterfaces:

java.lang.AutoCloseable, java.util.stream.BaseStream<java.util.Map.Entry<K,V>,java.util.stream.Stream<java.util.Map.Entry<K,V>>>, java.util.stream.Stream<java.util.Map.Entry<K,V>>

public interface MapStream<K,V>
extends java.util.stream.Stream<java.util.Map.Entry<K,V>>

A stream of Map.Entry<K, V>.

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.stream.Stream

java.util.stream.Stream.Builder<T>

Method Summary

Modifier and Type	Method and Description
default java.util.Map<K,V>	collect() Return a Map from the stream.
default java.util.Map<K,V>	collect(java.util.function.BinaryOperator<V> mergeFunction) Return a Map from the stream.
MapStream<K,V>	distinct()
MapStream<K,V>	filter(java.util.function.Predicate<? super java.util.Map.Entry<K,V>> predicate)
default MapStream<V,K>	inverseMapping() Return a MapStream from which the key and values are reversed.
MapStream<K,V>	limit(long n)
default <K1,V1> MapStream<K1,V1>	mapEntries(java.util.function.Function<? super K,? extends K1> keyMapper, java.util.function.Function<? super V,? extends V1> valueMapper) Applies the mapping for each keys and values in the map.
default <K1> MapStream<K1,V>	mapKeys(java.util.function.Function<? super K,? extends K1> mapper) Applies the mapping for each keys in the map.
default <V1> MapStream<K,V1>	mapValues(java.util.function.Function<? super V,? extends V1> mapper) Applies the mapping for each values in the map.
default MapStream<K,java.util.List<V>>	mergeKeys() Merge keys of the Stream into a new Stream
default MapStream<K,V>	mergeKeys(java.util.function.BinaryOperator<V> mergeFunction) Merge keys of the Stream into a new Stream with the merge function provided
static <K,V> MapStream<K,V>	of(K key, V value) Construct a MapStream<K, V> from a single key-value pair
static <K,V> MapStream<K,V>	of(K key, V value, K key1, V value1) Construct a MapStream<K, V> from a multiple key-value pairs
static <K,V> MapStream<K,V>	of(K key, V value, K key1, V value1, K key2, V value2) Construct a MapStream<K, V> from a multiple key-value pairs
static <K,V> MapStream<K,V>	of(K key, V value, K key1, V value1, K key2, V value2, K key3, V value3) Construct a MapStream<K, V> from a multiple key-value pairs
static <K,V> MapStream<K,V>	of(K key, V value, K key1, V value1, K key2, V value2, K key3, V value3, K key4, V value4) Construct a MapStream<K, V> from a multiple key-value pairs
static <K,V> MapStream<K,V>	of(java.util.Map<K,V> map) Construct a MapStream<K, V> from the map
static <K,V> MapStream<K,V>	ofMaps(java.util.Map<K,V>... maps) Construct a MapStream<K, V> from the map
MapStream<K,V>	onClose(java.lang.Runnable closeHandler)
MapStream<K,V>	parallel()
MapStream<K,V>	peek(java.util.function.Consumer<? super java.util.Map.Entry<K,V>> action)
MapStream<K,V>	sequential()
MapStream<K,V>	skip(long n)
MapStream<K,V>	sorted()
MapStream<K,V>	sorted(java.util.Comparator<? super java.util.Map.Entry<K,V>> comparator)
MapStream<K,V>	unordered()

Methods inherited from interface java.util.stream.Stream

allMatch, anyMatch, builder, collect, collect, concat, count, empty, findAny, findFirst, flatMap, flatMapToDouble, flatMapToInt, flatMapToLong, forEach, forEachOrdered, generate, iterate, map, mapToDouble, mapToInt, mapToLong, max, min, noneMatch, reduce, reduce, reduce, toArray, toArray

Methods inherited from interface java.util.stream.BaseStream

close, isParallel, iterator, spliterator

Method Detail

of

static <K,V> MapStream<K,V> of(java.util.Map<K,V> map)

Construct a MapStream<K, V> from the map

Specified by:

of in interface java.util.stream.Stream<java.util.Map.Entry<K,V>>

Type Parameters:

K - - the type of the map keys

V - - the type of the map values

Parameters:

map - - the map to build the stream from

Returns:

a new MapStream<K, V>

ofMaps

@SafeVarargs
static <K,V> MapStream<K,V> ofMaps(java.util.Map<K,V>... maps)

Construct a MapStream<K, V> from the map

Type Parameters:

K - - the type of the map keys

V - - the type of the map values

Parameters:

maps - - the map to build the stream from

Returns:

a new MapStream<K, V>

of

static <K,V> MapStream<K,V> of(K key,
                               V value)

Construct a MapStream<K, V> from a single key-value pair

Type Parameters:

K - - the type of the map keys

V - - the type of the map values

Parameters:

key - - the key

value - - the value

Returns:

a new MapStream<K, V>

of

static <K,V> MapStream<K,V> of(K key,
                               V value,
                               K key1,
                               V value1)

Construct a MapStream<K, V> from a multiple key-value pairs

Type Parameters:

K - - the type of the map keys

V - - the type of the map values

Parameters:

key - - key

value - - value

key1 - - key1

value1 - - value1

Returns:

a new MapStream<K, V>

of

static <K,V> MapStream<K,V> of(K key,
                               V value,
                               K key1,
                               V value1,
                               K key2,
                               V value2)

Construct a MapStream<K, V> from a multiple key-value pairs

Type Parameters:

K - - the type of the map keys

V - - the type of the map values

Parameters:

key - - key

value - - value

key1 - - key1

value1 - - value1

key2 - - key2

value2 - - value2

Returns:

a new MapStream<K, V>

of

static <K,V> MapStream<K,V> of(K key,
                               V value,
                               K key1,
                               V value1,
                               K key2,
                               V value2,
                               K key3,
                               V value3)

Construct a MapStream<K, V> from a multiple key-value pairs

Type Parameters:

K - - the type of the map keys

V - - the type of the map values

Parameters:

key - - key

value - - value

key1 - - key1

value1 - - value1

key2 - - key2

value2 - - value2

key3 - - key3

value3 - - value3

Returns:

a new MapStream<K, V>

of

static <K,V> MapStream<K,V> of(K key,
                               V value,
                               K key1,
                               V value1,
                               K key2,
                               V value2,
                               K key3,
                               V value3,
                               K key4,
                               V value4)

Construct a MapStream<K, V> from a multiple key-value pairs

Type Parameters:

K - - the type of the map keys

V - - the type of the map values

Parameters:

key - - key

value - - value

key1 - - key1

value1 - - value1

key2 - - key2

value2 - - value2

key3 - - key3

value3 - - value3

key4 - - key4

value4 - - value4

Returns:

a new MapStream<K, V>

mapKeys

default <K1> MapStream<K1,V> mapKeys(java.util.function.Function<? super K,? extends K1> mapper)

Applies the mapping for each keys in the map. If your mapping function is not bijective, make sure you call mergeKeys or that you provide a merge function when calling collect

Type Parameters:

K1 - the type to map the keys into

Parameters:

mapper - - the key mapping to be applied

Returns:

a new MapStream

mapValues

default <V1> MapStream<K,V1> mapValues(java.util.function.Function<? super V,? extends V1> mapper)

Applies the mapping for each values in the map.

Type Parameters:

V1 - the type to map the values into

Parameters:

mapper - - the value mapping to be applied

Returns:

a new MapStream

mapEntries

default <K1,V1> MapStream<K1,V1> mapEntries(java.util.function.Function<? super K,? extends K1> keyMapper,
                                            java.util.function.Function<? super V,? extends V1> valueMapper)

Applies the mapping for each keys and values in the map. If your mapping function is not bijective for the keys, make sure you call mergeKeys or that you provide a merge function when calling collect.

Type Parameters:

K1 - the type to map the keys into

V1 - the type to map the values into

Parameters:

keyMapper - - the key mapping to be applied

valueMapper - - the value mapping to be applied

Returns:

a new MapStream

mergeKeys

default MapStream<K,java.util.List<V>> mergeKeys()

Merge keys of the Stream into a new Stream

Returns:

a new MapStream

mergeKeys

default MapStream<K,V> mergeKeys(java.util.function.BinaryOperator<V> mergeFunction)

Merge keys of the Stream into a new Stream with the merge function provided

Parameters:

mergeFunction - The merge function to use

Returns:

a new MapStream

collect

default java.util.Map<K,V> collect()

Return a Map from the stream. If you have similar keys in the stream, don't forget to call mergeKeys() or collect (BinaryOperator<V> mergeFunction)

Returns:

a map

collect

default java.util.Map<K,V> collect(java.util.function.BinaryOperator<V> mergeFunction)

Return a Map from the stream. If there are similar keys in the stream, the merge function will be applied to merge the values of those keys

Parameters:

mergeFunction - the function to merge the values if the keys are not unique

Returns:

a map

inverseMapping

default MapStream<V,K> inverseMapping()

Return a MapStream from which the key and values are reversed.

Returns:

a new MapStream

limit

MapStream<K,V> limit(long n)

Specified by:

limit in interface java.util.stream.Stream<java.util.Map.Entry<K,V>>

skip

MapStream<K,V> skip(long n)

Specified by:

skip in interface java.util.stream.Stream<java.util.Map.Entry<K,V>>

sorted

MapStream<K,V> sorted()

Specified by:

sorted in interface java.util.stream.Stream<java.util.Map.Entry<K,V>>

sorted

MapStream<K,V> sorted(java.util.Comparator<? super java.util.Map.Entry<K,V>> comparator)

Specified by:

sorted in interface java.util.stream.Stream<java.util.Map.Entry<K,V>>

peek

MapStream<K,V> peek(java.util.function.Consumer<? super java.util.Map.Entry<K,V>> action)

Specified by:

peek in interface java.util.stream.Stream<java.util.Map.Entry<K,V>>

onClose

MapStream<K,V> onClose(java.lang.Runnable closeHandler)

Specified by:

onClose in interface java.util.stream.BaseStream<java.util.Map.Entry<K,V>,java.util.stream.Stream<java.util.Map.Entry<K,V>>>

filter

MapStream<K,V> filter(java.util.function.Predicate<? super java.util.Map.Entry<K,V>> predicate)

Specified by:

filter in interface java.util.stream.Stream<java.util.Map.Entry<K,V>>

parallel

MapStream<K,V> parallel()

Specified by:

parallel in interface java.util.stream.BaseStream<java.util.Map.Entry<K,V>,java.util.stream.Stream<java.util.Map.Entry<K,V>>>

sequential

MapStream<K,V> sequential()

Specified by:

sequential in interface java.util.stream.BaseStream<java.util.Map.Entry<K,V>,java.util.stream.Stream<java.util.Map.Entry<K,V>>>

unordered

MapStream<K,V> unordered()

Specified by:

unordered in interface java.util.stream.BaseStream<java.util.Map.Entry<K,V>,java.util.stream.Stream<java.util.Map.Entry<K,V>>>

distinct

MapStream<K,V> distinct()

Specified by:

distinct in interface java.util.stream.Stream<java.util.Map.Entry<K,V>>