NetworkInterface

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.net
类 NetworkInterface

java.lang.Object
  java.net.NetworkInterface

public final class NetworkInterface
extends Object
extends Object

此类表示一个由名称和分配给此接口的 IP 地址列表组成的网络接口。它用于标识将多播组加入的本地接口。接口通常是按名称（如 "le0"）区分的。

从以下版本开始：: 1.4

方法摘要
`boolean`	`equals(Object obj)` 将此对象与指定对象比较。
`static NetworkInterface`	`getByInetAddress(InetAddress addr)` 搜索绑定了指定 Internet 协议 (IP) 地址的网络接口的便捷方法。
`static NetworkInterface`	`getByName(String name)` 搜索具有指定名称的网络接口。
`String`	`getDisplayName()` 获取此网络接口的显示名称。
`Enumeration<InetAddress>`	`getInetAddresses()` 返回一个 Enumeration 并将所有 InetAddress 或 InetAddress 的子集绑定到此网络接口的便捷方法。
`String`	`getName()` 获取此网络接口的名称。
`static Enumeration<NetworkInterface>`	`getNetworkInterfaces()` 返回此机器上的所有接口。
`int`	`hashCode()` 返回该对象的哈希码值。
`String`	`toString()` 返回该对象的字符串表示。

从类 java.lang.Object 继承的方法
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

方法详细信息

getName

public String getName()

获取此网络接口的名称。

返回：: 此网络接口的名称

getInetAddresses

public Enumeration<InetAddress> getInetAddresses()

返回一个 Enumeration 并将所有 InetAddress 或 InetAddress 的子集绑定到此网络接口的便捷方法。

如果有安全管理器，则为每个 InetAddress 调用其 checkConnect 方法。仅在 Enumeration 中返回 checkConnect 不抛出 SecurityException 的 InetAddress。

返回：: 一个 Enumeration 对象，将所有 InetAddress 或 InetAddress 的子集绑定到此网络接口

getDisplayName

public String getDisplayName()

获取此网络接口的显示名称。显示名称是描述网络设备的人可读的 (human readable) String。

返回：: 此网络接口的显示名称；如果不存在可用的显示名称，则返回 null。

getByName

public static NetworkInterface getByName(String name)
                                  throws SocketException

搜索具有指定名称的网络接口。

参数：: name - 网络接口的名称。
返回：: 具有指定名称的 NetworkInterface；如果不存在具有指定名称的网络接口，则返回 null。
抛出：: SocketException - 如果发生 I/O 错误。; NullPointerException - 如果指定的名称为 null。

getByInetAddress

public static NetworkInterface getByInetAddress(InetAddress addr)
                                         throws SocketException

搜索绑定了指定 Internet 协议 (IP) 地址的网络接口的便捷方法。

如果指定的 IP 地址被绑定到多个网络接口，则返回哪个网络接口是不确定的。

参数：: addr - 用于搜索的 InetAddress。
返回：: NetworkInterface；如果不存在具有指定 IP 地址的网络接口，则返回 null。
抛出：: SocketException - 如果发生 I/O 错误。; NullPointerException - 如果指定的地址为 null。

getNetworkInterfaces

public static Enumeration<NetworkInterface> getNetworkInterfaces()
                                                          throws SocketException

返回此机器上的所有接口。如果在此机器上找不到任何网络接口，则返回 null。注：可以使用 getNetworkInterfaces()+getInetAddresses() 来获取此节点的所有 IP 地址

返回：: 在此机器上找到的 NetworkInterface 的 Enumeration
抛出：: SocketException - 如果发生 I/O 错误。

equals

public boolean equals(Object obj)

将此对象与指定对象比较。当且仅当参数不为 null，并且它表示与此对象相同的 NetworkInterface 时，结果才为 true。

如果 NetworkInterface 的两个实例的名称和地址都相同，则它们表示相同的 NetworkInterface。

覆盖：: 类 Object 中的 equals

参数：: obj - 要与之比较的对象。
返回：: 如果对象相同，则返回 true；否则，返回 false。
另请参见：: InetAddress.getAddress()

hashCode

public int hashCode()

从类 Object 复制的描述

返回该对象的哈希码值。支持该方法是为哈希表提供一些优点，例如，java.util.Hashtable 提供的哈希表。

hashCode 的常规协定是：

在 Java 应用程序执行期间，在同一对象上多次调用 hashCode 方法时，必须一致地返回相同的整数，前提是对象上 equals 比较中所用的信息没有被修改。从某一应用程序的一次执行到同一应用程序的另一次执行，该整数无需保持一致。
如果根据 equals(Object) 方法，两个对象是相等的，那么在两个对象中的每个对象上调用 hashCode 方法都必须生成相同的整数结果。
以下情况不是必需的：如果根据 Object.equals(java.lang.Object) 方法，两个对象不相等，那么在两个对象中的任一对象上调用 hashCode 方法必定会生成不同的整数结果。但是，程序员应该知道，为不相等的对象生成不同整数结果可以提高哈希表的性能。

实际上，由 Object 类定义的 hashCode 方法确实会针对不同的对象返回不同的整数。（这一般是通过将该对象的内部地址转换成一个整数来实现的，但是 Java^TM 编程语言不需要这种实现技巧。）

覆盖：: 类 Object 中的 hashCode

返回：: 此对象的一个哈希码值。
另请参见：: Object.equals(java.lang.Object), Hashtable

toString

public String toString()