org.opendaylight.mdsal.model.ietf.util

Class AbstractIetfInetUtil<A4,P4,A6,P6,A,P>

java.lang.Object

org.opendaylight.mdsal.model.ietf.util.AbstractIetfInetUtil<A4,P4,A6,P6,A,P>

Direct Known Subclasses:

IetfInetUtil, IetfInetUtil

@Beta
public abstract class AbstractIetfInetUtil<A4,P4,A6,P6,A,P>
extends Object

A set of utility methods to efficiently instantiate various ietf-inet-types DTOs.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractIetfInetUtil(Class<A4> addr4Class, Class<P4> prefix4Class, Class<A6> addr6Class, Class<P6> prefix6Class)

Method Summary

Modifier and Type	Method and Description
Inet4Address	inet4AddressFor(A4 addr)
Inet6Address	inet6AddressFor(A6 addr)
InetAddress	inetAddressFor(A addr)
A	ipAddressFor(byte[] bytes) Create an IpAddress by interpreting input bytes as an IPv4 or IPv6 address, based on array length.
A	ipAddressFor(InetAddress addr)
P	ipPrefixFor(byte[] bytes, int mask) Create an IpPrefix by combining the address with a mask.
P	ipPrefixFor(InetAddress addr, int mask)
protected abstract A	ipv4Address(A4 addr)
byte[]	ipv4AddressBytes(A4 addr)
A4	ipv4AddressFor(byte[] bytes) Create an Ipv4Address by interpreting input bytes as an IPv4 address.
A4	ipv4AddressFor(InetAddress addr) Create an Ipv4Address by interpreting an Inet4Address.
A4	ipv4AddressFrom(P4 prefix)
protected abstract String	ipv4AddressString(A4 addr)
protected abstract P	ipv4Prefix(P4 addr)
P4	ipv4PrefixFor(A4 addr)
P4	ipv4PrefixFor(A4 addr, int mask)
P4	ipv4PrefixFor(byte[] bytes) Create a /32 Ipv4Prefix by interpreting input bytes as an IPv4 address.
P4	ipv4PrefixFor(byte[] address, int mask) Create a Ipv4Prefix by combining the address with a mask.
P4	ipv4PrefixFor(InetAddress addr) Create a /32 Ipv4Prefix for an Inet4Address
P4	ipv4PrefixFor(InetAddress addr, int mask) Create a Ipv4Prefix by combining the address with a mask.
P4	ipv4PrefixForShort(byte[] address, int mask)
P4	ipv4PrefixForShort(byte[] array, int startOffset, int mask)
protected abstract String	ipv4PrefixString(P4 prefix)
byte[]	ipv4PrefixToBytes(P4 prefix)
protected abstract A	ipv6Address(A6 addr)
byte[]	ipv6AddressBytes(A6 addr)
A6	ipv6AddressFor(byte[] bytes) Create an Ipv6Address by interpreting input bytes as an IPv6 address.
A6	ipv6AddressFor(InetAddress addr) Create an Ipv6Address by interpreting an Inet6Address.
A6	ipv6AddressFrom(P6 prefix)
protected abstract String	ipv6AddressString(A6 addr)
protected abstract P	ipv6Prefix(P6 addr)
P6	ipv6PrefixFor(A6 addr)
P6	ipv6PrefixFor(A6 addr, int mask)
P6	ipv6PrefixFor(byte[] bytes) Create a /128 Ipv6Prefix by interpreting input bytes as an IPv6 address.
P6	ipv6PrefixFor(byte[] address, int mask) Create a Ipv6Prefix by combining the address with a mask.
P6	ipv6PrefixFor(InetAddress addr) Create a /128 Ipv6Prefix by interpreting input bytes as an IPv4 address.
P6	ipv6PrefixFor(InetAddress addr, int mask) Create a Ipv6Prefix by combining the address with a mask.
P6	ipv6PrefixForShort(byte[] address, int mask)
P6	ipv6PrefixForShort(byte[] array, int startOffset, int mask)
protected abstract String	ipv6PrefixString(P6 prefix)
byte[]	ipv6PrefixToBytes(P6 prefix)
protected abstract A4	maybeIpv4Address(A addr)
protected abstract A6	maybeIpv6Address(A addr)
Map.Entry<A4,Integer>	splitIpv4Prefix(P4 prefix)
Map.Entry<A6,Integer>	splitIpv6Prefix(P6 prefix)

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractIetfInetUtil

protected AbstractIetfInetUtil(Class<A4> addr4Class,
                               Class<P4> prefix4Class,
                               Class<A6> addr6Class,
                               Class<P6> prefix6Class)

Method Detail

ipv4Address

@Nonnull
protected abstract A ipv4Address(@Nonnull
                                          A4 addr)

ipv6Address

@Nonnull
protected abstract A ipv6Address(@Nonnull
                                          A6 addr)

ipv4Prefix

@Nonnull
protected abstract P ipv4Prefix(@Nonnull
                                         P4 addr)

ipv6Prefix

@Nonnull
protected abstract P ipv6Prefix(@Nonnull
                                         P6 addr)

