java.lang.Object | |
↳ | java.net.InetAddress |
Known Direct Subclasses |
The Internet Protocol (IP) address representation class. This class encapsulates an IP address and provides name and reverse name resolution functions. The address is stored in network order, but as a signed (rather than unsigned) integer.
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Compares this
InetAddress instance against the specified address
in obj . | |||||||||||
Returns the IP address represented by this
InetAddress instance
as a byte array. | |||||||||||
Gets all IP addresses associated with the given
host identified
by name or literal IP address. | |||||||||||
Returns the
InetAddress corresponding to the array of bytes, and
the given hostname. | |||||||||||
Returns the
InetAddress corresponding to the array of bytes. | |||||||||||
Returns the address of a host according to the given host string name
host . | |||||||||||
Gets the fully qualified domain name for the host associated with this IP
address.
| |||||||||||
Gets the textual representation of this IP address.
| |||||||||||
Gets the host name of this IP address.
| |||||||||||
Gets the local host address if the security policy allows this.
| |||||||||||
Gets the hashcode of the represented IP address.
| |||||||||||
Returns whether this is a wildcard address or not.
| |||||||||||
Returns whether this address is a link-local address or not.
| |||||||||||
Returns whether this address is a loopback address or not.
| |||||||||||
Returns whether this address is a global multicast address or not.
| |||||||||||
Returns whether this address is a link-local multicast address or not.
| |||||||||||
Returns whether this address is a node-local multicast address or not.
| |||||||||||
Returns whether this address is a organization-local multicast address or
not.
| |||||||||||
Returns whether this address is a site-local multicast address or not.
| |||||||||||
Tries to reach this
InetAddress . | |||||||||||
Tries to reach this
InetAddress . | |||||||||||
Returns whether this address is a site-local address or not.
| |||||||||||
Returns a string containing a concise, human-readable description of this
IP address.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class java.lang.Object
|
Compares this InetAddress
instance against the specified address
in obj
. Two addresses are equal if their address byte arrays have
the same length and if the bytes in the arrays are equal.
obj | the object to be tested for equality. |
---|
true
if both objects are equal, false
otherwise.
Returns the IP address represented by this InetAddress
instance
as a byte array. The elements are in network order (the highest order
address byte is in the zeroth element).
Gets all IP addresses associated with the given host
identified
by name or literal IP address. The IP address is resolved by the
configured name service. If the host name is empty or null
an
UnknownHostException
is thrown. If the host name is a literal IP
address string an array with the corresponding single InetAddress
is returned.
host | the hostname or literal IP string to be resolved. |
---|
UnknownHostException | if the address lookup fails. |
---|
Returns the InetAddress
corresponding to the array of bytes, and
the given hostname. In the case of an IPv4 address there must be exactly
4 bytes and for IPv6 exactly 16 bytes. If not, an UnknownHostException
will be thrown.
The host name and IP address are not validated.
The hostname either be a machine alias or a valid IPv6 or IPv4 address format.
The high order byte is ipAddress[0]
.
hostName | the string representation of hostname or IP address. |
---|---|
ipAddress | either a 4 (IPv4) or 16 (IPv6) byte long array. |
InetAddress
instance representing the given IP address
and hostname.UnknownHostException | if the given byte array has no valid length. |
---|
Returns the InetAddress
corresponding to the array of bytes. In
the case of an IPv4 address there must be exactly 4 bytes and for IPv6
exactly 16 bytes. If not, an UnknownHostException
is thrown.
The IP address is not validated by a name service.
The high order byte is ipAddress[0]
.
ipAddress | is either a 4 (IPv4) or 16 (IPv6) byte long array. |
---|
InetAddress
instance representing the given IP address
ipAddress
.UnknownHostException | if the given byte array has no valid length. |
---|
Returns the address of a host according to the given host string name
host
. The host string may be either a machine name or a dotted
string IP address. If the latter, the hostName
field is
determined upon demand. host
can be null
which means that
an address of the loopback interface is returned.
host | the hostName to be resolved to an address or null . |
---|
InetAddress
instance representing the host.UnknownHostException | if the address lookup fails. |
---|
Gets the fully qualified domain name for the host associated with this IP address. If a security manager is set, it is checked if the method caller is allowed to get the hostname. Otherwise, the textual representation in a dotted-quad-notation is returned.
Gets the textual representation of this IP address.
Gets the host name of this IP address. If the IP address could not be resolved, the textual representation in a dotted-quad-notation is returned.
Gets the local host address if the security policy allows this. Otherwise, gets the loopback address which allows this machine to be contacted.
InetAddress
representing the local host.UnknownHostException | if the address lookup fails. |
---|
Gets the hashcode of the represented IP address.
Returns whether this is a wildcard address or not. This implementation
returns always false
.
true
if this instance represents a wildcard address,
false
otherwise.
Returns whether this address is a link-local address or not. This
implementation returns always false
.
Valid IPv6 link-local addresses are FE80::0 through to FEBF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
There are no valid IPv4 link-local addresses.
true
if this instance represents a link-local address,
false
otherwise.
Returns whether this address is a loopback address or not. This
implementation returns always false
. Valid IPv4 loopback
addresses are 127.d.d.d The only valid IPv6 loopback address is ::1.
true
if this instance represents a loopback address,
false
otherwise.
Returns whether this address is a global multicast address or not. This
implementation returns always false
.
Valid IPv6 link-global multicast addresses are FFxE:/112 where x is a set of flags, and the additional 112 bits make up the global multicast address space.
Valid IPv4 global multicast addresses are between: 224.0.1.0 to 238.255.255.255.
true
if this instance represents a global multicast
address, false
otherwise.
Returns whether this address is a link-local multicast address or not.
This implementation returns always false
.
Valid IPv6 link-local multicast addresses are FFx2:/112 where x is a set of flags, and the additional 112 bits make up the link-local multicast address space.
Valid IPv4 link-local addresses are between: 224.0.0.0 to 224.0.0.255
true
if this instance represents a link-local multicast
address, false
otherwise.
Returns whether this address is a node-local multicast address or not.
This implementation returns always false
.
Valid IPv6 node-local multicast addresses are FFx1:/112 where x is a set of flags, and the additional 112 bits make up the node-local multicast address space.
There are no valid IPv4 node-local multicast addresses.
true
if this instance represents a node-local multicast
address, false
otherwise.
Returns whether this address is a organization-local multicast address or
not. This implementation returns always false
.
Valid IPv6 organization-local multicast addresses are FFx8:/112 where x is a set of flags, and the additional 112 bits make up the organization-local multicast address space.
Valid IPv4 organization-local addresses are between: 239.192.0.0 to 239.251.255.255
true
if this instance represents a organization-local
multicast address, false
otherwise.
Returns whether this address is a site-local multicast address or not.
This implementation returns always false
.
Valid IPv6 site-local multicast addresses are FFx5:/112 where x is a set of flags, and the additional 112 bits make up the site-local multicast address space.
Valid IPv4 site-local addresses are between: 239.252.0.0 to 239.255.255.255
true
if this instance represents a site-local multicast
address, false
otherwise.
Tries to reach this InetAddress
. This method first tries to use
ICMP (ICMP ECHO REQUEST). When first step fails, a TCP connection
on port 7 (Echo) of the remote host is established.
timeout | timeout in milliseconds before the test fails if no connection could be established. |
---|
true
if this address is reachable, false
otherwise.IOException | if an error occurs during an I/O operation. |
---|---|
IllegalArgumentException | if timeout is less than zero. |
Tries to reach this InetAddress
. This method first tries to use
ICMP (ICMP ECHO REQUEST). When first step fails, a TCP connection
on port 7 (Echo) of the remote host is established.
netif | the network interface on which to connection should be established. |
---|---|
ttl | the maximum count of hops (time-to-live). |
timeout | timeout in milliseconds before the test fails if no connection could be established. |
true
if this address is reachable, false
otherwise.IOException | if an error occurs during an I/O operation. |
---|---|
IllegalArgumentException | if ttl or timeout is less than zero. |
Returns whether this address is a site-local address or not. This
implementation returns always false
.
Valid IPv6 site-local addresses are FEC0::0 through to FEFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
There are no valid IPv4 site-local addresses.
true
if this instance represents a site-local address,
false
otherwise.
Returns a string containing a concise, human-readable description of this IP address.