org.ifeth.sehr.core.lib

Class InetAddrValidation

java.lang.Object

org.ifeth.sehr.core.lib.InetAddrValidation

public class InetAddrValidation
extends java.lang.Object

Quickly tests whether a given IP address matches an IP range. An InetAddrValidation is initialized with a particular IP range specification. Calls to match method will then quickly determine whether a given IP falls within that range.

Supported range specifications are:

• Full IPv4 address, e.g. 12.34.56.78
• Full IPv6 address, e.g. 2001:18e8:3:171:218:8bff:fe2a:56a4
• Partial IPv4 address, e.g. 12.34 (which matches any IP starting 12.34)
• IPv4 network/netmask, e.g. 18.25.0.0/255.255.0.0
• IPv4 or IPv6 CIDR slash notation, e.g. 18.25.0.0/16, 2001:18e8:3:171::/64

Constructor Summary

Constructors

Constructor and Description
InetAddrValidation()
InetAddrValidation(java.lang.String ipSpec) Construct an InetAddrValidation that will test for the given IP specification
InetAddrValidation(java.lang.String lo, java.lang.String hi)

Method Summary

Modifier and Type	Method and Description
boolean	checkBlacklisted(java.lang.String ip, java.util.Scanner blacklist) Scan IP against a blacklist.
static boolean	checkConnection(java.lang.String ip, int port, int timeout) Check if given ip and port is available.
boolean	checkIP(java.lang.String ip)
boolean	checkPermission(java.lang.String ip, java.util.Scanner whitelist) Scan IP against a whitelist (if given IP is allowed).
static java.util.Set<java.lang.String>	getLocalAddresses()
long	ipToLong(java.net.InetAddress ip)
boolean	match(java.lang.String ipIn) Determine whether the given full IP falls within the range this InetAddrValidation was initialized with.

Methods inherited from class java.lang.Object

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

Constructor Detail

InetAddrValidation

public InetAddrValidation()

InetAddrValidation

public InetAddrValidation(java.lang.String ipSpec)
                   throws GenericSEHRException

Construct an InetAddrValidation that will test for the given IP specification

Parameters:

ipSpec - IP specification (full or partial address, network/netmask, network/cidr)

Throws:

GenericSEHRException - if there is an error parsing the specification (i.e. it is somehow malformed)

InetAddrValidation

public InetAddrValidation(java.lang.String lo,
                          java.lang.String hi)
                   throws java.net.UnknownHostException

Throws:

java.net.UnknownHostException

Method Detail

ipToLong

public long ipToLong(java.net.InetAddress ip)

checkIP

public boolean checkIP(java.lang.String ip)
                throws java.net.UnknownHostException

Throws:

java.net.UnknownHostException

getLocalAddresses

public static java.util.Set<java.lang.String> getLocalAddresses()
                                                         throws GenericSEHRException

Throws:

GenericSEHRException

checkPermission

public boolean checkPermission(java.lang.String ip,
                               java.util.Scanner whitelist)

Scan IP against a whitelist (if given IP is allowed).

whitelist can be a String, File, InputStream etc.
e.g. Scanner whitelist = new Scanner(new File "/etc/whitelist");

checkBlacklisted

public boolean checkBlacklisted(java.lang.String ip,
                                java.util.Scanner blacklist)

Scan IP against a blacklist.

whitelist can be a String, File, InputStream etc.
e.g. Scanner blacklist = new Scanner(new File "/etc/blacklist");

match

public boolean match(java.lang.String ipIn)
              throws GenericSEHRException

Determine whether the given full IP falls within the range this InetAddrValidation was initialized with.

Parameters:

ipIn - IP address as dot-delimited String

Returns:

true if the IP matches the range of this InetAddrValidation; false otherwise

Throws:

GenericSEHRException - if the IP passed in cannot be parsed correctly (i.e. is malformed)

checkConnection

public static boolean checkConnection(java.lang.String ip,
                                      int port,
                                      int timeout)

Check if given ip and port is available.

Parameters:

ip -

port -

timeout -

Returns:

true or false