com.google.common.collect

Class MapConstraints

java.lang.Object

com.google.common.collect.MapConstraints

Deprecated.

Use Preconditions for basic checks. In place of constrained maps, we encourage you to check your preconditions explicitly instead of leaving that work to the map implementation. For the specific case of rejecting null, consider ImmutableMap. This class is scheduled for removal in Guava 21.0.

@Beta
 @GwtCompatible
 @Deprecated
public final class MapConstraints
extends Object

Factory and utilities pertaining to the MapConstraint interface.

Since:

3.0

Author:

Mike Bostock

See Also:

Constraints

Method Summary

Modifier and Type	Method and Description
static <K,V> ListMultimap<K,V>	constrainedListMultimap(ListMultimap<K,V> multimap, MapConstraint<? super K,? super V> constraint) Deprecated. Returns a constrained view of the specified list multimap, using the specified constraint.
static <K,V> Map<K,V>	constrainedMap(Map<K,V> map, MapConstraint<? super K,? super V> constraint) Deprecated. Returns a constrained view of the specified map, using the specified constraint.

Methods inherited from class java.lang.Object

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

Method Detail

constrainedMap

public static <K,V> Map<K,V> constrainedMap(Map<K,V> map,
                                            MapConstraint<? super K,? super V> constraint)

Deprecated.

Returns a constrained view of the specified map, using the specified constraint. Any operations that add new mappings will call the provided constraint. However, this method does not verify that existing mappings satisfy the constraint.

The returned map is not serializable.

Parameters:

map - the map to constrain

constraint - the constraint that validates added entries

Returns:

a constrained view of the specified map

constrainedListMultimap

public static <K,V> ListMultimap<K,V> constrainedListMultimap(ListMultimap<K,V> multimap,
                                                              MapConstraint<? super K,? super V> constraint)

Deprecated.

Returns a constrained view of the specified list multimap, using the specified constraint. Any operations that add new mappings will call the provided constraint. However, this method does not verify that existing mappings satisfy the constraint.

Note that the generated multimap's Multimap.removeAll(java.lang.Object) and Multimap.replaceValues(K, java.lang.Iterable<? extends V>) methods return collections that are not constrained.

The returned multimap is not serializable.

Parameters:

multimap - the multimap to constrain

constraint - the constraint that validates added entries

Returns:

a constrained view of the specified multimap