public class

PredicatedSortedMap

extends PredicatedMap
implements SortedMap<K, V>
java.lang.Object
   ↳ org.apache.commons.collections.map.AbstractMapDecorator
     ↳ org.apache.commons.collections.map.PredicatedMap
       ↳ org.apache.commons.collections.map.PredicatedSortedMap

Class Overview

Decorates another SortedMap to validate that additions match a specified predicate.

This map exists to provide validation for the decorated map. It is normally created to decorate an empty map. If an object cannot be added to the map, an IllegalArgumentException is thrown.

One usage would be to ensure that no null keys are added to the map.

SortedMap map = PredicatedSortedSet.decorate(new TreeMap(), NotNullPredicate.INSTANCE, null);

Note that PredicatedSortedMap is not synchronized and is not thread-safe. If you wish to use this map from multiple threads concurrently, you must use appropriate synchronization. The simplest approach is to wrap this map using synchronizedSortedMap(SortedMap). This class may throw exceptions when accessed by concurrent threads without synchronization.

This class is Serializable from Commons Collections 3.1.

Summary

[Expand]
Inherited Fields
From class org.apache.commons.collections.map.PredicatedMap
From class org.apache.commons.collections.map.AbstractMapDecorator
Protected Constructors
PredicatedSortedMap(SortedMap map, Predicate keyPredicate, Predicate valuePredicate)
Constructor that wraps (not copies).
Public Methods
Comparator comparator()
static SortedMap decorate(SortedMap map, Predicate keyPredicate, Predicate valuePredicate)
Factory method to create a predicated (validating) sorted map.
Object firstKey()
SortedMap headMap(Object toKey)
Object lastKey()
SortedMap subMap(Object fromKey, Object toKey)
SortedMap tailMap(Object fromKey)
Protected Methods
SortedMap getSortedMap()
Gets the map being decorated.
[Expand]
Inherited Methods
From class org.apache.commons.collections.map.PredicatedMap
From class org.apache.commons.collections.map.AbstractMapDecorator
From class java.lang.Object
From interface java.util.Map
From interface java.util.SortedMap

Protected Constructors

protected PredicatedSortedMap (SortedMap map, Predicate keyPredicate, Predicate valuePredicate)

Constructor that wraps (not copies).

Parameters
map the map to decorate, must not be null
keyPredicate the predicate to validate the keys, null means no check
valuePredicate the predicate to validate to values, null means no check
Throws
IllegalArgumentException if the map is null

Public Methods

public Comparator comparator ()

public static SortedMap decorate (SortedMap map, Predicate keyPredicate, Predicate valuePredicate)

Factory method to create a predicated (validating) sorted map.

If there are any elements already in the list being decorated, they are validated.

Parameters
map the map to decorate, must not be null
keyPredicate the predicate to validate the keys, null means no check
valuePredicate the predicate to validate to values, null means no check
Throws
IllegalArgumentException if the map is null

public Object firstKey ()

public SortedMap headMap (Object toKey)

public Object lastKey ()

public SortedMap subMap (Object fromKey, Object toKey)

public SortedMap tailMap (Object fromKey)

Protected Methods

protected SortedMap getSortedMap ()

Gets the map being decorated.

Returns
  • the decorated map