org.eclipse.collections.api.map.ImmutableMapIterable Maven / Gradle / Ivy
/*
* Copyright (c) 2021 Goldman Sachs and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* and Eclipse Distribution License v. 1.0 which accompany this distribution.
* The Eclipse Public License is available at http://www.eclipse.org/legal/epl-v10.html
* and the Eclipse Distribution License is available at
* http://www.eclipse.org/org/documents/edl-v10.php.
*/
package org.eclipse.collections.api.map;
import java.util.Map;
import org.eclipse.collections.api.bag.ImmutableBag;
import org.eclipse.collections.api.block.function.Function;
import org.eclipse.collections.api.block.function.Function0;
import org.eclipse.collections.api.block.function.Function2;
import org.eclipse.collections.api.block.predicate.Predicate;
import org.eclipse.collections.api.block.predicate.Predicate2;
import org.eclipse.collections.api.block.procedure.Procedure;
import org.eclipse.collections.api.block.procedure.Procedure2;
import org.eclipse.collections.api.collection.ImmutableCollection;
import org.eclipse.collections.api.factory.Maps;
import org.eclipse.collections.api.multimap.ImmutableMultimap;
import org.eclipse.collections.api.partition.PartitionImmutableCollection;
import org.eclipse.collections.api.tuple.Pair;
public interface ImmutableMapIterable extends MapIterable
{
Map castToMap();
ImmutableMapIterable newWithKeyValue(K key, V value);
ImmutableMapIterable newWithAllKeyValues(Iterable extends Pair extends K, ? extends V>> keyValues);
ImmutableMapIterable newWithMap(Map extends K, ? extends V> map);
ImmutableMapIterable newWithMapIterable(MapIterable extends K, ? extends V> mapIterable);
ImmutableMapIterable newWithAllKeyValueArguments(Pair extends K, ? extends V>... keyValuePairs);
ImmutableMapIterable newWithoutKey(K key);
ImmutableMapIterable newWithoutAllKeys(Iterable extends K> keys);
// TODO
// ImmutableSetIterable keySet();
@Override
ImmutableMapIterable tap(Procedure super V> procedure);
@Override
ImmutableMapIterable flipUniqueValues();
@Override
ImmutableMultimap flip();
@Override
ImmutableMapIterable select(Predicate2 super K, ? super V> predicate);
@Override
ImmutableMapIterable reject(Predicate2 super K, ? super V> predicate);
@Override
ImmutableMapIterable collect(Function2 super K, ? super V, Pair> function);
@Override
ImmutableMapIterable collectValues(Function2 super K, ? super V, ? extends R> function);
@Override
ImmutableCollection select(Predicate super V> predicate);
@Override
ImmutableCollection selectWith(Predicate2 super V, ? super P> predicate, P parameter);
@Override
ImmutableCollection reject(Predicate super V> predicate);
@Override
ImmutableCollection rejectWith(Predicate2 super V, ? super P> predicate, P parameter);
@Override
PartitionImmutableCollection partition(Predicate super V> predicate);
@Override
ImmutableCollection selectInstancesOf(Class clazz);
/**
* @since 9.0
*/
@Override
default ImmutableBag countBy(Function super V, ? extends V1> function)
{
return this.asLazy().collect(function).toBag().toImmutable();
}
/**
* @since 9.0
*/
@Override
default ImmutableBag countByWith(Function2 super V, ? super P, ? extends V1> function, P parameter)
{
return this.asLazy().collectWith(function, parameter).toBag().toImmutable();
}
/**
* @since 10.0.0
*/
@Override
default ImmutableBag countByEach(Function super V, ? extends Iterable> function)
{
return this.asLazy().flatCollect(function).toBag().toImmutable();
}
@Override
ImmutableMultimap groupBy(Function super V, ? extends V1> function);
@Override
ImmutableMultimap groupByEach(Function super V, ? extends Iterable> function);
@Override
ImmutableMapIterable groupByUniqueKey(Function super V, ? extends V1> function);
@Override
ImmutableCollection> zip(Iterable that);
@Override
ImmutableCollection> zipWithIndex();
@Override
default ImmutableMapIterable aggregateInPlaceBy(
Function super V, ? extends KK> groupBy,
Function0 extends VV> zeroValueFactory,
Procedure2 super VV, ? super V> mutatingAggregator)
{
MutableMap map = Maps.mutable.empty();
this.forEach(each ->
{
KK key = groupBy.valueOf(each);
VV value = map.getIfAbsentPut(key, zeroValueFactory);
mutatingAggregator.value(value, each);
});
return map.toImmutable();
}
@Override
default ImmutableMapIterable aggregateBy(
Function super V, ? extends KK> groupBy,
Function0 extends VV> zeroValueFactory,
Function2 super VV, ? super V, ? extends VV> nonMutatingAggregator)
{
MutableMap map = this.aggregateBy(
groupBy,
zeroValueFactory,
nonMutatingAggregator,
Maps.mutable.empty());
return map.toImmutable();
}
@Override
default ImmutableMapIterable aggregateBy(
Function super K, ? extends K1> keyFunction,
Function super V, ? extends V1> valueFunction,
Function0 extends V2> zeroValueFactory,
Function2 super V2, ? super V1, ? extends V2> nonMutatingAggregator)
{
MutableMap map = Maps.mutable.empty();
this.forEachKeyValue((key, value) -> map.updateValueWith(
keyFunction.valueOf(key),
zeroValueFactory,
nonMutatingAggregator,
valueFunction.valueOf(value)));
return map.toImmutable();
}
}