dk.heick.properties.types.custom

Class IPRange

java.lang.Object

dk.heick.properties.types.custom.IPRange

public class IPRange
extends Object

Holds an IP4 range and validate if an IP adress is inside this valid range.
An IP4 address is build up of four segments divided by a dot.

segment1.segment2.segment3.segment4.
Each segment can have a value between 0 and 255, both included. But it can also be a range like 10-30.
Or a asterix * which translates to 0-255.

Since:

1.7

Author:

Frederik Heick

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	IPRange.IPToken

Field Summary

Fields

Modifier and Type	Field and Description
static IPRange	LOCALHOST Validates for Localhost "127.0.0.1".
static IPRange	NETWORK_10 Validates for the "10.*.*.*" network
static IPRange	NETWORK_192_168 Validates for the "192.168.*.*" network

Constructor Summary

Constructors

Constructor and Description
IPRange(int segment1, int segment2, int segment3, int segment4) Constructor of a single IP address.
IPRange(int segment1Start, int segment1end, int segment2Start, int segment2end, int segment3Start, int segment3end, int segment4Start, int segment4end) Constructor for an IP range.
IPRange(String ipRange) Parse a string to an ip range.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
String	getIpmask() Gets the ip mask.
protected IPRange.IPToken	getSegment1()
protected IPRange.IPToken	getSegment2()
protected IPRange.IPToken	getSegment3()
protected IPRange.IPToken	getSegment4()
boolean	isInsideIpRange(InetAddress ip) Evaluates if the an IP4 adress is inside the range.
boolean	isInsideIpRange(String ip) Validates a string to an IP4 adress and validates that is inside the defined range.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

LOCALHOST

public static IPRange LOCALHOST

Validates for Localhost "127.0.0.1".

NETWORK_192_168

public static IPRange NETWORK_192_168

Validates for the "192.168.*.*" network

NETWORK_10

public static IPRange NETWORK_10

Validates for the "10.*.*.*" network

Constructor Detail

IPRange

public IPRange(int segment1,
               int segment2,
               int segment3,
               int segment4)

Constructor of a single IP address.

Parameters:

segment1 - a value between 0 and 255 (both inclusive) "segment1.segment2.segment3.segment4"

segment2 - a value between 0 and 255 (both inclusive) "segment1.segment2.segment3.segment4"

segment3 - a value between 0 and 255 (both inclusive) "segment1.segment2.segment3.segment4"

segment4 - a value between 0 and 255 (both inclusive) "segment1.segment2.segment3.segment4"

IPRange

public IPRange(int segment1Start,
               int segment1end,
               int segment2Start,
               int segment2end,
               int segment3Start,
               int segment3end,
               int segment4Start,
               int segment4end)

Constructor for an IP range.

Parameters:

segment1Start - the start value for segment1 between 0 and 255 (both inclusive).

segment1end - the end value for segment1 between 0 and 255 (both inclusive).

segment2Start - the start value for segment2 between 0 and 255 (both inclusive).

segment2end - the end value for segment2 between 0 and 255 (both inclusive).

segment3Start - the start value for segment3 between 0 and 255 (both inclusive).

segment3end - the end value for segment3 between 0 and 255 (both inclusive).

segment4Start - the start value for segment4 between 0 and 255 (both inclusive).

segment4end - the end value for segment1 between 0 and 255 (both inclusive).

IPRange

public IPRange(String ipRange)
        throws PropertyException

Parse a string to an ip range.

Parameters:

ipRange - a string of four segments divide by dot. Where each segment is either a value between 0 and 255 (inclusive), or an asterix, or an range of two numbers divided by dash, where start value is lower or equal end value and the value is between 0 and 255 (inclusive).

Throws:

PropertyException - if the ipmask string did not parse.

Method Detail

getIpmask

public String getIpmask()

Gets the ip mask.

Returns:

the ip mask the defines the range.

isInsideIpRange

public boolean isInsideIpRange(String ip)
                        throws NullPointerException

Validates a string to an IP4 adress and validates that is inside the defined range.

Parameters:

ip - the ip address or hostname.

Returns:

true if the ip address is valid and is inside the range defined, otherwise false.

Throws:

NullPointerException - if the ip address is null.

isInsideIpRange

public boolean isInsideIpRange(InetAddress ip)
                        throws NullPointerException

Evaluates if the an IP4 adress is inside the range.

Parameters:

ip - the InetAddress.

Returns:

true if the ip address is inside the range defined, otherwise false.

Throws:

NullPointerException - if the ip is null.

getSegment1

protected IPRange.IPToken getSegment1()

getSegment2

protected IPRange.IPToken getSegment2()

getSegment3

protected IPRange.IPToken getSegment3()

getSegment4

protected IPRange.IPToken getSegment4()

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object