maybeIpv4Address

@Nullable
protected abstract A4 maybeIpv4Address(@Nonnull
                                                 A addr)

maybeIpv6Address

@Nullable
protected abstract A6 maybeIpv6Address(@Nonnull
                                                 A addr)

ipv4AddressString

@Nonnull
protected abstract String ipv4AddressString(@Nonnull
                                                     A4 addr)

ipv6AddressString

@Nonnull
protected abstract String ipv6AddressString(@Nonnull
                                                     A6 addr)

ipv4PrefixString

@Nonnull
protected abstract String ipv4PrefixString(@Nonnull
                                                    P4 prefix)

ipv6PrefixString

@Nonnull
protected abstract String ipv6PrefixString(@Nonnull
                                                    P6 prefix)

ipAddressFor

@Nonnull
public final A ipAddressFor(@Nonnull
                                     byte[] bytes)

Create an IpAddress by interpreting input bytes as an IPv4 or IPv6 address, based on array length.

Parameters:

bytes - 4-byte (IPv4) or 6-byte (IPv6) array

Returns:

An IpAddress object

Throws:

IllegalArgumentException - if bytes has length different from 4 or 6

NullPointerException - if bytes is null

ipAddressFor

@Nonnull
public final A ipAddressFor(@Nonnull
                                     InetAddress addr)

ipPrefixFor

@Nonnull
public final P ipPrefixFor(@Nonnull
                                    byte[] bytes,
                                    int mask)

Create an IpPrefix by combining the address with a mask. The address bytes are interpreted as an address and the specified mask is concatenated to it. The address bytes are not masked.

Parameters:

bytes - Input address as a 4-byte (IPv4) or 16-byte (IPv6) array

mask - Prefix mask

Returns:

An IpPrefix object

Throws:

IllegalArgumentException - if bytes has length different from 4 or 16 or if mask is not in range 0-32 or 0-128 respectively

NullPointerException - if bytes is null

ipPrefixFor

@Nonnull
public final P ipPrefixFor(@Nonnull
                                    InetAddress addr,
                                    int mask)

inetAddressFor

@Nonnull
public final InetAddress inetAddressFor(@Nonnull
                                                 A addr)

inet4AddressFor

@Nonnull
public final Inet4Address inet4AddressFor(@Nonnull
                                                   A4 addr)

inet6AddressFor

@Nonnull
public final Inet6Address inet6AddressFor(@Nonnull
                                                   A6 addr)

ipv4AddressFor

@Nonnull
public final A4 ipv4AddressFor(@Nonnull
                                        byte[] bytes)

Create an Ipv4Address by interpreting input bytes as an IPv4 address.

Parameters:

bytes - 4-byte array

Returns:

An Ipv4Address object

Throws:

IllegalArgumentException - if bytes has length different from 4

NullPointerException - if bytes is null

ipv4AddressFor

@Nonnull
public final A4 ipv4AddressFor(@Nonnull
                                        InetAddress addr)

Create an Ipv4Address by interpreting an Inet4Address.

Parameters:

addr - An Inet4Address

Returns:

An Ipv4Address object

Throws:

IllegalArgumentException - if addr is not an Inet4Address

NullPointerException - if addr is null

ipv4AddressFrom

@Nonnull
public final A4 ipv4AddressFrom(@Nonnull
                                         P4 prefix)

ipv4AddressBytes

@Nonnull
public final byte[] ipv4AddressBytes(@Nonnull
                                              A4 addr)

ipv4PrefixFor

@Nonnull
public final P4 ipv4PrefixFor(@Nonnull
                                       byte[] bytes)

Create a /32 Ipv4Prefix by interpreting input bytes as an IPv4 address.

Parameters:

bytes - four-byte array

Returns:

An Ipv4Prefix object

Throws:

IllegalArgumentException - if bytes has length different from 4

NullPointerException - if bytes is null

ipv4PrefixFor

@Nonnull
public final P4 ipv4PrefixFor(@Nonnull
                                       byte[] address,
                                       int mask)

Create a Ipv4Prefix by combining the address with a mask. The address bytes are interpreted as an address and the specified mask is concatenated to it. The address bytes are not masked, hence input address = { 1, 2, 3, 4 } and mask=24 will result in 1.2.3.4/24.

Parameters:

address - Input address as a 4-byte array

mask - Prefix mask

Returns:

An Ipv4Prefix object

Throws:

IllegalArgumentException - if bytes has length different from 4 or if mask is not in range 0-32

NullPointerException - if bytes is null

ipv4PrefixForShort

@Nonnull
public final P4 ipv4PrefixForShort(@Nonnull
                                            byte[] address,
                                            int mask)

ipv4PrefixForShort

@Nonnull
public final P4 ipv4PrefixForShort(@Nonnull
                                            byte[] array,
                                            int startOffset,
                                            int mask)

ipv4PrefixFor

@Nonnull
public final P4 ipv4PrefixFor(@Nonnull
                                       InetAddress addr)

Create a /32 Ipv4Prefix for an Inet4Address

Parameters:

