java.net

Class InetSocketAddress

java.lang.Object

java.net.SocketAddress

java.net.InetSocketAddress

All Implemented Interfaces:

Serializable

public class InetSocketAddress
extends SocketAddress

This class represents the address of a socket endpoint described by a IP address and a port number. It is a concrete implementation of SocketAddress for IP.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
InetSocketAddress()
InetSocketAddress(InetAddress address, int port) Creates a socket endpoint with the given port number port and address.
InetSocketAddress(int port) Creates a socket endpoint with the given port number port and no specified address.
InetSocketAddress(String host, int port) Creates a socket endpoint with the given port number port and the hostname host.

Method Summary

Modifier and Type	Method and Description
static InetSocketAddress	createUnresolved(String host, int port) Creates an InetSocketAddress without trying to resolve the hostname into an InetAddress.
boolean	equals(Object socketAddr) Compares two socket endpoints and returns true if they are equal.
InetAddress	getAddress() Returns the socket endpoint's address.
String	getHostName() Returns the hostname, doing a reverse DNS lookup on the InetAddress if no hostname string was provided at construction time.
String	getHostString() Returns the hostname if known, or the result of InetAddress.getHostAddress.
int	getPort() Returns the socket endpoint's port.
int	hashCode() Returns an integer hash code for this object.
boolean	isUnresolved() Returns whether this socket address is unresolved or not.
String	toString() Returns a string containing the address (or the hostname for an unresolved InetSocketAddress) and port number.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

InetSocketAddress

public InetSocketAddress()

InetSocketAddress

public InetSocketAddress(int port)

Creates a socket endpoint with the given port number port and no specified address. The range for valid port numbers is between 0 and 65535 inclusive.

Parameters:

port - the port number of the socket endpoint.

InetSocketAddress

public InetSocketAddress(InetAddress address,
                         int port)

Creates a socket endpoint with the given port number port and address. The range for valid port numbers is between 0 and 65535 inclusive. If address is null the address is set to a wildcard address.

Parameters:

address - the address of the socket endpoint.

port - the port number of the socket endpoint.

InetSocketAddress

public InetSocketAddress(String host,
                         int port)

Creates a socket endpoint with the given port number port and the hostname host. The hostname is tried to be resolved and cannot be null. The range for valid port numbers is between 0 and 65535 inclusive.

Parameters:

host - the hostname of the socket endpoint.

port - the port number of the socket endpoint.

Method Detail

createUnresolved

public static InetSocketAddress createUnresolved(String host,
                                                 int port)

Creates an InetSocketAddress without trying to resolve the hostname into an InetAddress. The address field is marked as unresolved.

Parameters:

host - the hostname of the socket endpoint.

port - the port number of the socket endpoint.

Returns:

the created InetSocketAddress instance.

Throws:

IllegalArgumentException - if the hostname host is null or the port is not in the range between 0 and 65535.

getPort

public final int getPort()

Returns the socket endpoint's port.

getAddress

public final InetAddress getAddress()

Returns the socket endpoint's address.

getHostName

public final String getHostName()

Returns the hostname, doing a reverse DNS lookup on the InetAddress if no hostname string was provided at construction time. Use getHostString() to avoid the reverse DNS lookup.

getHostString

public final String getHostString()

Returns the hostname if known, or the result of InetAddress.getHostAddress. Unlike getHostName(), this method will never cause a DNS lookup.

Since:

1.7

isUnresolved

public final boolean isUnresolved()

Returns whether this socket address is unresolved or not.

Returns:

true if this socket address is unresolved, false otherwise.

toString

public String toString()

Returns a string containing the address (or the hostname for an unresolved InetSocketAddress) and port number. For example: "www.google.com/74.125.224.115:80" or "/127.0.0.1:80".

Overrides:

toString in class Object

Returns:

a printable representation of this object.

equals

public final boolean equals(Object socketAddr)

Compares two socket endpoints and returns true if they are equal. Two socket endpoints are equal if the IP address or the hostname of both are equal and they are bound to the same port.

Overrides:

equals in class Object

Parameters:

socketAddr - the object to be tested for equality.

Returns:

true if this socket endpoint and the given socket endpoint socketAddr are equal, false otherwise.

See Also:

Object.hashCode()

hashCode

public final int hashCode()

Description copied from class: Object

Returns an integer hash code for this object. By contract, any two objects for which Object.equals(java.lang.Object) returns true must return the same hash code value. This means that subclasses of Object usually override both methods or neither method.

Note that hash values must not change over time unless information used in equals comparisons also changes.

See Writing a correct hashCode method if you intend implementing your own hashCode method.

Overrides:

hashCode in class Object

Returns:

this object's hash code.

See Also:

Object.equals(java.lang.Object)