freenet.io

Class Inet4AddressMatcher

java.lang.Object

freenet.io.Inet4AddressMatcher

All Implemented Interfaces:

AddressMatcher

public class Inet4AddressMatcher
extends java.lang.Object
implements AddressMatcher

Matcher for IPv4 network addresses. It works like the regex matcher in Matcher, i.e. you create a new Inet4AddressMatcher with the IP address pattern and can then match IP addresses to it. The Inet4AddressMatcher can match the following kinds of IP addresses or address ranges:

• IP address only (192.168.1.2)
• IP address and network mask (192.168.1.2/255.255.255.0)
• IP address and network mask bits (192.168.1.2/24)

Constructor Summary

Constructors

Constructor and Description
Inet4AddressMatcher(java.lang.String cidrHostname) Creates a new address matcher that matches InetAddress objects to the address specification given by cidrHostname.

Method Summary

Modifier and Type	Method and Description
static int	convertToBytes(java.lang.String address) Converts a dotted IP address (a.b.c.d) to a 32-bit value.
java.lang.String	getHumanRepresentation() Get the human-readable version of the Matcher
boolean	matches(java.net.InetAddress inetAddress) Checks whether the given address matches this matcher's address.
static boolean	matches(java.lang.String cidrHostname, java.net.InetAddress address) Shortcut method for creating a new Inet4AddressMatcher and matching address to it.

Methods inherited from class java.lang.Object

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

Constructor Detail

Inet4AddressMatcher

public Inet4AddressMatcher(java.lang.String cidrHostname)

Creates a new address matcher that matches InetAddress objects to the address specification given by cidrHostname.

Parameters:

cidrHostname - The address range this matcher matches

Method Detail

convertToBytes

public static int convertToBytes(java.lang.String address)

Converts a dotted IP address (a.b.c.d) to a 32-bit value. The first octet will be in bits 24 to 31, the second in bits 16 to 23, the third in bits 8 to 15, and the fourth in bits 0 to 7.

Parameters:

address - The address to convert

Returns:

The IP address as 32-bit value

Throws:

java.lang.NumberFormatException - if a part of the string can not be parsed using Integer.parseInt(java.lang.String)

java.util.NoSuchElementException - if address contains less than 3 dots

matches

public boolean matches(java.net.InetAddress inetAddress)

Checks whether the given address matches this matcher's address.

Specified by:

matches in interface AddressMatcher

Parameters:

inetAddress - The address to match to this matcher

Returns:

true if inetAddress matches the specification of this matcher, false otherwise

matches

public static boolean matches(java.lang.String cidrHostname,
                              java.net.InetAddress address)

Shortcut method for creating a new Inet4AddressMatcher and matching address to it.

Parameters:

cidrHostname - The host specification to match

address - The address to match

Returns:

true if address matches the specification in cidrHostname, false otherwise

See Also:

Inet4AddressMatcher(String), matches(InetAddress)

getHumanRepresentation

public java.lang.String getHumanRepresentation()

Description copied from interface: AddressMatcher

Get the human-readable version of the Matcher

Specified by:

getHumanRepresentation in interface AddressMatcher