java.net.NetworkInterface翻译

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<HTML>

<HEAD>

<TITLE>

NetworkInterface (Java 2 Platform SE v1.4.2)

</TITLE>

function windowTitle()

{

parent.document.title="NetworkInterface (Java 2 Platform SE v1.4.2)";

}

</SCRIPT>

</HEAD>

<TR>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../overview-summary.html">Overview</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html">Package</A> </TD>

<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev">  Class </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html">Deprecated</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-files/index-1.html">Index</A> </TD>

</TR>

</TABLE>

</TD>

JavaTM 2 Platform Std. Ed. v1.4.2

</TD>

</TR>

<TR>

<A HREF="../../java/net/NetPermission.html" title="class in java.net">PREV CLASS</A>

<A HREF="../../java/net/PasswordAuthentication.html" title="class in java.net">NEXT CLASS</A></TD>

<A HREF="../../index.html" target="_top">FRAMES</A>

<A HREF="NetworkInterface.html" target="_top">NO FRAMES</A>

<!--

if(window==top) {

document.writeln('<A HREF="../../allclasses-noframe.html">All Classes</A>');

}

//-->

</SCRIPT>

<A HREF="../../allclasses-noframe.html">All Classes</A>

</NOSCRIPT>

</TD>

</TR>

<TR>

SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></TD>

DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></TD>

</TR>

</TABLE>

<HR>

<H2>

java.net

Class NetworkInterface</H2>

<PRE>

<A HREF="../../java/lang/Object.html" title="class in java.lang">java.lang.Object</A>

<IMG SRC="../../resources/inherit.gif" ALT="extended by">java.net.NetworkInterface

</PRE>

<HR>

<DL>

<DT>public final class NetworkInterface<DT>extends <A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></DL>

This class represents a Network Interface made up of a name,

and a list of IP addresses assigned to this interface.

It is used to identify the local interface on which a multicast group

is joined.

Interfaces are normally known by names such as "le0".

该类表示由名称表示的网络接口及其分配给此接口的IP地址列表，用于标识加入多播组的本地接口。

借口一般使用名称如“le0”。

<DL>

<DT>Since:</DT>

</DL>

<HR>

Method Summary</TD>

</TR>

<CODE> boolean</CODE></TD>

<TD><CODE><A HREF="../../java/net/NetworkInterface.html#equals(java.lang.Object)">equals</A>(<A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A> obj)</CODE>

          Compares this object against the specified object.

将该对象与指定对象比较。</TD>

</TR>

<CODE>static <A HREF="../../java/net/NetworkInterface.html" title="class in java.net">NetworkInterface</A></CODE></TD>

<TD><CODE><A HREF="../../java/net/NetworkInterface.html#getByInetAddress(java.net.InetAddress)">getByInetAddress</A>(<A HREF="../../java/net/InetAddress.html" title="class in java.net">InetAddress</A> addr)</CODE>

          Convenience method to search for a network interface that

has the specified Internet Protocol (IP) address bound to

it.

查找被绑定到指定IP地址的网络接口的便捷方法。</TD>

</TR>

<CODE>static <A HREF="../../java/net/NetworkInterface.html" title="class in java.net">NetworkInterface</A></CODE></TD>

<TD><CODE><A HREF="../../java/net/NetworkInterface.html#getByName(java.lang.String)">getByName</A>(<A HREF="../../java/lang/String.html" title="class in java.lang">String</A> name)</CODE>

          Searches for the network interface with the specified name.

查找指定名称的网络接口的便捷方法。</TD>

</TR>

<CODE> <A HREF="../../java/lang/String.html" title="class in java.lang">String</A></CODE></TD>

<TD><CODE><A HREF="../../java/net/NetworkInterface.html#getDisplayName()">getDisplayName</A>()</CODE>

          Get the display name of this network interface.

获得此网络接口的显示名称。</TD>

</TR>

<CODE> <A HREF="../../java/util/Enumeration.html" title="interface in java.util">Enumeration</A></CODE></TD>

<TD><CODE><A HREF="../../java/net/NetworkInterface.html#getInetAddresses()">getInetAddresses</A>()</CODE>

          Convenience method to return an Enumeration with all or a

subset of the InetAddresses bound to this network interface.

返回绑定到此网络接口的所有InetAddresse或子集的便捷方法。</TD>

</TR>

<CODE> <A HREF="../../java/lang/String.html" title="class in java.lang">String</A></CODE></TD>

<TD><CODE><A HREF="../../java/net/NetworkInterface.html#getName()">getName</A>()</CODE>

          Get the name of this network interface.

获得此网络接口的名称。</TD>

</TR>

