SynchronizedIntervalMap (ip-resource 1.4.7 API)

java.lang.Object
- com.bol.ipresource.etree.SynchronizedIntervalMap<K,V>

All Implemented Interfaces:: IntervalMap<K,V>

public final class SynchronizedIntervalMap<K extends Interval<K>,V>
extends Object
implements IntervalMap<K,V>

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`clear()`
`List<V>`	`findAllLessSpecific(K key)` Finds all values that are associated to intervals that contain `key` but are not equal to `key`.
`List<V>`	`findAllMoreSpecific(K key)` Finds all values associated with intervals that are contained within (more specific than) `key`, but not equal to `key`.
`List<V>`	`findExact(K key)` Finds the value associated with `key`, if it exists.
`List<V>`	`findExactAndAllLessSpecific(K key)` Finds all values that are associated to intervals that contain `key`.
`List<V>`	`findExactAndAllMoreSpecific(K key)` Finds all values associated with intervals that are equal to `key` or contained within (more specific than) `key`.
`List<V>`	`findExactOrFirstLessSpecific(K key)` Finds the value associated with `key`, or its closest enclosing if `key` is not contained in this map, if it exists.
`List<V>`	`findFirstLessSpecific(K key)` Finds the value associated with closest interval that contains `key` but is not equal to `key`.
`List<V>`	`findFirstMoreSpecific(K key)` Finds all values associated with intervals that are more specific (contained in) `key`, but excluding the values that are nested inside the matching intervals.
`V`	`put(K key, V value)` Associates the specified value with the specified key in this map If the map previously contained a mapping for the key, the old value is replaced by the specified value.
`V`	`remove(K key)` Removes the mapping for a key from this map if it is present.
`void`	`remove(K key, V value)` Removes the mapping for a key and value from this map if both are present.
`static <K extends Interval<K>,V> IntervalMap<K,V>`	`synchronizedMap(IntervalMap<K,V> toWrap)`
`static <K extends Interval<K>,V> IntervalMap<K,V>`	`synchronizedMap(IntervalMap<K,V> toWrap, Object mutex)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - synchronizedMap
```
public static <K extends Interval<K>,V> IntervalMap<K,V> synchronizedMap(IntervalMap<K,V> toWrap)
```
  - synchronizedMap
```
public static <K extends Interval<K>,V> IntervalMap<K,V> synchronizedMap(IntervalMap<K,V> toWrap,
                                                                         Object mutex)
```
  - put
```
public V put(K key,
             V value)
```
    Description copied from interface: IntervalMap
    
    Associates the specified value with the specified key in this map If the map previously contained a mapping for the key, the old value is replaced by the specified value.
    
    Specified by:
    
    put in interface IntervalMap<K extends Interval<K>,V>
    
    Parameters:
    
    key - key with which the specified value is to be associated
    
    value - value to be associated with the specified key
    
    Returns:
    
    the replaced value, if applies. null otherwise.
  - remove
```
public V remove(K key)
```
    Description copied from interface: IntervalMap
    
    Removes the mapping for a key from this map if it is present.
    
    The map will not contain a mapping for the specified key once the call returns.
    
    Specified by:
    
    remove in interface IntervalMap<K extends Interval<K>,V>
    
    Parameters:
    
    key - key whose mapping is to be removed from the map
    
    Returns:
    
    the value of the removed key
  - remove
```
public void remove(K key,
                   V value)
