java.net.InetAddress

Class java.net.InetAddress

java.lang.Object

 java.net.InetAddress

public final class InetAddress
implements Serializable
extends Object

This class represents an Internet Protocol (IP) address.

Applications should use the methods getLocalHost, getByName, or getAllByName to create a new InetAddress instance.

·         See Also

                                      getAllByName

                                      getByName

                   getLocalHost

Method Index

Method	Description
boolean equals(Object)	Compares this object against the specified object.
byte[] getAddress()	Returns the raw IP address of thisInetAddress object.
InetAddress[] getAllByName(String)	Determines all the IP addresses of a host, given the host's name.
InetAddress getByName(String)	Determines the IP address of a host, given the host's name.
String getHostAddress()	Returns the IP address string "%d.%d.%d.%d".
String getHostName()	Gets the host name for this IP address.
InetAddress getLocalHost()	Returns the local host.
int hashCode()	Returns a hash code for this IP address.
Boolean isMulticastAddress()	Utility routine to check if the InetAddress is an IP multicast address.
String toString()	Converts this IP address to a String.

Methods

     equals

public boolean equals(Object obj)

Compares this object against the specified object. 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 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

 GetAddress

public byte[] getAddress()

Returns the raw IP address of this InetAddress object. The result is in network byte order: the highest order byte of the address is in getAddress () [0].

Ø  Returns

the raw IP address of this object.

GetAllByName

public static InetAddress[] getAllByName(String host) throws UnknownHostException

Determines all the IP addresses 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".

If there is a security manager and host is not null and host.length() is not equal to zero, the security manager's checkConnect method is called with the hostname and -1 as its arguments to see if the operation is allowed.

Ø  Parameters

host - the name of the host.

Ø  Returns

an array of all the IP addresses for a given host name.

Ø  Throws

UnknownHostException if no IP address for the host could be found.

Ø  Throws

SecurityException if a security manager exists and           its checkConnect method  doesn't allow the operation.

Ø  See Also

checkConnect

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 if no IP address for the host could be found.

GetHostAddress

public String getHostAddress()

Returns the IP address string "%d.%d.%d.%d".

Ø  Returns

the raw IP address in a string format.

GetHostName

public String getHostName()

Gets the host name for this IP address.

If there is a security manager, its checkConnect method is first called with the    hostname and -1 as its arguments to see if the operation is allowed.

Ø  Returns

the host name for this IP address.

Ø  Throws

SecurityException if a security manager exists and its checkConnect method doesn't allow the operation.

Ø  See Also

checkConnect

GetLocalHost

public static synchronized InetAddress getLocalHost() throws UnknownHostException

Returns the local host.

If there is a security manager, its checkConnect method is called with the local host name and -1 as its arguments to see if the operation is allowed.

Ø  Returns

the IP address of the local host.

Ø  Throws

UnknownHostException if no IP address for the host could be found.

Ø  Throws

SecurityException if a security manager exists and its checkConnect method doesn't allow the operation.

Ø  See Also

checkConnect

HashCode

public int hashCode()

Returns a hashcode for this IP address.

Ø  Returns

a hash code value for this IP address.

Ø  Overrides

hashCode in class Object

isMulticastAddress

public boolean isMulticastAddress()

Utility routine to check if the InetAddress is an IP multicast address. IP multicast address is a Class D address i.e first four bits of the address are 1110.

Ø  Returns

a boolean indicating if the InetAddress is an IP multicast address

toString

public String toString()

Converts this IP address to a String.

Ø  Returns

a string representation of this IP address.

Ø  Overrides

toString in class Object

For all java online training classes please contact : training@virtualnuggets.com

                                    http://www.virtualnuggets.com/