Summary: Methods | Inherited Methods | [Expand All]

Since: API Level 1

public final class

Inet6Address

extends InetAddress

java.lang.Object
↳	java.net.InetAddress
	↳	java.net.Inet6Address

Class Overview

An IPv6 address. See InetAddress.

Summary

Public Methods
static Inet6Address	getByAddress(String host, byte[] addr, int scope_id) Constructs an IPv6 address according to the given `host`, `addr` and `scope_id`.
static Inet6Address	getByAddress(String host, byte[] addr, NetworkInterface nif) Gets an IPv6 address instance according to the given `host`, `addr` and `nif`.
int	getScopeId() Gets the scope id as a number if this address is linked to an interface.
NetworkInterface	getScopedInterface() Gets the network interface if this address is instanced with a scoped network interface.
boolean	isAnyLocalAddress() Returns whether this address is a unspecified wildcard address "::" or not.
boolean	isIPv4CompatibleAddress() Returns whether this address is IPv4 compatible or not.
boolean	isLinkLocalAddress() Returns whether this address is a link-local address or not.
boolean	isLoopbackAddress() Returns whether this address is the loopback address or not.
boolean	isMCGlobal() Returns whether this address is a global multicast address or not.
boolean	isMCLinkLocal() Returns whether this address is a link-local multicast address or not.
boolean	isMCNodeLocal() Returns whether this address is a node-local multicast address or not.
boolean	isMCOrgLocal() Returns whether this address is a organization-local multicast address or not.
boolean	isMCSiteLocal() Returns whether this address is a site-local multicast address or not.
boolean	isMulticastAddress() Returns whether this address is an IP multicast address or not.
boolean	isSiteLocalAddress() Returns whether this address is a site-local address or not.
String	toString() Returns a string containing a concise, human-readable description of this IP address.

[Expand]

Inherited Methods

From class java.net.InetAddress

boolean	equals(Object obj) Compares this `InetAddress` instance against the specified address in `obj`.
byte[]	getAddress() Returns the IP address represented by this `InetAddress` instance as a byte array.
static InetAddress[]	getAllByName(String host) Gets all IP addresses associated with the given `host` identified by name or literal IP address.
static InetAddress	getByAddress(byte[] ipAddress) Returns the `InetAddress` corresponding to the array of bytes.
static InetAddress	getByAddress(String hostName, byte[] ipAddress) Returns the `InetAddress` corresponding to the array of bytes, and the given hostname.
static InetAddress	getByName(String host) Returns the address of a host according to the given host string name `host`.
String	getCanonicalHostName() Gets the fully qualified domain name for the host associated with this IP address.
String	getHostAddress() Gets the textual representation of this IP address.
String	getHostName() Gets the host name of this IP address.
static InetAddress	getLocalHost() Returns an `InetAddress` for the local host if possible, or the loopback address otherwise.
int	hashCode() Gets the hashcode of the represented IP address.
boolean	isAnyLocalAddress() Returns whether this is a wildcard address or not.
boolean	isLinkLocalAddress() Returns whether this address is a link-local address or not.
boolean	isLoopbackAddress() Returns whether this address is a loopback address or not.
boolean	isMCGlobal() Returns whether this address is a global multicast address or not.
boolean	isMCLinkLocal() Returns whether this address is a link-local multicast address or not.
boolean	isMCNodeLocal() Returns whether this address is a node-local multicast address or not.
boolean	isMCOrgLocal() Returns whether this address is a organization-local multicast address or not.
boolean	isMCSiteLocal() Returns whether this address is a site-local multicast address or not.
boolean	isMulticastAddress()
boolean	isReachable(int timeout) Tries to reach this `InetAddress`.
boolean	isReachable(NetworkInterface networkInterface, int ttl, int timeout) Tries to reach this `InetAddress`.
boolean	isSiteLocalAddress() Returns whether this address is a site-local address or not.
String	toString() Returns a string containing a concise, human-readable description of this IP address.

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Called before the object's memory is reclaimed by the VM.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Public Methods

public static Inet6Address getByAddress (String host, byte[] addr, int scope_id)

Since: API Level 1

Constructs an IPv6 address according to the given host, addr and scope_id.

Parameters

host	the host name associated with the address.
addr	the network address.
scope_id	the scope id for link- or site-local addresses.

Returns

the Inet6Address instance representing the IP address.

Throws

UnknownHostException	if the address is null or has an invalid length.

public static Inet6Address getByAddress (String host, byte[] addr, NetworkInterface nif)

Since: API Level 1

Gets an IPv6 address instance according to the given host, addr and nif. scope_id is set according to the given nif and the addr type (for example site-local or link-local).

