copied from google code http://code.google.com/p/java-ipv6
java-ipv6 is a Java library for IPv6 related concepts such as IPv6 addresses, network masks, address pools, etc.
Java IPv6 Library (v0.15)
IPv6Address
IPv6Address represents an IPv6 address. final IPv6Address iPv6Address = IPv6Address.fromString("fe80::226:2dff:fefa:cd1f"); final IPv6Address iPv4MappedIPv6Address = IPv6Address.fromString("::ffff:192.168.0.1");
Internally, the IPv6Address uses two long values to store the IPv6 address.
IPv6Address can be used to make simple calculations on IPv6 addresses, such as addition and subtraction. final IPv6Address iPv6Address = IPv6Address.fromString("fe80::226:2dff:fefa:cd1f"); final IPv6Address next = iPv6Address.add(1); final IPv6Address previous = iPv6Address.subtract(1); System.out.println(next.toString()); // prints fe80::226:2dff:fefa:cd20 System.out.println(previous.toString()); // prints fe80::226:2dff:fefa:cd1e
IPv6AddressRange
IPv6AddressRange represents a continuous range of consecutive IPv6 addresses. final IPv6AddressRange range = IPv6AddressRange.fromFirstAndLast(IPv6Address.fromString("fe80::226:2dff:fefa:cd1f"), IPv6Address.fromString("fe80::226:2dff:fefa:ffff")); System.out.println(range.contains(IPv6Address.fromString("fe80::226:2dff:fefa:dcba"))); // prints true
IPv6AddressRange contains methods to iterate over all the addresses in the range. Ranges can be compared with other ranges by checking if they overlap or if one range contains the other range.
IPv6Network
An IPv6Network is a range (extends IPv6AddressRange) that can be expressed as a network address and a prefix length. final IPv6AddressRange range = IPv6AddressRange.fromFirstAndLast(IPv6Address.fromString("fe80::226:2dff:fefa:0"), IPv6Address.fromString("fe80::226:2dff:fefa:ffff")); final IPv6Network network = IPv6Network.fromString("fe80::226:2dff:fefa:0/112"); System.out.println(range.equals(network)); // prints true
Note that every IPv6Network is also an IPv6AddressRange, but not all IPv6AddressRanges are valid IPv6Networks. It is possible to construct an IPv6Network from a range in between a first address and a last address, but than the smallest possible IPv6Network (i.e. the one with the longest prefix length) which contains the given first and last addresses will be constructed. The resulting network thus contains the same or more addresses as the requested range.
IPv6Network can be used for IPv6 network address calculations. final IPv6Network strangeNetwork = IPv6Network.fromString("fe80::226:2dff:fefa:cd1f/43");
System.out.println(strangeNetwork.getFirst()); // prints fe80:: System.out.println(strangeNetwork.getLast()); // prints fe80:0:1f:ffff:ffff:ffff:ffff:ffff System.out.println(strangeNetwork.getNetmask().asPrefixLength()); // prints 43 System.out.println(strangeNetwork.getNetmask().asAddress()); // prints ffff:ffff:ffe0::
A particularly interesting calculation is to split an IPv6Network in smaller subnets. final IPv6Network network = IPv6Network.fromString("1:2:3:4:5:6:7:0/120");
Iterator splits = network.split(IPv6NetworkMask.fromPrefixLength(124)); while (splits.hasNext()) System.out.println(splits.next());
// prints 1:2:3:4:5:6:7:0/124, 1:2:3:4:5:6:7:10/124, 1:2:3:4:5:6:7:20/124, ... until 1:2:3:4:5:6:7:f0/124 (16 in total)
An IPv6AddressRange (which doesn't necessarily align with a single network) can be converted to a set of networks (subnets). This will give you the minimal set of non overlapping, consecutive networks that define the same set of IPv6Addresses as the original range. Here is an example: IPv6AddressRange range = IPv6AddressRange.fromFirstAndLast(IPv6Address.fromString("::1:ffcc"), IPv6Address.fromString("::2:0"));
Iterator subnetsIterator = range.toSubnets(); while (subnetsIterator.hasNext()) System.out.println(subnetsIterator.next());
// prints the networks ::1:ffcc/126, ::1:ffd0/124, ::1:ffe0/123 and ::2:0/128
IPv6NetworkMask
An IPv6NetworkMask is merely a wrapper around the integer in the interval 0 (exclusive) until 128 (inclusive) which represents the prefix length of an IPv6Network. final IPv6NetworkMask slash40Network = IPv6NetworkMask.fromPrefixLength(40); System.out.println(slash40Network.asAddress()); // prints ffff:ffff:ff00:: System.out.println(slash40Network.asPrefixLength()); // prints 40
final IPv6NetworkMask slash40NetworkConstructedFromAddressNotation = IPv6NetworkMask.fromAddress(IPv6Address.fromString("ffff:ffff:ff00::")); System.out.println(slash40Network.equals(slash40NetworkConstructedFromAddressNotation)); // prints true
final IPv6NetworkMask invalidNetworkMask = IPv6NetworkMask.fromAddress(IPv6Address.fromString("0fff::")); // fails
It can be used for some more advanced calculations on IPv6Address, such as masking addresses with a prefix length. final IPv6Address iPv6Address = IPv6Address.fromString("fe80::226:2dff:fefa:cd1f");
final IPv6Address masked = iPv6Address.maskWithNetworkMask(IPv6NetworkMask.fromPrefixLength(40)); System.out.println(masked.toString()); // prints fe80::
final IPv6Address maximum = iPv6Address.maximumAddressWithNetworkMask(IPv6NetworkMask.fromPrefixLength(40)); System.out.println(maximum.toString()); // prints fe80:0:ff:ffff:ffff:ffff:ffff:ffff
IPv6AddressPool
An IPv6AddressPool is like a range (extends IPv6AddressRange) of which certain subnets are "allocated" and others are "free". final IPv6AddressPool pool = IPv6AddressPool.fromRangeAndSubnet( IPv6AddressRange.fromFirstAndLast(IPv6Address.fromString("fe80::226:2dff:fefa:0"), IPv6Address.fromString("fe80::226:2dff:fefa:ffff")), IPv6NetworkMask.fromPrefixLength(120)); System.out.println(pool.isFree(IPv6Network.fromString("fe80::226:2dff:fefa:5ff/120"))); // prints true
final IPv6AddressPool newPool = pool.allocate(IPv6Network.fromString("fe80::226:2dff:fefa:5ff/120")); System.out.println(newPool.isFree(IPv6Network.fromString("fe80::226:2dff:fefa:5ff/120"))); // prints false
And Much More
Much more can be done with these types. Have a look at the javadoc and sources to get an idea of the possibilities. If you have additional functionality you would like to see in this library, do not hesitate to let us know.
Download
Checkout the Downloads section or use maven. com.googlecode.java-ipv6 java-ipv6 0.15
Prerequisites
This library requires Java 6.
What's new
see WhatsNew.