MultiValueIntervalMap (ip-resource 1.4.7 API)

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

All Implemented Interfaces:: IntervalMap<K,V>

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

Constructor Summary

Constructors
Constructor and Description

MultiValueIntervalMap()

Constructors
Constructor and Description
`MultiValueIntervalMap()`

Method Summary

All 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.

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

- Constructor Detail
  - MultiValueIntervalMap
```
public MultiValueIntervalMap()
```
- Method Detail
  - 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
  - clear
```
public void clear()
```
    Specified by:
    
    clear in interface IntervalMap<K extends Interval<K>,V>
  - 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.
  - 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
  - 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
  - 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.

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

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

MultiValueIntervalMap

Method Detail

put

remove

remove

clear

findFirstLessSpecific

findExact

findExactOrFirstLessSpecific

findAllLessSpecific

findExactAndAllLessSpecific

findFirstMoreSpecific

findAllMoreSpecific

findExactAndAllMoreSpecific