addr - An Inet4Address

Returns:

An Ipv4Prefix object

Throws:

IllegalArgumentException - if addr is not an Inet4Address

NullPointerException - if adds is null

ipv4PrefixFor

@Nonnull
public final P4 ipv4PrefixFor(@Nonnull
                                       InetAddress addr,
                                       int mask)

Create a Ipv4Prefix by combining the address with a mask. The address bytes are not masked.

Parameters:

addr - An Inet4Address

mask - Prefix mask

Returns:

An Ipv4Prefix object

Throws:

IllegalArgumentException - if addr is not an Inet4Address or if mask is not in range 0-32

NullPointerException - if addr is null

ipv4PrefixFor

@Nonnull
public final P4 ipv4PrefixFor(@Nonnull
                                       A4 addr)

ipv4PrefixFor

@Nonnull
public final P4 ipv4PrefixFor(@Nonnull
                                       A4 addr,
                                       int mask)

splitIpv4Prefix

@Nonnull
public final Map.Entry<A4,Integer> splitIpv4Prefix(@Nonnull
                                                            P4 prefix)

ipv4PrefixToBytes

@Nonnull
public final byte[] ipv4PrefixToBytes(@Nonnull
                                               P4 prefix)

ipv6AddressFor

@Nonnull
public final A6 ipv6AddressFor(@Nonnull
                                        byte[] bytes)

Create an Ipv6Address by interpreting input bytes as an IPv6 address.

Parameters:

bytes - 16-byte array

Returns:

An Ipv6Address object

Throws:

IllegalArgumentException - if bytes has length different from 16

NullPointerException - if bytes is null

ipv6AddressFor

@Nonnull
public final A6 ipv6AddressFor(@Nonnull
                                        InetAddress addr)

Create an Ipv6Address by interpreting an Inet6Address.

Parameters:

addr - An Inet6Address

Returns:

An Ipv6Address object

Throws:

IllegalArgumentException - if addr is not an Inet6Address

NullPointerException - if addr is null

ipv6AddressFrom

@Nonnull
public final A6 ipv6AddressFrom(@Nonnull
                                         P6 prefix)

ipv6AddressBytes

@Nonnull
public final byte[] ipv6AddressBytes(@Nonnull
                                              A6 addr)

ipv6PrefixFor

@Nonnull
public final P6 ipv6PrefixFor(@Nonnull
                                       byte[] bytes)

Create a /128 Ipv6Prefix by interpreting input bytes as an IPv6 address.

Parameters:

bytes - four-byte array

Returns:

An Ipv6Prefix object

Throws:

IllegalArgumentException - if bytes has length different from 16

NullPointerException - if bytes is null

ipv6PrefixFor

@Nonnull
public final P6 ipv6PrefixFor(@Nonnull
                                       byte[] address,
                                       int mask)

Create a Ipv6Prefix by combining the address with a mask. The address bytes are interpreted as an address and the specified mask is concatenated to it. The address bytes are not masked.

Parameters:

address - Input address as a 16-byte array

mask - Prefix mask

Returns:

An Ipv6Prefix object

Throws:

IllegalArgumentException - if bytes has length different from 16 or if mask is not in range 0-128

NullPointerException - if bytes is null

ipv6PrefixForShort

@Nonnull
public final P6 ipv6PrefixForShort(@Nonnull
                                            byte[] address,
                                            int mask)

ipv6PrefixForShort

@Nonnull
public final P6 ipv6PrefixForShort(@Nonnull
                                            byte[] array,
                                            int startOffset,
                                            int mask)

ipv6PrefixFor

@Nonnull
public final P6 ipv6PrefixFor(@Nonnull
                                       InetAddress addr)

Create a /128 Ipv6Prefix by interpreting input bytes as an IPv4 address.

Parameters:

addr - an Inet6Address

Returns:

An Ipv6Prefix object

Throws:

IllegalArgumentException - if addr is not an Inet6Address or if mask is not in range 0-128

NullPointerException - if addr is null

ipv6PrefixFor

@Nonnull
public final P6 ipv6PrefixFor(@Nonnull
                                       InetAddress addr,
                                       int mask)

Create a Ipv6Prefix by combining the address with a mask. The address bytes are interpreted as an address and the specified mask is concatenated to it. The address bytes are not masked.

Parameters:

addr - Input address

mask - Prefix mask

Returns:

An Ipv6Prefix object

Throws:

IllegalArgumentException - if addr is not an Inet6Address or if mask is not in range 0-128

NullPointerException - if addr is null

ipv6PrefixFor

@Nonnull
public final P6 ipv6PrefixFor(@Nonnull
                                       A6 addr)

ipv6PrefixFor

@Nonnull
public final P6 ipv6PrefixFor(@Nonnull
                                       A6 addr,
                                       int mask)

splitIpv6Prefix

@Nonnull
public final Map.Entry<A6,Integer> splitIpv6Prefix(@Nonnull
                                                            P6 prefix)

ipv6PrefixToBytes

@Nonnull
public final byte[] ipv6PrefixToBytes(@Nonnull
                                               P6 prefix)