Package org.apache.commons.net.util

Class SubnetUtils

java.lang.Object

org.apache.commons.net.util.SubnetUtils

public class SubnetUtils
extends java.lang.Object

A class that performs some subnet calculations given a network address and a subnet mask.

Since:

2.0

See Also:

"http://www.faqs.org/rfcs/rfc1519.html"

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	SubnetUtils.SubnetInfo	Convenience container for subnet summary information.

Field Summary

Fields

Modifier and Type	Field	Description
private int	address
private static java.util.regex.Pattern	addressPattern
private int	broadcast
private static java.util.regex.Pattern	cidrPattern
private boolean	inclusiveHostCount	Whether the broadcast/network address are included in host count
private static java.lang.String	IP_ADDRESS
private static int	NBITS
private int	netmask
private int	network
private static java.lang.String	SLASH_FORMAT

Constructor Summary

Constructors

Constructor	Description
SubnetUtils(java.lang.String cidrNotation)	Constructor that takes a CIDR-notation string, e.g.
SubnetUtils(java.lang.String address, java.lang.String mask)	Constructor that takes a dotted decimal address and a dotted decimal mask.

Method Summary

Modifier and Type	Method	Description
private void	calculate(java.lang.String mask)
private java.lang.String	format(int[] octets)
SubnetUtils.SubnetInfo	getInfo()	Return a SubnetUtils.SubnetInfo instance that contains subnet-specific statistics
boolean	isInclusiveHostCount()	Returns true if the return value of SubnetUtils.SubnetInfo.getAddressCount() includes the network and broadcast addresses.
private int	matchAddress(java.util.regex.Matcher matcher)
(package private) int	pop(int x)
private int	rangeCheck(int value, int begin, int end)
void	setInclusiveHostCount(boolean inclusiveHostCount)	Set to true if you want the return value of SubnetUtils.SubnetInfo.getAddressCount() to include the network and broadcast addresses.
private int[]	toArray(int val)
private java.lang.String	toCidrNotation(java.lang.String addr, java.lang.String mask)
private int	toInteger(java.lang.String address)

Methods inherited from class java.lang.Object

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

Field Detail

IP_ADDRESS

private static final java.lang.String IP_ADDRESS

See Also:

Constant Field Values

SLASH_FORMAT

private static final java.lang.String SLASH_FORMAT

See Also:

Constant Field Values

addressPattern

private static final java.util.regex.Pattern addressPattern

cidrPattern

private static final java.util.regex.Pattern cidrPattern

NBITS

private static final int NBITS

See Also:

Constant Field Values

netmask

private int netmask

address

private int address

network

private int network

broadcast

private int broadcast

inclusiveHostCount

private boolean inclusiveHostCount

Whether the broadcast/network address are included in host count

Constructor Detail

SubnetUtils

public SubnetUtils(java.lang.String cidrNotation)

Constructor that takes a CIDR-notation string, e.g. "192.168.0.1/16"

Parameters:

cidrNotation - A CIDR-notation string, e.g. "192.168.0.1/16"

Throws:

java.lang.IllegalArgumentException - if the parameter is invalid, i.e. does not match n.n.n.n/m where n=1-3 decimal digits, m = 1-3 decimal digits in range 1-32

SubnetUtils

public SubnetUtils(java.lang.String address,
                   java.lang.String mask)

Constructor that takes a dotted decimal address and a dotted decimal mask.

Parameters:

address - An IP address, e.g. "192.168.0.1"

mask - A dotted decimal netmask e.g. "255.255.0.0"

Throws:

java.lang.IllegalArgumentException - if the address or mask is invalid, i.e. does not match n.n.n.n where n=1-3 decimal digits and the mask is not all zeros

Method Detail

isInclusiveHostCount

public boolean isInclusiveHostCount()

Returns true if the return value of SubnetUtils.SubnetInfo.getAddressCount() includes the network and broadcast addresses.

Returns:

true if the hostcount includes the network and broadcast addresses

Since:

2.2

setInclusiveHostCount

public void setInclusiveHostCount(boolean inclusiveHostCount)

Set to true if you want the return value of SubnetUtils.SubnetInfo.getAddressCount() to include the network and broadcast addresses.

Parameters:

inclusiveHostCount - true if network and broadcast addresses are to be included

Since:

2.2

getInfo

public final SubnetUtils.SubnetInfo getInfo()

Return a SubnetUtils.SubnetInfo instance that contains subnet-specific statistics

Returns:

new instance

calculate

private void calculate(java.lang.String mask)

toInteger

private int toInteger(java.lang.String address)

matchAddress

private int matchAddress(java.util.regex.Matcher matcher)

toArray

private int[] toArray(int val)

format

private java.lang.String format(int[] octets)

rangeCheck

private int rangeCheck(int value,
                       int begin,
                       int end)

pop

int pop(int x)

toCidrNotation

private java.lang.String toCidrNotation(java.lang.String addr,
                                        java.lang.String mask)