NetworkInterface (Java Platform SE 8 )

java.lang.Object
- java.net.NetworkInterface

```
public final class NetworkInterface
extends Object
```
这个类表示由一个名称组成的网络接口，以及一个分配给该接口的IP地址列表。它被用来确定一个多播组加入的本地接口。接口通常被称为“LE0”。

从以下版本开始：

一点四

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`boolean`	`equals(Object obj)` 将此对象与指定的对象进行比较。
`static NetworkInterface`	`getByIndex(int index)` 给出一个给定索引的网络接口。
`static NetworkInterface`	`getByInetAddress(InetAddress addr)` 方便的方法来搜索一个网络接口，该接口有指定的因特网协议（IP）地址绑定到它。
`static NetworkInterface`	`getByName(String name)` 用指定名称搜索网络接口。
`String`	`getDisplayName()` 获取此网络接口的显示名称。
`byte[]`	`getHardwareAddress()` 返回接口的硬件地址（通常是麦克），如果它有一个，如果它可以访问给定的当前权限。
`int`	`getIndex()` 返回此网络接口的索引。
`Enumeration<InetAddress>`	`getInetAddresses()` 返回的所有或inetaddresses绑定到该网络接口的子集枚举的便捷方法。
`List<InterfaceAddress>`	`getInterfaceAddresses()` 得到一个列表中的所有或此网络接口的 `InterfaceAddresses`子集。
`int`	`getMTU()` 返回最大传输单元（MTU）这个接口。
`String`	`getName()` 获取此网络接口的名称。
`static Enumeration<NetworkInterface>`	`getNetworkInterfaces()` 返回此机器上的所有接口。
`NetworkInterface`	`getParent()` 如果这是一个接口返回该接口网络接口 `null`母，或如果它是一个物理（非虚拟的）接口或没有父。
`Enumeration<NetworkInterface>`	`getSubInterfaces()` 所有的子接口获取枚举（也称为虚拟接口）连接到这个网络接口。
`int`	`hashCode()` 返回一个对象的哈希代码值。
`boolean`	`isLoopback()` 返回是否网络接口是一个环回接口。
`boolean`	`isPointToPoint()` 返回一个网络接口是否是一个点对点接口。
`boolean`	`isUp()` 返回一个网络接口是否运行和运行。
`boolean`	`isVirtual()` 返回是否该接口是一种虚拟接口（也叫接口）。
`boolean`	`supportsMulticast()` 返回一个网络接口是否支持多播。
`String`	`toString()` 返回对象的字符串表示形式。

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

- 方法详细信息
  - getName
```
public String getName()
```
    获取此网络接口的名称。
    
    结果
    
    这个网络接口的名称
  - getInetAddresses
```
public Enumeration<InetAddress> getInetAddresses()
```
    返回的所有或inetaddresses绑定到该网络接口的子集枚举的便捷方法。
    如果存在安全管理器，它的checkConnect方法为每一个它。只有inetaddresses在checkConnect不抛出SecurityException将返回的枚举。然而，如果对方有NetPermission（“getnetworkinformation”）的许可，那么所有的inetaddresses返回。
    
    结果
    
    所有的inetaddresses或绑定到该网络接口的子集枚举对象
  - getInterfaceAddresses
```
public List<InterfaceAddress> getInterfaceAddresses()
```
    得到一个列表中的所有或此网络接口的 InterfaceAddresses子集。
    如果存在安全管理器，它的checkConnect方法称为每个interfaceaddress InetAddress。只有interfaceaddresses在checkConnect不引发SecurityException将返回列表中。
    
    结果
    
    与所有和此网络接口的interfaceaddresss子集 List对象
    
    从以下版本开始：
    
    一点六
  - getSubInterfaces
```
public Enumeration<NetworkInterface> getSubInterfaces()
```
    所有的子接口获取枚举（也称为虚拟接口）连接到这个网络接口。
    例如eth0:1将子接口是。
    
    结果
    
    所有此网络接口的子接口枚举对象
    
    从以下版本开始：
    
    一点六
  - getParent
