How do I use a host name to look up an IP address?
Author: Deron Eriksson
Description: This Java tutorial describes how to use the InetAddress class to look up an IP address using a host name.
Tutorial created using: Windows XP || JDK 1.5.0_09 || Eclipse Web Tools Platform 1.5.4


The InetAddress class can be used to perform Domain Name Server (DNS) lookups. For example, you can call the static InetAddress.getByName("www.teamcakes.com") to retrieve an InetAddress object for 'www.teamcakes.com'. This object would contain the canonical name, host name, and ip address of 'www.teamcakes.com'.

The DnsTest class below demonstrates InetAddress.getLocalHost(), which obtains an Internet Address for your local host. It also demonstrates InetAddress.getByName("www.google.com"), which gives an Internet Address object for 'www.google.com'. However, it should be noted that a DNS name can map to multiple servers, and the InetAddress.getAllByName("www.google.com") call retrieves an array of InetAddress objects that represent all of the 'www.google.com' servers retrieved from DNS.

DnsTest.java

package test;

import java.net.InetAddress;
import java.net.UnknownHostException;

public class DnsTest {
	public static void main(String[] args) {
		try {
			InetAddress inetAddress = InetAddress.getLocalHost();
			displayStuff("local host", inetAddress);
			System.out.print("--------------------------");
			inetAddress = InetAddress.getByName("www.google.com");
			displayStuff("www.google.com", inetAddress);
			System.out.print("--------------------------");
			InetAddress[] inetAddressArray = InetAddress.getAllByName("www.google.com");
			for (int i = 0; i < inetAddressArray.length; i++) {
				displayStuff("www.google.com #" + (i + 1), inetAddressArray[i]);
			}
		} catch (UnknownHostException e) {
			e.printStackTrace();
		}
	}

	public static void displayStuff(String whichHost, InetAddress inetAddress) {
		System.out.println("--------------------------");
		System.out.println("Which Host:" + whichHost);
		System.out.println("Canonical Host Name:" + inetAddress.getCanonicalHostName());
		System.out.println("Host Name:" + inetAddress.getHostName());
		System.out.println("Host Address:" + inetAddress.getHostAddress());
	}
}

If we execute DnsTest, we obtain the following console results:

--------------------------
Which Host:local host
Canonical Host Name:DERBIZZ
Host Name:DERBIZZ
Host Address:192.168.1.106
----------------------------------------------------
Which Host:www.google.com
Canonical Host Name:po-in-f104.google.com
Host Name:www.google.com
Host Address:72.14.253.104
----------------------------------------------------
Which Host:www.google.com #1
Canonical Host Name:po-in-f104.google.com
Host Name:www.google.com
Host Address:72.14.253.104
--------------------------
Which Host:www.google.com #2
Canonical Host Name:po-in-f103.google.com
Host Name:www.google.com
Host Address:72.14.253.103
--------------------------
Which Host:www.google.com #3
Canonical Host Name:po-in-f99.google.com
Host Name:www.google.com
Host Address:72.14.253.99
--------------------------
Which Host:www.google.com #4
Canonical Host Name:po-in-f147.google.com
Host Name:www.google.com
Host Address:72.14.253.147

As you can see, the InetAddress class allows us to perform DNS lookups and retrieve canonical host names, host names, and IP addresses. The results above show us that multiple servers can be represented by one host name, and these can be distinguished by their different IP (host) addresses and canonical host names.

Just as an aside, what happens if we try doing a lookup on a host that doesn't exist, such as: InetAddress.getByName("www.this-host-does-not-exist.com")? An UnknownHostException is thrown, as shown below.

java.net.UnknownHostException: www.this-host-does-not-exist.com: www.this-host-does-not-exist.com
	at java.net.InetAddress.getAllByName0(InetAddress.java:1128)
	at java.net.InetAddress.getAllByName0(InetAddress.java:1098)
	at java.net.InetAddress.getAllByName(InetAddress.java:1061)
	at java.net.InetAddress.getByName(InetAddress.java:958)
	at test.DnsTest.main(DnsTest.java:12)