Inet6Address (Java Platform SE 8 )

java.lang.Object
- java.net.InetAddress
- - java.net.Inet6Address

All Implemented Interfaces:: Serializable

public final class Inet6Address
extends InetAddress

该类表示Internet协议版本6（IPv6）地址。由RFC 2373: IP Version 6 Addressing Architecture定义。

Textual representation of IP addresses

用作方法输入的IPv6地址的文本表示采用以下形式之一：

The preferred form是x：x：x：x：x：x：x：x，其中x是地址的8个16位的十六进制值。这是完整的形式。例如，

1080:0:0:0:8:800:200C:417A

请注意，不必在单个字段中写入前导零。但是，除了下面所述外，每个字段中必须至少有一个数字。
由于一些分配某些类型的IPv6地址的方法，地址包含长字符串的零位将是常见的。为了使写入包含零位的地址更容易，可以使用特殊的语法来压缩零。使用“::”表示多组16位的零。 “::”只能在地址中出现一次。 “::”也可用于压缩地址中的前导和/或尾部零。例如，

1080::8:800:200C:417A

在处理IPv4和IPv6节点的混合环境时，有时更方便的替代形式是x：x：x：x：x：x：dddd，其中x是六个高阶16位的十六进制值，地址的位，而'd'是标准IPv4表示地址的四个低8位的十进制值，例如，

::FFFF:129.144.52.38

::129.144.52.38

其中“:: FFFF：dddd”和“:: dddd”分别是IPv4映射IPv6地址和IPv4兼容的IPv6地址的一般形式。请注意，IPv4部分必须是“dddd”形式。以下表格无效：

::FFFF:d.d.d

::FFFF:d.d

::d.d.d

::d.d

以下形式：

::FFFF:d

是有效的，但它是IPv4兼容IPv6地址的非常规表示形式，

::255.255.0.d

而“:: d”对应于通用IPv6地址“0：0：0：0：0：0：0：d”。

对于返回文本表示作为输出值的方法，使用完整的表单。 Inet6Address将返回整个表单，因为它与其他文本数据结合使用时是明确的。

特殊的IPv6地址

IPv4-mapped address Of the form::ffff:w.x.y.z, this IPv6 address is used to represent an IPv4 address. It allows the native program to use the same address data structure and also the same socket when communicating with both IPv4 and IPv6 nodes.
In InetAddress and Inet6Address, it is used for internal representation; it has no functional role. Java will never return an IPv4-mapped address. These classes can take an IPv4-mapped address as input, both in byte array and text representation. However, it will be converted into an IPv4 address.

IPv4-mapped address	Of the form::ffff:w.x.y.z, this IPv6 address is used to represent an IPv4 address. It allows the native program to use the same address data structure and also the same socket when communicating with both IPv4 and IPv6 nodes. In InetAddress and Inet6Address, it is used for internal representation; it has no functional role. Java will never return an IPv4-mapped address. These classes can take an IPv4-mapped address as input, both in byte array and text representation. However, it will be converted into an IPv4 address.

Textual representation of IPv6 scoped addresses

如上所述的IPv6地址的文本表示可以扩展到指定IPv6作用域地址。在[draft-ietf-ipngwg-scoping-arch-04.txt]中描述了对基本寻址架构的这种扩展。

由于链路本地和站点本地地址是非全局地址，因此不同的主机可能具有相同的目的地址，并且可能通过同一始发系统上的不同接口可达。在这种情况下，始发系统被称为连接到相同范围的多个区域。为了消除哪个是目的地区域，可以将一个区域标识符（或scope_id ）附加到IPv6地址。

用于指定scope_id一般格式如下：

IPv6-address% scope_id

如上所述，IPv6地址是一个文字的IPv6地址。 scope_id是指本地系统上的接口，可以通过两种方式指定。