```
public NetworkInterface getParent()
```
    如果这是一个接口返回该接口网络接口 null母，或如果它是一个物理（非虚拟的）接口或没有父。
    
    结果
    
    的 NetworkInterface此接口连接到。
    
    从以下版本开始：
    
    一点六
  - getIndex
```
public int getIndex()
```
    返回此网络接口的索引。该指数是一个大于或等于零的整数，或 -1未知。这是一个具有相同名称的系统的特定值和接口可以在不同的机器上有不同的索引。
    
    结果
    
    此网络接口或 -1指数如果指数是未知的
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    getByIndex(int)
  - getDisplayName
```
public String getDisplayName()
```
    获取此网络接口的显示名称。显示名称是描述网络设备的人类可读的字符串。
    
    结果
    
    表示此网络接口的显示名称的非空字符串，如果没有可用的显示名称，则为空字符串。
  - getByName
```
public static NetworkInterface getByName(String name)
                                  throws SocketException
```
    用指定名称搜索网络接口。
    
    参数
    
    name -网络接口的名称。
    
    结果
    
    具有指定名称的 NetworkInterface，或 null如果没有指定名称的网络接口。
    
    异常
    
    SocketException如果I/O错误发生。
    
    NullPointerException -如果指定的名称 null。
  - getByIndex
```
public static NetworkInterface getByIndex(int index)
                                   throws SocketException
```
    给出一个给定索引的网络接口。
    
    参数
    
    index -一个整数，该接口的指标
    
    结果
    
    从指标得到的网络接口，或 null如果有这样一个指标对系统没有接口
    
    异常
    
    SocketException如果I/O错误发生。
    
    IllegalArgumentException如果指数为负值
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    getIndex()
  - getByInetAddress
```
public static NetworkInterface getByInetAddress(InetAddress addr)
                                         throws SocketException
```
    方便的方法来搜索一个网络接口，该接口有指定的因特网协议（IP）地址绑定到它。
    如果指定的IP地址绑定到多个网络接口，则未返回网络接口的定义。
    
    参数
    
    addr - InetAddress搜索。
    
    结果
    
    一个 NetworkInterface或 null如果有指定的IP地址没有网络接口。
    
    异常
    
    SocketException如果I/O错误发生。
    
    NullPointerException -如果指定的地址是 null。
  - getNetworkInterfaces
```
public static Enumeration<NetworkInterface> getNetworkInterfaces()
                                                          throws SocketException
```
    返回此机器上的所有接口。的 Enumeration至少包含一个元素，可能代表一个仅支持本机的实体之间的通信端口。注：可以使用getnetworkinterfaces() + getinetaddresses()获得所有IP地址为该节点
    
    结果
    
    枚举网络接口在本机上发现的
    
    异常
    
    SocketException如果I/O错误发生。
  - isUp
```
public boolean isUp()
             throws SocketException
```
    返回一个网络接口是否运行和运行。
    
    结果
    
    true如果界面是启动和运行。
    
    异常
    
    SocketException如果I/O错误发生。
    
    从以下版本开始：
    
    一点六
  - isLoopback
```
public boolean isLoopback()
                   throws SocketException
```
    返回是否网络接口是一个环回接口。
    
    结果
    
    true如果界面是环回接口。
    
    异常
    
    SocketException如果I/O错误发生。
    
    从以下版本开始：
    
    一点六
  - isPointToPoint
```
public boolean isPointToPoint()
                       throws SocketException
```
    返回一个网络接口是否是一个点对点接口。一个典型的点对点接口将是一个通过调制解调器的一个购买力平价连接。
    
    结果
    
    true如果接口是点接口点。
    
    异常
    
    SocketException如果I/O错误发生。
    
    从以下版本开始：
    
    一点六
  - supportsMulticast
```
public boolean supportsMulticast()
                          throws SocketException
```
    返回一个网络接口是否支持多播。
    
    结果
    
    true如果接口支持多播。
    
    异常
    
    SocketException如果I/O错误发生。
    
    从以下版本开始：
    
    一点六
  - getHardwareAddress
