org.jppf.net
Class IPv6AddressPattern

java.lang.Object
  org.jppf.net.AbstractIPAddressPattern
      org.jppf.net.IPv6AddressPattern

public class IPv6AddressPattern
extends AbstractIPAddressPattern

Represents a pattern used for IPv6 addresses inclusion and exclusion lists.
A pattern represents a single value or a range of values for each component of an IPv6 address.

Examples:

• 1080:0:0:0:8:800:200C:417A represents a single IPv6 address
• 1080:0:0:0:8:800:200C represents all IPv6 addresses in the range 1080:0:0:0:8:800:200C:0 - 1080:0:0:0:8:800:200C:FFFF
• 1080:0:0:0:8:800 represents all IPv6 addresses in the range 1080:0:0:0:8:800:0:0 - 1080:0:0:0:8:800:FFFF:FFFF
• 1080:0:0:0:8:800:200C-20FF represents all IP addresses where the first component is equal to 1080, the second to 0, ..., the 7th component in the range 200C - 200FF, and the 8th in the range 0 - FFFF (equivalent to 1080:0:0:0:8:800:200C-20FF:0-FFFF)

Syntax rules:

1. An empty component is considered as a 0-FFFF range. Examples:

• :2:3:4:5:6:7:8 is equivalent to 0-FFFF:2:3:4:5:6:7:8
• 1:2:3:4:5::7:8 is equivalent to 1:2:3:4:5:0-FFFF:7:8
• 1:2:3:4:5:6:7: is equivalent to 1:2:3:4:5:6:7 and to 1:2:3:4:5:6:7:0-FFFF

2. Ranges with missing bounds but still including the "-" sign are interpreted as a range with the lower bound equal to zero for a missing lower bound, and an upper bound equal to 0xFFFF if the uper bound is missing. Examples:

• -128 is equivalent to 0-128
• 12- is equivalent to 12-FFFF
• - is equivalent to an empty value and to 0-FFFF

3. Valid values for range bounds and single values are positive integers in the range 0 ... 0xFFFF. A pattern containing any invalid value will be ignored.

4. A pattern describing more than 8 components or containing characters other than hexadecimal digits, '-', ':' or spaces will be ignored.

Author:

Laurent Cohen

Constructor Summary

IPv6AddressPattern(String source)
Initialize this object with the specified string pattern.

Method Summary

static void	main(String[] args) Main method.
boolean	matches(InetAddress ip) Determine whether the specified IP address matches this pattern.
String	toString()

Methods inherited from class org.jppf.net.AbstractIPAddressPattern

convertSource, matches, postProcess, preProcess

Methods inherited from class java.lang.Object

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

Constructor Detail

IPv6AddressPattern

public IPv6AddressPattern(String source)
                   throws IllegalArgumentException

Initialize this object with the specified string pattern.

Parameters:

source - the source pattern as a string.

Throws:

IllegalArgumentException - if the pattern is null or invalid.

Method Detail

matches

public boolean matches(InetAddress ip)

Determine whether the specified IP address matches this pattern. No check is made to verify that the IP address is valid.

Overrides:

matches in class AbstractIPAddressPattern

Parameters:

ip - the ip to match as a string.

Returns:

true if the address matches this pattern, false otherwise.

toString

public String toString()

Overrides:

toString in class AbstractIPAddressPattern

main

public static void main(String[] args)

Main method.

Parameters:

args - not used.