```
    Description copied from interface: IntervalMap
    
    Removes the mapping for a key and value from this map if both are present.
    
    The map will not contain a mapping for the specified key with the specified value once the call returns.
    
    Specified by:
    
    remove in interface IntervalMap<K extends Interval<K>,V>
    
    Parameters:
    
    key - key whose mapping is to be removed from the map
    
    value - value with the key to be removed from the map
  - findFirstLessSpecific
```
public List<V> findFirstLessSpecific(K key)
```
    Description copied from interface: IntervalMap
    
    Finds the value associated with closest interval that contains key but is not equal to key.
    
    Specified by:
    
    findFirstLessSpecific in interface IntervalMap<K extends Interval<K>,V>
    
    Parameters:
    
    key - the key to find the closest enclosing interval for
    
    Returns:
    
    the value associated with the closest enclosing interval of key, or an empty list if no such mapping exists.
  - findAllLessSpecific
```
public List<V> findAllLessSpecific(K key)
```
    Description copied from interface: IntervalMap
    
    Finds all values that are associated to intervals that contain key but are not equal to key.
    
    The resulting values are ordered from least specific interval to most specific interval.
    
    Specified by:
    
    findAllLessSpecific in interface IntervalMap<K extends Interval<K>,V>
    
    Parameters:
    
    key - the key to find all containing intervals for
    
    Returns:
    
    the (possibly empty) list of values that are associated to intervals that contain key but is not equal to key.
  - findExactAndAllLessSpecific
```
public List<V> findExactAndAllLessSpecific(K key)
```
    Description copied from interface: IntervalMap
    
    Finds all values that are associated to intervals that contain key.
    
    The resulting values are ordered from least specific interval to most specific interval. So if a mapping for key exists the last element of the returned list will contain the value associated with key.
    
    Specified by:
    
    findExactAndAllLessSpecific in interface IntervalMap<K extends Interval<K>,V>
    
    Parameters:
    
    key - the key to find all containing intervals for
    
    Returns:
    
    the (possibly empty) list of values that are associated to intervals that contain key
  - findExact
```
public List<V> findExact(K key)
```
    Description copied from interface: IntervalMap
    
    Finds the value associated with key, if it exists.
    
    Specified by:
    
    findExact in interface IntervalMap<K extends Interval<K>,V>
    
    Parameters:
    
    key - the key to find the mapping for
    
    Returns:
    
    the value associated with key or an empty list if no such value exists
  - findExactOrFirstLessSpecific
```
public List<V> findExactOrFirstLessSpecific(K key)
```
    Description copied from interface: IntervalMap
    
    Finds the value associated with key, or its closest enclosing if key is not contained in this map, if it exists.
    
    Specified by:
    
    findExactOrFirstLessSpecific in interface IntervalMap<K extends Interval<K>,V>
    
    Parameters:
    
    key - the key to find the mapping for
    
    Returns:
    
    the value associated with key or its closest containing interval, or an empty list if no such value exists
  - findFirstMoreSpecific
```
public List<V> findFirstMoreSpecific(K key)
```
    Description copied from interface: IntervalMap
    
    Finds all values associated with intervals that are more specific (contained in) key, but excluding the values that are nested inside the matching intervals.
    
    The resulting values are ordered from least specific interval to most specific interval.
    
    Specified by:
    
    findFirstMoreSpecific in interface IntervalMap<K extends Interval<K>,V>
    
    Parameters:
    
    key - the key to find the first level more specific values for
    
    Returns:
    
    the (possibly empty) list of values associated with the matching intervals.
  - findAllMoreSpecific
```
public List<V> findAllMoreSpecific(K key)
```
    Description copied from interface: IntervalMap
    
    Finds all values associated with intervals that are contained within (more specific than) key, but not equal to key.
    
    The resulting values are ordered from least specific interval to most specific interval.
    
    Specified by:
    
    findAllMoreSpecific in interface IntervalMap<K extends Interval<K>,V>
    
    Parameters:
    
    key - the key to find all levels more specific values for
    
    Returns:
    
    the (possibly empty) list of values associated with the matching intervals.
  - findExactAndAllMoreSpecific
```
public List<V> findExactAndAllMoreSpecific(K key)
```
    Description copied from interface: IntervalMap
    
    Finds all values associated with intervals that are equal to key or contained within (more specific than) key.
    
    The resulting values are ordered from least specific interval to most specific interval. So if a mapping for key exists the first element of the returned list will contain the value associated with key.
    
    Specified by:
    
    findExactAndAllMoreSpecific in interface IntervalMap<K extends Interval<K>,V>
    
    Parameters:
    
    key - the key to find the exact and all levels more specific values for
    
    Returns:
    
    the (possibly empty) list of values associated with the matching intervals.
  - clear
```
public void clear()
```
    Specified by:
    
    clear in interface IntervalMap<K extends Interval<K>,V>

Class SynchronizedIntervalMap<K extends Interval<K>,V>

Method Summary

Methods inherited from class java.lang.Object

Method Detail

synchronizedMap

synchronizedMap

put

remove

remove

findFirstLessSpecific

findAllLessSpecific

findExactAndAllLessSpecific

findExact

findExactOrFirstLessSpecific

findFirstMoreSpecific

findAllMoreSpecific

findExactAndAllMoreSpecific

clear