java.net.InetSocketAddress翻译

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

<HTML>

<HEAD>

<TITLE>

InetSocketAddress (Java 2 Platform SE v1.4.2)

</TITLE>

function windowTitle()

{

parent.document.title="InetSocketAddress (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/InetAddress.html" title="class in java.net">PREV CLASS</A>

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

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

<A HREF="InetSocketAddress.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 | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></TD>

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

</TR>

</TABLE>

<HR>

<H2>

java.net

Class InetSocketAddress</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"><A HREF="../../java/net/SocketAddress.html" title="class in java.net">java.net.SocketAddress</A>

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

</PRE>

<DL>

<DT>All Implemented Interfaces: <DD><A HREF="../../java/io/Serializable.html" title="interface in java.io">Serializable</A></DD>

</DL>

<HR>

<DL>

<DT>public class InetSocketAddress<DT>extends <A HREF="../../java/net/SocketAddress.html" title="class in java.net">SocketAddress</A></DL>

This class implements an IP Socket Address (IP address + port number)

It can also be a pair (hostname + port number), in which case an attempt

will be made to resolve the hostname. If resolution fails then the address

is said to be unresolved but can still be used on some circumstances

like connecting through a proxy.

该类实现了IP套接字地址（IP地址+端口号），也可以是主机号+端口号，这种情况将尝试解析主机名。

如果解析失败则称地址unresolved，但在有些情况下仍然可用例如通过代理服务器的连接。。

It provides an immutable object used by sockets for binding, connecting, or

as returned values.

其提供了一种不变的对象，用于套接字的绑定、连接，或作为返回值。

The wildcard is a special local IP address. It usually means "any"

and can only be used for <code>bind</code> operations.

掩码是一种特殊的IP地址。它通常意味着“任意”，只能用于绑定操作。

<DL>

<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/net/Socket.html" title="class in java.net"><CODE>Socket</CODE></A>,

<A HREF="../../java/net/ServerSocket.html" title="class in java.net"><CODE>ServerSocket</CODE></A>,

<A HREF="../../serialized-form.html#java.net.InetSocketAddress">Serialized Form</A></DL>

<HR>

Constructor Summary</TD>

</TR>

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

int port)</CODE>

          Creates a socket address from an IP address and a port number.

根据IP地址和端口号创建一个套接字地址。</TD>

</TR>

<TD><CODE><A HREF="../../java/net/InetSocketAddress.html#InetSocketAddress(int)">InetSocketAddress</A>(int port)</CODE>

          Creates a socket address where the IP address is the wildcard address

and the port number a specified value.

创建一个套接字地址，其IP地址为掩码地址，端口号为指定值。</TD>

</TR>

<TD><CODE><A HREF="../../java/net/InetSocketAddress.html#InetSocketAddress(java.lang.String, int)">InetSocketAddress</A>(<A HREF="../../java/lang/String.html" title="class in java.lang">String</A> hostname,

int port)</CODE>

          Creates a socket address from a hostname and a port number.

根据主机名和端口号创建一个套接字地址。</TD>

</TR>

</TABLE>

Method Summary</TD>

</TR>

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

<TD><CODE><A HREF="../../java/net/InetSocketAddress.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> <A HREF="../../java/net/InetAddress.html" title="class in java.net">InetAddress</A></CODE></TD>

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

Gets the <code>InetAddress</code>.

获得InetAddress对象。</TD>

</TR>

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

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

Gets the <code>hostname</code>.

获得主机名。</TD>

</TR>

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

          Gets the port number.

获得端口号。</TD>

</TR>

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

          Returns a hashcode for this socket address.

返回该套接字地址的hash码。</TD>

</TR>

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

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

          Checks wether the address has been resolved or not.

检查此地址是否已被解析。</TD>

</TR>

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

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

          Constructs a string representation of this InetSocketAddress.

构造此InetSocketAddress的字符串形式。</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>

Constructor Detail</TD>

</TR>

</TABLE>

InetSocketAddress</H3>

<PRE>

public InetSocketAddress(int port)</PRE>

<DL>

<DD>Creates a socket address where the IP address is the wildcard address

and the port number a specified value.

创建一个套接字地址，其IP地址为掩码地址，端口号为指定值。

A valid port value is between 0 and 65535.

A port number of <code>zero</code> will let the system pick up an

ephemeral port in a <code>bind</code> operation.

有效的端口号在0-65535之间。端口号为0意味着系统在绑定操作时选择一个临时端口。

<DT>Parameters:<DD><CODE>port</CODE> - The port number 端口号

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</A></CODE> - if the port parameter is outside the specified

range of valid port values. 如果端口号超出指定的有效端口值范围时抛出。</DL>

<HR>

InetSocketAddress</H3>

<PRE>

public InetSocketAddress(<A HREF="../../java/net/InetAddress.html" title="class in java.net">InetAddress</A> addr,

int port)</PRE>