<CODE>static <A HREF="../../java/util/Enumeration.html" title="interface in java.util">Enumeration</A></CODE></TD>

<TD><CODE><A HREF="../../java/net/NetworkInterface.html#getNetworkInterfaces()">getNetworkInterfaces</A>()</CODE>

          Returns all the interfaces on this machine.

返回此机器的所有接口。</TD>

</TR>

<TD><CODE><A HREF="../../java/net/NetworkInterface.html#hashCode()">hashCode</A>()</CODE>

          Returns a hash code value for the object.

返回该对象的hash码值。</TD>

</TR>

<CODE> <A HREF="../../java/lang/String.html" title="class in java.lang">String</A></CODE></TD>

<TD><CODE><A HREF="../../java/net/NetworkInterface.html#toString()">toString</A>()</CODE>

          Returns a string representation of the object.

返回该对象的字符串形式。</TD>

</TR>

</TABLE>

<TD>Methods inherited from class java.lang.<A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></TD>

</TR>

<TD><CODE><A HREF="../../java/lang/Object.html#clone()">clone</A>, <A HREF="../../java/lang/Object.html#finalize()">finalize</A>, <A HREF="../../java/lang/Object.html#getClass()">getClass</A>, <A HREF="../../java/lang/Object.html#notify()">notify</A>, <A HREF="../../java/lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="../../java/lang/Object.html#wait()">wait</A>, <A HREF="../../java/lang/Object.html#wait(long)">wait</A>, <A HREF="../../java/lang/Object.html#wait(long, int)">wait</A></CODE></TD>

</TR>

</TABLE>

Method Detail</TD>

</TR>

</TABLE>

getName</H3>

<PRE>

public <A HREF="../../java/lang/String.html" title="class in java.lang">String</A> getName()</PRE>

<DL>

<DD>Get the name of this network interface.

获得此网络接口的名称。

<DT>Returns:<DD>the name of this network interface 此网络接口的名称</DL>

</DD>

</DL>

<HR>

getInetAddresses</H3>

<PRE>

public <A HREF="../../java/util/Enumeration.html" title="interface in java.util">Enumeration</A> getInetAddresses()</PRE>

<DL>

<DD>Convenience method to return an Enumeration with all or a

subset of the InetAddresses bound to this network interface.

返回绑定到此网络接口的所有InetAddresse或子集的便捷方法。

If there is a security manager, its <code>checkConnect</code>

method is called for each InetAddress. Only InetAddresses where

the <code>checkConnect</code> doesn't throw a SecurityException

will be returned in the Enumeration.

如果存在安全管理器，对每个地址调用checkConnect方法，只有checkConnect不抛出SecurityException，才会在枚举中返回。

<DT>Returns:<DD>an Enumeration object with all or a subset of the InetAddresses

bound to this network interface 绑定到此网络接口的所有InetAddresse或子集的便捷方法。</DL>

</DD>

</DL>

<HR>

getDisplayName</H3>

<PRE>

public <A HREF="../../java/lang/String.html" title="class in java.lang">String</A> getDisplayName()</PRE>

<DL>

<DD>Get the display name of this network interface.

A display name is a human readable String describing the network

device.

获得此网络接口的显示名称。显示名称是指描述网络设备的可读字符串。

<DT>Returns:<DD>the display name of this network interface,

or null if no display name is available. 此网络接口的显示名称，如果没有可用的显示名称，返回null。</DL>

</DD>

</DL>

<HR>

getByName</H3>

<PRE>

public static <A HREF="../../java/net/NetworkInterface.html" title="class in java.net">NetworkInterface</A> getByName(<A HREF="../../java/lang/String.html" title="class in java.lang">String</A> name)

throws <A HREF="../../java/net/SocketException.html" title="class in java.net">SocketException</A></PRE>

<DL>

<DD>Searches for the network interface with the specified name.

查找指定名称的网络接口的便捷方法。

<DT>Parameters:<DD><CODE>name</CODE> - The name of the network interface. 网络接口的名称。

<DT>Returns:<DD>A <tt>NetworkInterface</tt> with the specified name,

or <tt>null</tt> if there is no network interface

with the specified name. 指定名称的网络接口，如果没有指定名称的网络接口，返回null。

<DT>Throws:

<DD><CODE><A HREF="../../java/net/SocketException.html" title="class in java.net">SocketException</A></CODE> - If an I/O error occurs. 如果I/O错误发生则抛出。

<DD><CODE><A HREF="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</A></CODE> - If the specified name is <tt>null</tt>. 如果指定的地址为null，则抛出。</DL>

</DD>

</DL>

<HR>

getByInetAddress</H3>

<PRE>

