IpTree (ip-resource 1.4.7 API)

java.lang.Object
- com.bol.ipresource.ip.IpTree<V>

All Implemented Interfaces:

IntervalMap<IpInterval<?>,V>
```
public class IpTree<V>
extends Object
implements IntervalMap<IpInterval<?>,V>
```
Handy tiny little wrapper around NestedIntervalMap to allow for a protocol-independent tree. Tests are omitted as this merely acts as a logic-less wrapper.

Field Summary

Fields
Modifier and Type Field and Description

protected NestedIntervalMap<Ipv4Interval,V> ipv4Tree

protected NestedIntervalMap<Ipv6Interval,V> ipv6Tree

Fields
Modifier and Type	Field and Description
`protected NestedIntervalMap<Ipv4Interval,V>`	`ipv4Tree`
`protected NestedIntervalMap<Ipv6Interval,V>`	`ipv6Tree`

Constructor Summary

Constructors
Constructor and Description

IpTree()

Constructors
Constructor and Description
`IpTree()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`clear()`
`List<V>`	`findAllLessSpecific(IpInterval<?> key)` Finds all values that are associated to intervals that contain `key` but are not equal to `key`.
`List<V>`	`findAllMoreSpecific(IpInterval<?> key)` Finds all values associated with intervals that are contained within (more specific than) `key`, but not equal to `key`.
`List<V>`	`findExact(IpInterval<?> key)` Finds the value associated with `key`, if it exists.
`List<V>`	`findExactAndAllLessSpecific(IpInterval<?> key)` Finds all values that are associated to intervals that contain `key`.
`List<V>`	`findExactAndAllMoreSpecific(IpInterval<?> key)` Finds all values associated with intervals that are equal to `key` or contained within (more specific than) `key`.
`List<V>`	`findExactOrFirstLessSpecific(IpInterval<?> 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(IpInterval<?> key)` Finds the value associated with closest interval that contains `key` but is not equal to `key`.
`List<V>`	`findFirstMoreSpecific(IpInterval<?> 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(IpInterval<?> 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(IpInterval<?> key)` Removes the mapping for a key from this map if it is present.
`void`	`remove(IpInterval<?> key, V value)` Removes the mapping for a key and value from this map if both are present.
`String`	`toString()`

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

- Field Detail
  - ipv4Tree
```
protected NestedIntervalMap<Ipv4Interval,V> ipv4Tree
```
  - ipv6Tree
```
protected NestedIntervalMap<Ipv6Interval,V> ipv6Tree
```
- Constructor Detail
  - IpTree
```
public IpTree()
```
- Method Detail
  - put
```
public V put(IpInterval<?> 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<IpInterval<?>,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(IpInterval<?> 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<IpInterval<?>,V>
    
    Parameters:
    
    key - key whose mapping is to be removed from the map
    
    Returns:
    
    the value of the removed key
  - remove
```
public void remove(IpInterval<?> 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<IpInterval<?>,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<IpInterval<?>,V>
  - findFirstLessSpecific
```
public List<V> findFirstLessSpecific(IpInterval<?> 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<IpInterval<?>,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(IpInterval<?> key)
```
    Description copied from interface: IntervalMap
    
    Finds the value associated with key, if it exists.
    
    Specified by:
    
    findExact in interface IntervalMap<IpInterval<?>,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(IpInterval<?> 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<IpInterval<?>,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(IpInterval<?> 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<IpInterval<?>,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(IpInterval<?> 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<IpInterval<?>,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(IpInterval<?> 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<IpInterval<?>,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(IpInterval<?> 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<IpInterval<?>,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(IpInterval<?> 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<IpInterval<?>,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.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class IpTree<V>

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ipv4Tree

ipv6Tree

Constructor Detail

IpTree

Method Detail

put

remove

remove

clear

findFirstLessSpecific

findExact

findExactOrFirstLessSpecific

findAllLessSpecific

findExactAndAllLessSpecific

findFirstMoreSpecific

findAllMoreSpecific

findExactAndAllMoreSpecific

toString