<DL>

<DD>Creates a socket address from an IP address and a port number.

根据IP地址和端口号创建一个套接字地址。

A valid port value is between 0 and 65535.

A port number of <code>zero</code> will let the system pick up an

ephemeral port in a <code>bind</code> operation.

有效的端口号在0-65535之间。端口号为0意味着系统在绑定操作时选择一个临时端口。

A <code>null</code> address will assign the wildcard address.

null地址将指定为掩码地址。

<DT>Parameters:<DD><CODE>addr</CODE> - The IP address IP地址<DD><CODE>port</CODE> - The port number 端口号

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</A></CODE> - if the port parameter is outside the specified

range of valid port values.

如果端口号超出指定的有效端口值范围时抛出。</DL>

<HR>

InetSocketAddress</H3>

<PRE>

public InetSocketAddress(<A HREF="../../java/lang/String.html" title="class in java.lang">String</A> hostname,

int port)</PRE>

<DL>

<DD>Creates a socket address from a hostname and a port number.

根据主机名和端口号创建一个套接字地址。

An attempt will be made to resolve the hostname into an InetAddress.

If that attempt fails, the address will be flagged as unresolved.

尝试将主机名解析为IP地址。如果尝试失败，用unresolved标识地址。

A valid port value is between 0 and 65535.

A port number of <code>zero</code> will let the system pick up an

ephemeral port in a <code>bind</code> operation.

有效的端口号在0-65535之间。端口号为0意味着系统在绑定操作时选择一个临时端口。

<DT>Parameters:<DD><CODE>hostname</CODE> - the Host name 主机名<DD><CODE>port</CODE> - The port number 端口号

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</A></CODE> - if the port parameter is outside the range

of valid port values, or if the hostname parameter is <TT>null</TT>.

如果端口号超出指定的有效端口值范围或者主机名参数为null时抛出。<DT>See Also:<DD><A HREF="../../java/net/InetSocketAddress.html#isUnresolved()"><CODE>isUnresolved()</CODE></A></DL>

Method Detail</TD>

</TR>

</TABLE>

getPort</H3>

<PRE>

public final int getPort()</PRE>

<DL>

<DD>Gets the port number. 获得端口号。

<DT>Returns:<DD>the port number. 端口号。</DL>

</DD>

</DL>

<HR>

getAddress</H3>

<PRE>

public final <A HREF="../../java/net/InetAddress.html" title="class in java.net">InetAddress</A> getAddress()</PRE>

<DL>

<DD>Gets the <code>InetAddress</code>. 获得InetAddress对象。

<DT>Returns:<DD>the InetAdress or <code>null</code> if it is unresolved. 返回InetAdress，如果不能解析，则为null。</DL>

</DD>

</DL>

<HR>

getHostName</H3>

<PRE>

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

<DL>

<DD>Gets the <code>hostname</code>. 获得主机名。

<DT>Returns:<DD>the hostname part of the address. 地址的主机名部分。</DL>

</DD>

</DL>

<HR>

isUnresolved</H3>

<PRE>

public final boolean isUnresolved()</PRE>

<DL>

<DD>Checks wether the address has been resolved or not. 检查此地址是否已被解析。

<DT>Returns:<DD><code>true</code> if the hostname couldn't be resolved into

an <code>InetAddress</code>. 如果主机名不能解析为IP地址，返回true。</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>Constructs a string representation of this InetSocketAddress.

This String is constructed by calling toString() on the InetAddress

and concatenating the port number (with a colon). If the address

is unresolved then the part before the colon will only contain the hostname.

构造此InetSocketAddress的字符串形式。调用toString()构造的字符串为IP地址和以冒号连接端口号。

如果不能解析主机名，则冒号前的部分将只包含主机名。

<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 this object. 该对象的字符串形式。</DL>

</DD>

</DL>

<HR>

equals</H3>

<PRE>

public final 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 address as

this object.

将该对象同指定的对象进行比较。只有参数不为null且同此对象表示相同的地址时结果为true。

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

address if both the InetAddresses (or hostnames if it is unresolved) and port

numbers are equal.

If both addresses are unresolved, then the hostname & the port number

are compared.

如果InetAddresses（如果未解析可为主机名）和端口号相同，则两个InetAddresses的实例表示相同的地址。

如果两者的地址都不能解析，则比较主机名和端口号。

<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#equals(java.lang.Object)"><CODE>InetAddress.equals(java.lang.Object)</CODE></A></DL>

</DD>

</DL>

<HR>

hashCode</H3>

<PRE>

public final int hashCode()</PRE>

<DL>

<DD>Returns a hashcode for this socket address. 返回该套接字地址的hash码。

<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 socket address. 该套接字地址的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>

<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/InetAddress.html" title="class in java.net">PREV CLASS</A>

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

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

<A HREF="InetSocketAddress.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 | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></TD>

DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <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>