Packages This Package Prev Next Index
§4.4 Class InetAddress
public final class java.net.InetAddress
extends java.lang.Object (I-§1.12)
{
// Methods
public boolean equals(Object obj); §4.4.1
public byte[] getAddress(); §4.4.2
public static InetAddress[] getAllByName(String host); §4.4.3
public static InetAddress getByName(String host); §4.4.4
public String getHostName(); §4.4.5
public static InetAddress getLocalHost(); §4.4.6
public int hashCode(); §4.4.7
public String toString(); §4.4.8
}
This class represents an Internet Protocol (IP) address.
Applications should use the methods getLocalHost (I-§4.4.6), getByName (I-§4.4.4), or
getAllByName (I-§4.4.3) to create a new InetAddress instance.
equals
public boolean equals(Object obj)
- The result is true if and only if the argument is not null and it represents the
same IP address as this object.
- Two instances of InetAddress represent the same IP address if the length of
the byte arrays returned by getAddress (I-§4.4.2) is the same for both, and
each of the array components is the same for the byte arrays.
- Parameters:
obj
-
the object to compare against
- Returns:
- true if the objects are the same; false otherwise.
- Overrides:
- equals in class Object (I-§1.12.3).
getAddress
public byte[] getAddress()
- Determines the raw IP address of this InetAddress object. The result is in
network byte order: the highest order byte of the address is in get-Address()[0].
- Returns:
- the raw IP address of this object.
-
getAllByName
public static InetAddress[] getAllByName(String host)
throws UnknownHostException
- Parameters:
host
-
the name of the host
- Returns:
- an array of all the IP addresses for a given host name.
- Throws
- UnknownHostException (I-§4.18)
- If no IP address for the host could be found.
getByName
public static InetAddress getByName(String host)
throws UnknownHostException
- Determines the IP address of a host, given the host's name. The host name
can either be a machine name, such as "java.sun.com" or a string representing its IP address, such as "206.26.48.100".
- Parameters:
host
-
the specified host, or null for the local host
- Returns:
- an IP address for the given host name.
- Throws
- UnknownHostException (I-§4.18)
- If no IP address for the host could be found.
getHostName
public String getHostName()
- Returns:
- the host name for this IP address.
getLocalHost
public static InetAddress getLocalHost()
throws UnknownHostException
- Returns:
- the IP address of the local host.
- Throws
- UnknownHostException (I-§4.18)
- If no IP address for the host could be found.
hashCode
public int hashCode()
- Returns:
- a hash code value for this IP address.
- Overrides:
- hashCode in class Object (I-§1.12.6).
toString
public String toString()
- Returns:
- a string representation of this IP address.
- Overrides:
- toString in class Object (I-§1.12.9).
Packages This Package Prev Next Index
Java API Document (HTML generated by dkramer on April 22, 1996)
Copyright © 1996 Sun Microsystems, Inc.
All rights reserved
Please send any comments or corrections to doug.kramer@sun.com