作为数字标识符。 这必须是一个正整数，用于标识系统所理解的特定接口和范围。通常，数值可以通过系统上的管理工具确定。每个接口可以有多个值，每个范围一个。如果范围未指定，则使用的默认值为零。
作为一个字符串。 这必须是NetworkInterface.getName()针对特定接口返回的确切字符串。当以这种方式创建Inet6Address时，通过查询相关的NetworkInterface在创建对象时确定数字scope-id。

还要注意，可以从NetworkInterface类返回的Inet6Address实例检索数字scope_id 。这可以用于查找系统上配置的当前范围ID。

从以下版本开始：: 1.4
另请参见：: Serialized Form

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`boolean`	`equals(Object obj)` 将此对象与指定对象进行比较。
`byte[]`	`getAddress()` 返回此 `InetAddress`对象的原始IP地址。
`static Inet6Address`	`getByAddress(String host, byte[] addr, int scope_id)` 在的确切方式创建Inet6Address， `InetAddress.getByAddress(String,byte[])`不同之处在于将IPv6 scope_id设置为给定数值。
`static Inet6Address`	`getByAddress(String host, byte[] addr, NetworkInterface nif)` 在的确切方式创建Inet6Address， `InetAddress.getByAddress(String,byte[])`不同之处在于将IPv6 scope_id设置为对应于在指定的地址类型的给定接口的值 `addr` 。
`String`	`getHostAddress()` 返回文本显示中的IP地址字符串。
`NetworkInterface`	`getScopedInterface()` 如果此实例是使用范围界面创建的，则返回范围界面。
`int`	`getScopeId()` 如果此实例与接口相关联，则返回数字scopeId。
`int`	`hashCode()` 返回此IP地址的哈希码。
`boolean`	`isAnyLocalAddress()` 检查通配符地址中的InetAddress的实用程序。
`boolean`	`isIPv4CompatibleAddress()` 检查InetAddress是否与IPv4兼容的IPv6地址的实用程序。
`boolean`	`isLinkLocalAddress()` 检查InetAddress是否是链接本地地址的实用程序。
`boolean`	`isLoopbackAddress()` 检查InetAddress是否是一个环回地址的实用程序。
`boolean`	`isMCGlobal()` 检查多播地址是否具有全局范围的实用程序。
`boolean`	`isMCLinkLocal()` 检查组播地址是否具有链路范围的实用程序。
`boolean`	`isMCNodeLocal()` 检查多播地址是否具有节点范围的实用程序。
`boolean`	`isMCOrgLocal()` 检查组播地址是否具有组织范围的实用程序。
`boolean`	`isMCSiteLocal()` 检查多播地址是否具有站点范围的实用程序。
`boolean`	`isMulticastAddress()` 检查InetAddress是否是IP组播地址的实用程序。
`boolean`	`isSiteLocalAddress()` 检查InetAddress是否是站点本地地址的实用程序。

Methods inherited from class java.net.InetAddress
getAllByName, getByAddress, getByAddress, getByName, getCanonicalHostName, getHostName, getLocalHost, getLoopbackAddress, isReachable, isReachable, toString

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- 方法详细信息
  - getByAddress
```
public static Inet6Address getByAddress(String host,
                                        byte[] addr,
                                        NetworkInterface nif)
                                 throws UnknownHostException
```
    在的确切方式创建Inet6Address， InetAddress.getByAddress(String,byte[])不同之处在于将IPv6 scope_id设置为对应于在指定的地址类型的给定接口的值addr 。如果给定的接口没有为给定的地址类型（例如link-local或site-local）分配一个数字scope_id，那么调用将失败，并显示UnknownHostException。见here对IPv6的范围地址的描述。
    
    参数
    
    host - 指定的主机
    
    addr - 网络字节顺序中的原始IP地址
    
    nif - 这个地址必须关联的接口。
    
    结果
    
    从原始IP地址创建的Inet6Address对象。
    
    异常
    
    UnknownHostException - 如果IP地址为非法长度，或者接口没有为给定地址类型分配数字scope_id。
    
    从以下版本开始：
    
    1.5
  - getByAddress
