net.jackofalltrades.irc.util
Class InetAddressUtils

java.lang.Object
  net.jackofalltrades.irc.util.InetAddressUtils

public class InetAddressUtils

extends java.lang.Object

Provides utility methods for converting java.net.InetAddress objects to unsigned integers and from unsigned integers to java.net.InetAddress objects.

 java.net.InetAddress address = InetAddress.getByName("127.0.0.1");
 String localHostAsUnsignedInt = "2130706433";
 
 // print out "2130706433".
 System.out.println(
         InetAddressUtils.toUnsignedInteger(address));
 
 // print out "addresses are equal".
 if (address.equals(InetAddressUtils.toInetAddress(localHostAsUnsignedInt))) {
     System.out.println("addresses are equal");
 }
 

Since:

0.5-alpha

Version:

$Revision: 1.2 $ $Date: 2003/08/03 21:01:35 $

Author:

Bradley M. Handy

Method Summary

static java.net.InetAddress	toInetAddress(java.lang.String address) Converts an unsigned integer string into a java.net.InetAddress.
static java.lang.String	toUnsignedIntegerString(java.net.InetAddress address) Converts a java.net.InetAddress to an unsigned integer string.

Methods inherited from class java.lang.Object

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

Method Detail

toUnsignedIntegerString

public static final java.lang.String toUnsignedIntegerString(java.net.InetAddress address)

Converts a java.net.InetAddress to an unsigned integer string.

Parameters:

address - the java.net.InetAddress to convert.

Returns:

an unsigned four-byte integer string representing an IPv4 address, or an unsigned 32-byte integer string representing an IPv6 address.

Throws:

java.lang.IllegalArgumentException - if address is null.

toInetAddress

public static final java.net.InetAddress toInetAddress(java.lang.String address)

Converts an unsigned integer string into a java.net.InetAddress.

Parameters:

address - the address as an unsigned integer string.

Returns:

a java.net.InetAddress object, or null if the conversion failed.

Throws:

java.lang.IllegalArgument - Exception if the address is not an unsigned integer.