sirius.web.http

Class IPRange

java.lang.Object

sirius.web.http.IPRange

public class IPRange
extends Object

Represents a range of IP addresses in CIDR notation.

Valid inputs are x.x.x.x/bits or z:z:z:z:z:z:z:z/bits. If /bits is missing, /32 vor IPv4 or /128 for IPv6 is assumed.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	IPRange.RangeSet Represents a set of IP ranges.

Field Summary

Fields

Modifier and Type	Field and Description
static IPRange	IPV4_LOCALHOST Represents the IP address of the localhost in an IPv4 environment
static IPRange	IPV6_LOCALHOST Represents the IP address of the localhost in an IPv6 environment
static IPRange.RangeSet	LOCALHOST Constant for a range which only accepts localhost.
static IPRange.RangeSet	NO_FILTER Constant for a "non filtering" range set which accepts all IP addresses

Constructor Summary

Constructors

Constructor and Description
IPRange()

Method Summary

Modifier and Type	Method and Description
boolean	matches(InetAddress address) Checks if the given IP is within the described ip range.
static IPRange.RangeSet	paraseRangeSet(String commaSeparatedListOfRanges) Compiles the given list of ranges into a range set.
static IPRange	parseRange(String cidr) Parses a CIDR expression and returns an IPRange
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

NO_FILTER

public static final IPRange.RangeSet NO_FILTER

Constant for a "non filtering" range set which accepts all IP addresses

LOCALHOST

public static final IPRange.RangeSet LOCALHOST

Constant for a range which only accepts localhost.

IPV4_LOCALHOST

public static final IPRange IPV4_LOCALHOST

Represents the IP address of the localhost in an IPv4 environment

IPV6_LOCALHOST

public static final IPRange IPV6_LOCALHOST

Represents the IP address of the localhost in an IPv6 environment

Constructor Detail

IPRange

public IPRange()

Method Detail

parseRange

public static IPRange parseRange(String cidr)

Parses a CIDR expression and returns an IPRange

Parameters:

cidr - the CIDR expression to parse. This can be either an IP address like 192.168.1.4 or a subnet like 192.168.192.0/24 or empty which implies 0.0.0.0/0

Returns:

an IPRange representing the given cidr expression.

Throws:

IllegalArgumentException - in case of an invalid expression

matches

public boolean matches(InetAddress address)

Checks if the given IP is within the described ip range.

Parameters:

address - the address to check

Returns:

true if the given address is in the described IP range, false otherwise

paraseRangeSet

public static IPRange.RangeSet paraseRangeSet(String commaSeparatedListOfRanges)

Compiles the given list of ranges into a range set.

Parameters:

commaSeparatedListOfRanges - a string defining a list of ip ranges separated by a ",". Each ip range can be an address or a sub net in CIDR notation.

Returns:

a RangeSet representing the given input. If the input was empty, a "no filter" set is returned, which accepts all IPs.

toString

public String toString()

Overrides:

toString in class Object