public static <A HREF="../../java/net/NetworkInterface.html" title="class in java.net">NetworkInterface</A> getByInetAddress(<A HREF="../../java/net/InetAddress.html" title="class in java.net">InetAddress</A> addr)

throws <A HREF="../../java/net/SocketException.html" title="class in java.net">SocketException</A></PRE>

<DL>

<DD>Convenience method to search for a network interface that

has the specified Internet Protocol (IP) address bound to

it.

查找被绑定到指定IP地址的网络接口的便捷方法。

If the specified IP address is bound to multiple network

interfaces it is not defined which network interface is

returned.

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

<DT>Parameters:<DD><CODE>addr</CODE> - The <tt>InetAddress</tt> to search with. 要查找的InetAddress。

<DT>Returns:<DD>A <tt>NetworkInterface</tt>

or <tt>null</tt> if there is no network interface

with the specified IP address.

返回网络接口，如果指定的IP地址没有网络接口，返回null。

<DT>Throws:

<DD><CODE><A HREF="../../java/net/SocketException.html" title="class in java.net">SocketException</A></CODE> - If an I/O error occurs. 如果I/O错误发生则抛出。

<DD><CODE><A HREF="../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</A></CODE> - If the specified address is <tt>null</tt>. 如果指定的地址为null，则抛出。</DL>

</DD>

</DL>

<HR>

getNetworkInterfaces</H3>

<PRE>

public static <A HREF="../../java/util/Enumeration.html" title="interface in java.util">Enumeration</A> getNetworkInterfaces()

throws <A HREF="../../java/net/SocketException.html" title="class in java.net">SocketException</A></PRE>

<DL>

<DD>Returns all the interfaces on this machine. Returns null if no

network interfaces could be found on this machine.

NOTE: can use getNetworkInterfaces()+getInetAddresses()

to obtain all IP addresses for this node

返回此机器的所有接口。如果在此机器上找不到网络接口返回null。

注意：可以使用getNetworkInterfaces()+getInetAddresses() 来获取此节点的所有IP地址。

<DT>Returns:<DD>an Enumeration of NetworkInterfaces found on this machine 在此机器上找到的网络接口的枚举

<DT>Throws:

<DD><CODE><A HREF="../../java/net/SocketException.html" title="class in java.net">SocketException</A></CODE> - if an I/O error occurs. 如果I/O错误发生则抛出。</DL>

</DD>

</DL>

<HR>

equals</H3>

<PRE>

public boolean equals(<A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A> obj)</PRE>

<DL>

<DD>Compares this object against the specified object.

The result is <code>true</code> if and only if the argument is

not <code>null</code> and it represents the same NetworkInterface

as this object.

将该对象与指定对象比较。只有参数不为null，且同此对象表示相同的网络接口才返回true。

Two instances of <code>NetworkInterface</code> represent the same

NetworkInterface if both name and addrs are the same for both.

如果名称和地址都相同，两个NetworkInterface实例才表示相同的网络接口。

<DT>Overrides:<DD><CODE><A HREF="../../java/lang/Object.html#equals(java.lang.Object)">equals</A></CODE> in class <CODE><A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></CODE></DL>

</DD>

<DT>Parameters:<DD><CODE>obj</CODE> - the object to compare against. 要比较的对象。

<DT>Returns:<DD><code>true</code> if the objects are the same;

<code>false</code> otherwise. 如果对象相同，返回true，否则为false。<DT>See Also:<DD><A HREF="../../java/net/InetAddress.html#getAddress()"><CODE>InetAddress.getAddress()</CODE></A></DL>

</DD>

</DL>

<HR>

hashCode</H3>

<PRE>

public int hashCode()</PRE>

<DL>

<DD>Description copied from class: <CODE><A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></CODE></DD>

<DD>Returns a hash code value for the object. This method is

supported for the benefit of hashtables such as those provided by

<code>java.util.Hashtable</code>.

返回该对象的hash码值。使用此方法在于利用如java.util.Hashtable的散列表的优势。

The general contract of <code>hashCode</code> is:

hashCode的通常约定：

<ul>

<li>Whenever it is invoked on the same object more than once during

an execution of a Java application, the <tt>hashCode</tt> method

must consistently return the same integer, provided no information

used in <tt>equals</tt> comparisons on the object is modified.

This integer need not remain consistent from one execution of an

application to another execution of the same application.

无论何时在Java应用程序执行的过程中多次调用同一个对象，hashCode方法必须始终返回同样的整数，并假定

用于equals比较的信息没有被修改。该整数从一个应用的执行到同样应用的另一次执行则不必保持一致。

<li>If two objects are equal according to the <tt>equals(Object)</tt>

method, then calling the <code>hashCode</code> method on each of

the two objects must produce the same integer result.