```
public static Inet6Address getByAddress(String host,
                                        byte[] addr,
                                        int scope_id)
                                 throws UnknownHostException
```
    在的确切方式创建Inet6Address， InetAddress.getByAddress(String,byte[])不同之处在于将IPv6 scope_id设置为给定数值。不检查scope_id以确定它是否对应于系统上的任何接口。见here对IPv6的范围地址的描述。
    
    参数
    
    host - 指定的主机
    
    addr - 网络字节顺序中的原始IP地址
    
    scope_id - 地址的数值scope_id。
    
    结果
    
    从原始IP地址创建的Inet6Address对象。
    
    异常
    
    UnknownHostException - 如果IP地址是非法的长度。
    
    从以下版本开始：
    
    1.5
  - isMulticastAddress
```
public boolean isMulticastAddress()
```
    检查InetAddress是否是IP组播地址的实用程序。 11111111在地址开头将该地址标识为多播地址。
    
    重写：
    
    isMulticastAddress在 InetAddress
    
    结果
    
    一个 boolean InetAddress是否是一个IP组播地址
    
    从以下版本开始：
    
    JDK1.1
  - isAnyLocalAddress
```
public boolean isAnyLocalAddress()
```
    检查通配符地址中的InetAddress的实用程序。
    
    重写：
    
    isAnyLocalAddress在 InetAddress
    
    结果
    
    一个 boolean Inetaddress是否是通配符地址。
    
    从以下版本开始：
    
    1.4
  - isLoopbackAddress
```
public boolean isLoopbackAddress()
```
    检查InetAddress是否是一个环回地址的实用程序。
    
    重写：
    
    isLoopbackAddress在 InetAddress
    
    结果
    
    一个boolean InetAddress是否是一个环回地址; 否则为false。
    
    从以下版本开始：
    
    1.4
  - isLinkLocalAddress
```
public boolean isLinkLocalAddress()
```
    检查InetAddress是否是链接本地地址的实用程序。
    
    重写：
    
    isLinkLocalAddress在类 InetAddress
    
    结果
    
    一个boolean InetAddress是否是链路本地地址; 如果地址不是链路本地单播地址，则为false。
    
    从以下版本开始：
    
    1.4
  - isSiteLocalAddress
```
public boolean isSiteLocalAddress()
```
    检查InetAddress是否是站点本地地址的实用程序。
    
    重写：
    
    isSiteLocalAddress在 InetAddress
    
    结果
    
    一个boolean InetAddress是否是站点本地地址; 如果地址不是站点本地单播地址，则为false。
    
    从以下版本开始：
    
    1.4
  - isMCGlobal
```
public boolean isMCGlobal()
```
    检查多播地址是否具有全局范围的实用程序。
    
    重写：
    
    isMCGlobal在 InetAddress
    
    结果
    
    一个 boolean指示地址是否是全局范围的多播地址，如果不是全局范围，则为false，或者不是多播地址
    
    从以下版本开始：
    
    1.4
  - isMCNodeLocal
```
public boolean isMCNodeLocal()
```
    检查多播地址是否具有节点范围的实用程序。
    
    重写：
    
    isMCNodeLocal在 InetAddress
    
    结果
    
    一个 boolean指示地址是否是节点本地作用域的多播地址，如果不是节点本地作用域，则为false，或者不是多播地址
    
    从以下版本开始：
    
    1.4
  - isMCLinkLocal
```
public boolean isMCLinkLocal()
```
    检查组播地址是否具有链路范围的实用程序。
    
    重写：
    
    isMCLinkLocal在 InetAddress
    
    结果
    
    一个 boolean指示地址是否是链路本地范围的多播地址，如果不是链路本地作用域，或者它不是多播地址，则为false
    
    从以下版本开始：
    
    1.4
  - isMCSiteLocal