```
public byte[] getHardwareAddress()
                          throws SocketException
```
    返回接口的硬件地址（通常是麦克），如果它有一个，如果它可以访问给定的当前权限。如果安全管理器设置，然后调用方必须拥有的权限 NetPermission（“getnetworkinformation”）。
    
    结果
    
    一个包含地址的字节数组，或 null如果地址不存在，无法访问或安全经理设置和调用方没有许可netpermission（“getnetworkinformation”）
    
    异常
    
    SocketException如果I/O错误发生。
    
    从以下版本开始：
    
    一点六
  - getMTU
```
public int getMTU()
           throws SocketException
```
    返回最大传输单元（MTU）这个接口。
    
    结果
    
    此接口的MTU值。
    
    异常
    
    SocketException如果I/O错误发生。
    
    从以下版本开始：
    
    一点六
  - isVirtual
```
public boolean isVirtual()
```
    返回是否该接口是一种虚拟接口（也叫接口）。虚拟接口，在某些系统上，创造一个物理接口的孩子，给予不同的设置界面（如地址或MTU）。通常的接口的名称将由一个结肠（：）和一个数字识别孩子的名字，因为可以有几个虚拟接口连接到一个单一的物理接口。
    
    结果
    
    true如果这个接口是一种虚拟接口。
    
    从以下版本开始：
    
    一点六
  - equals
```
public boolean equals(Object obj)
```
    将此对象与指定的对象进行比较。其结果是 true如果只有参数不 null它代表相同的网络接口为对象。
    对NetworkInterface两实例表示相同的网络接口的名称和地址是否都是相同的。
    
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    obj -比较的对象。
    
    结果
    
    true如果对象是相同的； false否则。
    
    另请参见：
    
    InetAddress.getAddress()
  - hashCode
```
public int hashCode()
```
    从阶级复制的描述： Object
    返回一个对象的哈希代码值。这种方法对于hash表，如所提供的 HashMap效益的支持。
    对hashCode一般合同：
    - 不管是调用同一对象的多一个java应用程序执行期间，该hashCode方法总是返回相同的整数，没有提供信息用于equals比较的对象被修改。这个整数不需要保持一致，从一个应用程序的一个执行到另一个执行相同的应用程序。
    - 如果根据equals(Object)法两个对象是相等的，那么调用hashCode方法每一个对象必须产生相同的整数结果。
    - 它不是必需的，如果按照Object.equals(java.lang.Object)法两个对象是不平等的，然后调用hashCode方法每一个对象必须产生不同的整数结果。然而，程序员应该意识到，产生不同的整数结果的不平等的对象可能会提高哈希表的性能。
    尽合理的切实可行，由类Object定义hashCode方法返回不同的对象不同的整数。（这通常是通过将该对象的内部地址转换成一个整数，但这不是实现实现技术的™java编程语言。要求）
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    此对象的哈希代码值。
    
    另请参见：
    
    Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    从阶级复制的描述： Object
    返回对象的字符串表示形式。总的来说，这 toString方法返回一个字符串，“以文本方式表示”这个对象。其结果应该是一个简洁，但翔实的代表性，是一个容易阅读的人。建议所有子类都重写此方法。
    Object类的toString方法返回一个包含该类的对象是一个实例的名称字符串的符号` @ '，和符号进制表示的对象的哈希码。换句话说，此方法返回一个等于值的字符串：
    getClass().getName() + '@' + Integer.toHexString(hashCode())
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    对象的字符串表示形式。

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 NetworkInterface

方法摘要

Methods inherited from class java.lang.Object

方法详细信息

getName

getInetAddresses

getInterfaceAddresses

getSubInterfaces

getParent

getIndex

getDisplayName

getByName

getByIndex

getByInetAddress

getNetworkInterfaces

isUp

isLoopback

isPointToPoint

supportsMulticast

getHardwareAddress

getMTU

isVirtual

equals

hashCode

toString