org.apache.james.dnsservice.library.inetnetwork

Class InetNetworkBuilder

java.lang.Object

org.apache.james.dnsservice.library.inetnetwork.InetNetworkBuilder

public class InetNetworkBuilder
extends Object

Builds a InetNetwork (Inet4Network or Inet6Network) in function on the provided string pattern that represents a subnet.

Inet4Network is constructed based on the IPv4 subnet expressed in one of several formats:

     IPv4 Format                     Example
     Explicit address                127.0.0.1
     Address with a wildcard         127.0.0.*
     Domain name                     myHost.com
     Domain name + prefix-length     myHost.com/24
     Domain name + mask              myHost.com/255.255.255.0
     IP address + prefix-length      127.0.0.0/8
     IP + mask                       127.0.0.0/255.0.0.0
 

For more information on IP V4, see RFC 1518 and RFC 1519.

Inet6Network is constructed based on the IPv4 subnet expressed in one of several formats:

     IPv6 Format                     Example
     Explicit address                0000:0000:0000:0000:0000:0000:0000:0001
     IP address + subnet mask (/)   0000:0000:0000:0000:0000:0000:0000:0001/64
     IP address + subnet mask (%)   0000:0000:0000:0000:0000:0000:0000:0001%64
     The following V6 formats will be supported later:
     Domain name                     myHost.com
     Domain name + mask (/)          myHost.com/48
     Domain name + mask (%)          myHost.com%48
     Explicit shorted address        ::1
 

For more information on IP V6, see RFC 2460. (See also http://en.wikipedia.org/wiki/IPv6_address)

Constructor Summary

Constructors

Constructor and Description
InetNetworkBuilder(DNSService dnsServer) Constructs a InetNetwork.

Method Summary

Methods

Modifier and Type	Method and Description
InetNetwork	getFromString(String netspec) Creates a InetNetwork for the given String.
static boolean	isV6(String netspec) Returns true if the string parameters is a IPv6 pattern.

Methods inherited from class java.lang.Object

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

Constructor Detail

InetNetworkBuilder

public InetNetworkBuilder(DNSService dnsServer)

Constructs a InetNetwork.

Parameters:

dnsServer - the DNSService to use

Method Detail

getFromString

public InetNetwork getFromString(String netspec)
                          throws UnknownHostException

Creates a InetNetwork for the given String. Depending on the provided pattern and the platform configuration (IPv4 and/or IPv6), the returned type will be Inet4Network or Inet6Network.

Parameters:

netspec - the String which is will converted to InetNetwork

Returns:

network the InetNetwork

Throws:

UnknownHostException

isV6

public static boolean isV6(String netspec)

Returns true if the string parameters is a IPv6 pattern. Currently, only tests for presence of ':'.

Parameters:

netspec -

Returns:

boolean true if is a IPv6 pattern else false