```
public boolean isMCSiteLocal()
```
    检查多播地址是否具有站点范围的实用程序。
    
    重写：
    
    isMCSiteLocal在 InetAddress
    
    结果
    
    一个 boolean指示地址是否是站点本地范围的多播地址，如果不是站点本地范围，则为false，或者不是多播地址
    
    从以下版本开始：
    
    1.4
  - isMCOrgLocal
```
public boolean isMCOrgLocal()
```
    检查组播地址是否具有组织范围的实用程序。
    
    重写：
    
    isMCOrgLocal在 InetAddress
    
    结果
    
    一个 boolean指示地址是否是组织本地作用域的组播地址，如果不是组织本地作用域，或者它不是组播地址，则为false
    
    从以下版本开始：
    
    1.4
  - getAddress
```
public byte[] getAddress()
```
    返回此InetAddress对象的原始IP地址。结果是网络字节顺序：地址的最高位字节在getAddress()[0] 。
    
    重写：
    
    getAddress在 InetAddress
    
    结果
    
    该对象的原始IP地址。
  - getScopeId
```
public int getScopeId()
```
    如果此实例与接口相关联，则返回数字scopeId。如果没有设置scoped_id，返回值为零。
    
    结果
    
    scopeId，如果未设置，则为零。
    
    从以下版本开始：
    
    1.5
  - getScopedInterface
```
public NetworkInterface getScopedInterface()
```
    如果此实例是使用范围界面创建的，则返回范围界面。
    
    结果
    
    范围界面，如果未设置则为null。
    
    从以下版本开始：
    
    1.5
  - getHostAddress
```
public String getHostAddress()
```
    返回文本显示中的IP地址字符串。如果创建的实例指定了作用域标识符，则将作用域ID附加到以“％”（百分号）字符前面的IP地址中。这可以是数值或字符串，具体取决于用于创建实例的值。
    
    重写：
    
    getHostAddress在 InetAddress
    
    结果
    
    原始IP地址为字符串格式。
  - hashCode
```
public int hashCode()
```
    返回此IP地址的哈希码。
    
    重写：
    
    hashCode在 InetAddress
    
    结果
    
    该IP地址的哈希码值。
    
    另请参见：
    
    Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)
  - equals
```
public boolean equals(Object obj)
```
    将此对象与指定对象进行比较。结果是true当且仅当参数不是null并且它代表与该对象相同的IP地址。
    InetAddress的InetAddress实例表示相同的IP地址，如果由getAddress返回的字节数组的长度相同，并且每个数组组件对于字节数组是相同的。
    
    重写：
    
    equals在 InetAddress
    
    参数
    
    obj - 要比较的对象。
    
    结果
    
    true如果对象相同; false否则。
    
    另请参见：
    
    InetAddress.getAddress()
  - isIPv4CompatibleAddress
```
public boolean isIPv4CompatibleAddress()
```
    检查InetAddress是否与IPv4兼容的IPv6地址的实用程序。
    
    结果
    
    一个boolean InetAddress是否是IPv4兼容的IPv6地址; 如果地址是IPv4地址，则为false。
    
    从以下版本开始：
    
    1.4

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class Inet6Address

Textual representation of IP addresses

特殊的IPv6地址

Textual representation of IPv6 scoped addresses

方法摘要

Methods inherited from class java.net.InetAddress

Methods inherited from class java.lang.Object

方法详细信息

getByAddress

getByAddress

isMulticastAddress

isAnyLocalAddress

isLoopbackAddress

isLinkLocalAddress

isSiteLocalAddress

isMCGlobal

isMCNodeLocal

isMCLinkLocal

isMCSiteLocal

isMCOrgLocal

getAddress

getScopeId

getScopedInterface

getHostAddress

hashCode

equals

isIPv4CompatibleAddress