如果根据equals(Object)方法，两个对象相等，那么这两个对象分别调用hashCode方法必定生成相同的整数结果。

<li>It is not required that if two objects are unequal

according to the <A HREF="../../java/lang/Object.html#equals(java.lang.Object)"><CODE>Object.equals(java.lang.Object)</CODE></A>

method, then calling the <tt>hashCode</tt> method on each of the

two objects must produce distinct integer results. However, the

programmer should be aware that producing distinct integer results

for unequal objects may improve the performance of hashtables.

如果根据Object.equals(java.lang.Object)方法两个对象不相等，不要求两个对象分别调用hashCode方法必定生成不同的整数结果。

然而，程序员应该意识到不同对象生成不同的整数结果可以改善散列表的性能。

</ul>

As much as is reasonably practical, the hashCode method defined by

class <tt>Object</tt> does return distinct integers for distinct

objects. (This is typically implemented by converting the internal

address of the object into an integer, but this implementation

technique is not required by the

JavaTM programming language.)

根据实际情况，类Object定义的hashCode方法对不同对象返回不同的整数。（通常以对象的内部地址转换成整数方式实现，但该实现技术

在Java程序语言中不要求）

<DT>Overrides:<DD><CODE><A HREF="../../java/lang/Object.html#hashCode()">hashCode</A></CODE> in class <CODE><A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></CODE></DL>

</DD>

<DT>Returns:<DD>a hash code value for this object. 此对象的hash码值。<DT>See Also:<DD><A HREF="../../java/lang/Object.html#equals(java.lang.Object)"><CODE>Object.equals(java.lang.Object)</CODE></A>,

<A HREF="../../java/util/Hashtable.html" title="class in java.util"><CODE>Hashtable</CODE></A></DL>

</DD>

</DL>

<HR>

toString</H3>

<PRE>

public <A HREF="../../java/lang/String.html" title="class in java.lang">String</A> toString()</PRE>

<DL>

<DD>Description copied from class: <CODE><A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></CODE></DD>

<DD>Returns a string representation of the object. In general, the

<code>toString</code> method returns a string that

"textually represents" this object. The result should

be a concise but informative representation that is easy for a

person to read.

It is recommended that all subclasses override this method.

返回该对象的字符串形式。通常，toString方法返回一个对象文本表示的字符串。结果应简明但易于读懂。

The <code>toString</code> method for class <code>Object</code>

returns a string consisting of the name of the class of which the

object is an instance, the at-sign character `<code>@</code>', and

the unsigned hexadecimal representation of the hash code of the

object. In other words, this method returns a string equal to the

value of:

类Object的toString方法返回一个包括类实例的类名称的字符串，“@”字符和此对象的无符号十六进制表示。

换句话说，该方法返回的字符串等于：

<pre>

getClass().getName() + '@' + Integer.toHexString(hashCode())

</pre></blockquote>

<DT>Overrides:<DD><CODE><A HREF="../../java/lang/Object.html#toString()">toString</A></CODE> in class <CODE><A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></CODE></DL>

</DD>

<DT>Returns:<DD>a string representation of the object. 该对象的字符串形式。</DL>

</DD>

</DL>

<HR>

<TR>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../overview-summary.html">Overview</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html">Package</A> </TD>

<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev">  Class </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html">Deprecated</A> </TD>

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-files/index-1.html">Index</A> </TD>

</TR>

</TABLE>

</TD>

JavaTM 2 Platform Std. Ed. v1.4.2

</TD>

</TR>

<TR>

<A HREF="../../java/net/NetPermission.html" title="class in java.net">PREV CLASS</A>

<A HREF="../../java/net/PasswordAuthentication.html" title="class in java.net">NEXT CLASS</A></TD>

<A HREF="../../index.html" target="_top">FRAMES</A>

<A HREF="NetworkInterface.html" target="_top">NO FRAMES</A>

<!--

if(window==top) {

document.writeln('<A HREF="../../allclasses-noframe.html">All Classes</A>');

}

//-->

</SCRIPT>

<A HREF="../../allclasses-noframe.html">All Classes</A>

</NOSCRIPT>

</TD>

</TR>

<TR>

SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></TD>

DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></TD>

</TR>

</TABLE>

<HR>

<a href="http://java.sun.com/cgi-bin/bugreport.cgi">Submit a bug or feature</a> For further API reference and developer documentation, see <a href="../../../relnotes/devdocs-vs-specs.html">Java 2 SDK SE Developer Documentation</a>. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples. Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to <a href="../../../relnotes/license.html">license terms</a>. Also see the <a href="http://java.sun.com/docs/redist.html">documentation redistribution policy</a>.

</BODY>

</HTML>