com.h3c.util.ip

Class IpUtils

java.lang.Object

com.h3c.util.ip.IpUtils

public final class IpUtils
extends Object

Useful utility methods for manipulating IP addresses.

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	COUNT_GE_ONE Exception Message: count must be greater than 1

Method Summary

Methods

Modifier and Type	Method and Description
static List<IpAddress>	getRandomIps(IpRange range, int count) Returns a list of randomly generated IP addresses.
static List<IpAddress>	getRandomIps(String spec, int count) Returns a list of randomly generated IP addresses.
static IpAddress	getRepeatedByteIpAddressV4(int seed) Returns an IPv4 address where all the bytes are set to the specified seed value.
static IpAddress	getRepeatedByteIpAddressV6(int seed) Returns an IPv6 address where all the bytes are set to the specified seed value.

Methods inherited from class java.lang.Object

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

Field Detail

COUNT_GE_ONE

protected static final String COUNT_GE_ONE

Exception Message: count must be greater than 1

See Also:

Constant Field Values

Method Detail

getRepeatedByteIpAddressV4

public static IpAddress getRepeatedByteIpAddressV4(int seed)

Returns an IPv4 address where all the bytes are set to the specified seed value. For example:

 IpAddress ip = IpUtils.getRepeatedByteIpAddressV4(5);
 

will return the IP address 5.5.5.5

Parameters:

seed - the seed value

Returns:

the IPv4 address

Throws:

IllegalArgumentException - if seed is not in the range 0..255

getRepeatedByteIpAddressV6

public static IpAddress getRepeatedByteIpAddressV6(int seed)

Returns an IPv6 address where all the bytes are set to the specified seed value. For example:

 IpAddress ip = IpUtils.getRepeatedByteIpAddressV6(15);
 

will return the IP address F0F:F0F:F0F:F0F:F0F:F0F:F0F:F0F

Parameters:

seed - the seed value

Returns:

the IPv6 address

Throws:

IllegalArgumentException - if seed is not in the range 0..255

getRandomIps

public static List<IpAddress> getRandomIps(String spec,
                           int count)

Returns a list of randomly generated IP addresses. See IpRange for a definition of the range specification. Note that addresses may be repeated in the list.

Parameters:

spec - a string defining the set of IP addresses from which to draw the random samples

count - the number of IP addresses to return in the list

Returns:

a list of randomly generated IP addresses

Throws:

IllegalArgumentException - if count is less than 1 or if the spec is ill-formed

NullPointerException - if spec is null

getRandomIps

public static List<IpAddress> getRandomIps(IpRange range,
                           int count)

Returns a list of randomly generated IP addresses. Note that addresses may be repeated in the list.

Parameters:

range - an IP address range from which to draw the random samples

count - the number of IP addresses to return in the list

Returns:

a list of randomly generated IP addresses

Throws:

IllegalArgumentException - if count is less than 1