org.dhcp4java

Class InetCidr

java.lang.Object

org.dhcp4java.InetCidr

All Implemented Interfaces:

Serializable, Comparable<InetCidr>

public class InetCidr
extends Object
implements Serializable, Comparable<InetCidr>

Version:

1.00

Author:

Stephan Hadinger

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
InetCidr(InetAddress addr, InetAddress netMask) Constructs a InetCidr provided an ip address and an ip mask.
InetCidr(InetAddress addr, int mask) Constructor for InetCidr.

Method Summary

Modifier and Type	Method and Description
static InetCidr[]	addr2Cidr(InetAddress addr) Returns an array of all cidr combinations with the provided ip address.
static void	checkNoOverlap(List<InetCidr> list) Checks whether the list does not contain any overlapping cidr(s).
int	compareTo(InetCidr rhs) Compare two InetCidr by its addr as main criterion, mask as second.
boolean	equals(Object o)
static InetCidr	fromLong(long l) Creates a new InetCidr from its long representation.
InetAddress	getAddr()
long	getAddrLong()
int	getMask()
int	hashCode()
static boolean	isSorted(List<InetCidr> list) Checks whether a list of InetCidr is strictly sorted (no 2 equal objects).
long	toLong() Returns a long representation of Cidr.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

InetCidr

public InetCidr(InetAddress addr,
                int mask)

Constructor for InetCidr.

Takes a network address (IPv4) and a mask length

Parameters:

addr - IPv4 address

mask - mask length (between 1 and 32)

Throws:

NullPointerException - if addr is null

IllegalArgumentException - if addr is not IPv4

InetCidr

public InetCidr(InetAddress addr,
                InetAddress netMask)

Constructs a InetCidr provided an ip address and an ip mask.

If the mask is not valid, an exception is raised.

Parameters:

addr - the ip address (IPv4)

netMask - the ip mask

Throws:

IllegalArgumentException - if addr or netMask is null.

IllegalArgumentException - if the netMask is not a valid one.

Method Detail

toString

public String toString()

Overrides:

toString in class Object

getAddr

public InetAddress getAddr()

Returns:

Returns the addr.

getAddrLong

public long getAddrLong()

Returns:

Returns the addr as a long.

getMask

public int getMask()

Returns:

Returns the mask.

toLong

public final long toLong()

Returns a long representation of Cidr.

The high 32 bits contain the mask, the low 32 bits the network address.

Returns:

the long representation of the Cidr

fromLong

public static final InetCidr fromLong(long l)

Creates a new InetCidr from its long representation.

Parameters:

l - the Cidr in its "long" format

Returns:

the object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

addr2Cidr

public static InetCidr[] addr2Cidr(InetAddress addr)

Returns an array of all cidr combinations with the provided ip address.

The array is ordered from the most specific to the most general mask.

Parameters:

addr - address

Returns:

array of all cidr possible with this address

compareTo

public int compareTo(InetCidr rhs)

Compare two InetCidr by its addr as main criterion, mask as second.

Note: this class has a natural ordering that is inconsistent with equals.

Specified by:

compareTo in interface Comparable<InetCidr>

Parameters:

rhs - object to compare to

Returns:

a negative integer, zero, or a positive integer as this object is less than, equal to, or greater than the specified object.

isSorted

public static boolean isSorted(List<InetCidr> list)

Checks whether a list of InetCidr is strictly sorted (no 2 equal objects).

Parameters:

list - list of potentially sorted InetCidr

Returns:

true if list is sorted or null

Throws:

NullPointerException - if one or more elements of the list are null

checkNoOverlap

public static void checkNoOverlap(List<InetCidr> list)

Checks whether the list does not contain any overlapping cidr(s).

Pre-requisite: list must be already sorted.

Parameters:

list - sorted list of InetCidr

Throws:

NullPointerException - if a list element is null

IllegalStateException - if overlapping cidr are detected