Parameters

host	the hostname associated with the address.
addr	the network address.
nif	the network interface that this address is associated with.

Returns

the Inet6Address instance representing the IP address.

Throws

UnknownHostException	if the address is `null` or has an invalid length or the interface doesn't have a numeric scope id for the given address type.

public int getScopeId ()

Since: API Level 1

Gets the scope id as a number if this address is linked to an interface. Otherwise returns 0.

Returns

the scope_id of this address or 0 when not linked with an interface.

public NetworkInterface getScopedInterface ()

Since: API Level 1

Gets the network interface if this address is instanced with a scoped network interface. Otherwise returns null.

Returns

the scoped network interface of this address.

public boolean isAnyLocalAddress ()

Since: API Level 1

Returns whether this address is a unspecified wildcard address "::" or not.

Returns

true if this instance represents a wildcard address, false otherwise.

public boolean isIPv4CompatibleAddress ()

Since: API Level 1

Returns whether this address is IPv4 compatible or not. An IPv4 compatible address is prefixed with 96 bits of 0's. The last 32-bits are varied corresponding with the 32-bit IPv4 address space.

Returns

true if this instance represents an IPv4 compatible address, false otherwise.

public boolean isLinkLocalAddress ()

Since: API Level 1

Returns whether this address is a link-local address or not. A valid IPv6 link-local address is prefixed with 1111111010.

Returns

true if this instance represents a link-local address, false otherwise.

public boolean isLoopbackAddress ()

Since: API Level 1

Returns whether this address is the loopback address or not. The only valid IPv6 loopback address is "::1".

Returns

true if this instance represents the loopback address, false otherwise.

public boolean isMCGlobal ()

Since: API Level 1

Returns whether this address is a global multicast address or not. A valid IPv6 global multicast address is 11111111xxxx1110 or FF0E hex.

Returns

true if this instance represents a global multicast address, false otherwise.

public boolean isMCLinkLocal ()

Since: API Level 1

Returns whether this address is a link-local multicast address or not. A valid IPv6 link-local multicast address is prefixed with 11111111xxxx0010.

Returns

true if this instance represents a link-local multicast address, false otherwise.

public boolean isMCNodeLocal ()

Since: API Level 1

Returns whether this address is a node-local multicast address or not. A valid IPv6 node-local multicast address is prefixed with 11111111xxxx0001.

Returns

true if this instance represents a node-local multicast address, false otherwise.

public boolean isMCOrgLocal ()

Since: API Level 1

Returns whether this address is a organization-local multicast address or not. A valid IPv6 org-local multicast address is prefixed with 11111111xxxx1000.

Returns

true if this instance represents a org-local multicast address, false otherwise.

public boolean isMCSiteLocal ()

Since: API Level 1

Returns whether this address is a site-local multicast address or not. A valid IPv6 site-local multicast address is prefixed with 11111111xxxx0101.

Returns

true if this instance represents a site-local multicast address, false otherwise.

public boolean isMulticastAddress ()

Since: API Level 1

Returns whether this address is an IP multicast address or not. Valid IPv6 multicast addresses are binary prefixed with 11111111 or FF (hex).

Returns

true if this address is in the multicast group, false otherwise.

public boolean isSiteLocalAddress ()

Since: API Level 1

Returns whether this address is a site-local address or not. A valid IPv6 site-local address is prefixed with 1111111011.

Returns

true if this instance represents a site-local address, false otherwise.

public String toString ()

Since: API Level 1

Returns a string containing a concise, human-readable description of this IP address.

Returns

the description, as host/address.

Interfaces

Classes

Enums

Exceptions

Inet6Address

Class Overview

Summary

Public Methods

public static Inet6Address getByAddress (String host, byte[] addr, int scope_id)

Parameters

Returns

Throws

public static Inet6Address getByAddress (String host, byte[] addr, NetworkInterface nif)

Parameters

Returns

Throws

public int getScopeId ()

Returns

public NetworkInterface getScopedInterface ()

Returns

public boolean isAnyLocalAddress ()

Returns

public boolean isIPv4CompatibleAddress ()

Returns

public boolean isLinkLocalAddress ()

Returns

public boolean isLoopbackAddress ()

Returns

public boolean isMCGlobal ()

Returns

public boolean isMCLinkLocal ()

Returns

public boolean isMCNodeLocal ()

Returns

public boolean isMCOrgLocal ()

Returns

public boolean isMCSiteLocal ()

Returns

public boolean isMulticastAddress ()

Returns

public boolean isSiteLocalAddress ()

Returns

public String toString ()

Returns