java.net.ServerSocket翻译

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

<HTML>

<HEAD>

<TITLE>

ServerSocket (Java 2 Platform SE v1.4.2)

</TITLE>

function windowTitle()

{

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

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

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

<A HREF="ServerSocket.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 ServerSocket</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.ServerSocket

</PRE>

<DL>

<DT>Direct Known Subclasses: <DD><A HREF="../../javax/net/ssl/SSLServerSocket.html" title="class in javax.net.ssl">SSLServerSocket</A></DD>

</DL>

<HR>

<DL>

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

This class implements server sockets. A server socket waits for

requests to come in over the network. It performs some operation

based on that request, and then possibly returns a result to the requester.

该类实现了服务器套桔字，它等待来自网络的请求，根据请求来执行某些操作，然后可能将结果返回给请求者。

The actual work of the server socket is performed by an instance

of the <code>SocketImpl</code> class. An application can

change the socket factory that creates the socket

implementation to configure itself to create sockets

appropriate to the local firewall.

服务器套接字的实际工作由SocketImpl类的实例执行。应用程序可以更改创建套接字实现的套接字工厂，配置它来创建适合本地防火墙的套接字。

<DL>

<DT>Since:</DT>

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

<A HREF="../../java/net/ServerSocket.html#setSocketFactory(java.net.SocketImplFactory)"><CODE>setSocketFactory(java.net.SocketImplFactory)</CODE></A>,

<A HREF="../../java/nio/channels/ServerSocketChannel.html" title="class in java.nio.channels"><CODE>ServerSocketChannel</CODE></A></DL>

<HR>

Constructor Summary</TD>

</TR>

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

          Creates an unbound server socket.

创建无绑定服务器套接字。</TD>

</TR>

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

          Creates a server socket, bound to the specified port.

在指定端口创建服务器套接字。</TD>

</TR>

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

int backlog)</CODE>

          Creates a server socket and binds it to the specified local port

number, with the specified backlog.

创建服务器套接字并绑定在指定端口，使用指定的队列长度。</TD>

</TR>

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

int backlog,

<A HREF="../../java/net/InetAddress.html" title="class in java.net">InetAddress</A> bindAddr)</CODE>

          Create a server with the specified port, listen backlog, and

local IP address to bind to.

使用指定端口、监听队列和绑定地址创建服务器。</TD>

</TR>

</TABLE>

Method Summary</TD>

</TR>

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

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

          Listens for a connection to be made to this socket and accepts

it. 监听发起到此套接字的连接并接受它。</TD>

</TR>

<TD><CODE><A HREF="../../java/net/ServerSocket.html#bind(java.net.SocketAddress)">bind</A>(<A HREF="../../java/net/SocketAddress.html" title="class in java.net">SocketAddress</A> endpoint)</CODE>

Binds the <code>ServerSocket</code> to a specific address

(IP address and port number).

将ServerSocket绑定到指定地址(IP地址和端口号)。</TD>

</TR>

<TD><CODE><A HREF="../../java/net/ServerSocket.html#bind(java.net.SocketAddress, int)">bind</A>(<A HREF="../../java/net/SocketAddress.html" title="class in java.net">SocketAddress</A> endpoint,

int backlog)</CODE>

Binds the <code>ServerSocket</code> to a specific address

(IP address and port number).

将ServerSocket绑定到指定地址(IP地址和端口号)。</TD>

</TR>

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

          Closes this socket.

关闭套接字。</TD>

</TR>

<CODE> <A HREF="../../java/nio/channels/ServerSocketChannel.html" title="class in java.nio.channels">ServerSocketChannel</A></CODE></TD>

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

Returns the unique <A HREF="../../java/nio/channels/ServerSocketChannel.html" title="class in java.nio.channels"><CODE>ServerSocketChannel</CODE></A> object

associated with this socket, if any.

如果有，返回同此套接字唯一关联的ServerSocketChannel对象。</TD>

</TR>

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

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

          Returns the local address of this server socket.

返回此服务器套接字的本地地址。</TD>

</TR>

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

          Returns the port on which this socket is listening.

返回此套接字的监听端口。</TD>

</TR>

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

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

          Returns the address of the endpoint this socket is bound to, or

<code>null</code> if it is not bound yet.

返回此套接字绑定的端点地址，如果未绑定，返回null。</TD>

</TR>

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

Gets the value of the SO_RCVBUF option for this <tt>ServerSocket</tt>,

that is the proposed buffer size that will be used for Sockets accepted

from this <tt>ServerSocket</tt>.

获得此ServerSocket SO_RCVBUF选项的值，这是用于从此ServerSocket接收的套接字的推荐缓冲区大小。</TD>

</TR>

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

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

          Tests if SO_REUSEADDR is enabled.

测试是否设置了SO_REUSEADDR选项。</TD>

</TR>

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

          Retrive setting for SO_TIMEOUT.

获得SO_TIMEOUT选项的设置。</TD>

</TR>

<CODE>protected  void</CODE></TD>

<TD><CODE><A HREF="../../java/net/ServerSocket.html#implAccept(java.net.Socket)">implAccept</A>(<A HREF="../../java/net/Socket.html" title="class in java.net">Socket</A> s)</CODE>

          Subclasses of ServerSocket use this method to override accept()

to return their own subclass of socket.

ServerSocket的子类用该方法重载accept()以便返回自己套接字子类。</TD>

</TR>

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

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

          Returns the binding state of the ServerSocket.

返回此ServerSocket的绑定状态。</TD>

</TR>

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

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

          Returns the closed state of the ServerSocket.

返回此ServerSocket的关闭状态。</TD>

</TR>

<TD><CODE><A HREF="../../java/net/ServerSocket.html#setReceiveBufferSize(int)">setReceiveBufferSize</A>(int size)</CODE>

          Sets a default proposed value for the SO_RCVBUF option for sockets

accepted from this <tt>ServerSocket</tt>.

设置从此ServerSocket接收的套接字的SO_RCVBUF选项的默认建议值。</TD>

</TR>

<TD><CODE><A HREF="../../java/net/ServerSocket.html#setReuseAddress(boolean)">setReuseAddress</A>(boolean on)</CODE>

          Enable/disable the SO_REUSEADDR socket option.

设置/取消SO_REUSEADDR套接字选项。</TD>

</TR>

<CODE>static void</CODE></TD>

<TD><CODE><A HREF="../../java/net/ServerSocket.html#setSocketFactory(java.net.SocketImplFactory)">setSocketFactory</A>(<A HREF="../../java/net/SocketImplFactory.html" title="interface in java.net">SocketImplFactory</A> fac)</CODE>

          Sets the server socket implementation factory for the

application.

设置应用程序的服务器套接字实现工厂。</TD>

</TR>

<TD><CODE><A HREF="../../java/net/ServerSocket.html#setSoTimeout(int)">setSoTimeout</A>(int timeout)</CODE>

          Enable/disable SO_TIMEOUT with the specified timeout, in

milliseconds.

用指定的延时（毫秒为单位）设置/取消SO_TIMEOUT选项。</TD>

</TR>

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

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

          Returns the implementation address and implementation port of

this socket as a <code>String</code>.

以字符串形式返回此套接字实现的地址与端口。</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#equals(java.lang.Object)">equals</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#hashCode()">hashCode</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>

ServerSocket</H3>

<PRE>

public ServerSocket()

throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>

<DL>

<DD>Creates an unbound server socket.

创建无绑定服务器套接字。

<DT>Throws:

<DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - IO error when opening the socket.

当打开套接字时发生I/O错误则抛出。</DL>

<HR>

ServerSocket</H3>

<PRE>

public ServerSocket(int port)

throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>

<DL>

<DD>Creates a server socket, bound to the specified port. A port of

<code>0</code> creates a socket on any free port.

在指定端口创建服务器套接字。端口号为0表示在任意空闲端口创建套接字。

The maximum queue length for incoming connection indications (a

request to connect) is set to <code>50</code>. If a connection

indication arrives when the queue is full, the connection is refused.

呼入连接指令（连接请求）的最大队列长度为50。如果连接指令到达之时队列已满，连接将被拒绝。

If the application has specified a server socket factory, that

factory's <code>createSocketImpl</code> method is called to create

the actual socket implementation. Otherwise a "plain" socket is created.

如果应用程序已指定服务器套接字工厂，调用工厂的createSocketImpl方法来创建实际的套接字实现，否则创建一个

“空白”套接字。

If there is a security manager,

its <code>checkListen</code> method is called

with the <code>port</code> argument

as its argument to ensure the operation is allowed.

This could result in a SecurityException.

如果存在安全管理器，用port作参数调用checkListen方法，以确认操作被允许。这可能导致SecurityException。

<DT>Parameters:<DD><CODE>port</CODE> - the port number, or <code>0</code> to use any

free port.

端口号，0表示使用任意空闲端口。

<DT>Throws:

<DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs when opening the socket. 当打开套接字时发生I/O错误则抛出。

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if a security manager exists and its <code>checkListen</code>

method doesn't allow the operation.

如果SecurityManager存在，它的checkListen方法不允许此操作。<DT>See Also:<DD><A HREF="../../java/net/SocketImpl.html" title="class in java.net"><CODE>SocketImpl</CODE></A>,

<A HREF="../../java/net/SocketImplFactory.html#createSocketImpl()"><CODE>SocketImplFactory.createSocketImpl()</CODE></A>,

<A HREF="../../java/net/ServerSocket.html#setSocketFactory(java.net.SocketImplFactory)"><CODE>setSocketFactory(java.net.SocketImplFactory)</CODE></A>,

<A HREF="../../java/lang/SecurityManager.html#checkListen(int)"><CODE>SecurityManager.checkListen(int)</CODE></A></DL>

<HR>

ServerSocket</H3>

<PRE>

public ServerSocket(int port,

int backlog)

throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>

<DL>

<DD>Creates a server socket and binds it to the specified local port

number, with the specified backlog.

A port number of <code>0</code> creates a socket on any

free port.

创建服务器套接字并绑定在指定端口，使用指定的队列长度。

The maximum queue length for incoming connection indications (a

request to connect) is set to the <code>backlog</code> parameter. If

a connection indication arrives when the queue is full, the

connection is refused.

呼入连接指令（连接请求）的最大队列长度为backlog参数。如果连接指令到达之时队列已满，连接将被拒绝。

If the application has specified a server socket factory, that

factory's <code>createSocketImpl</code> method is called to create

the actual socket implementation. Otherwise a "plain" socket is created.

如果应用程序已指定服务器套接字工厂，调用工厂的createSocketImpl方法来创建实际的套接字实现，否则创建一个 “空白”套接字。

If there is a security manager,

its <code>checkListen</code> method is called

with the <code>port</code> argument

as its argument to ensure the operation is allowed.

This could result in a SecurityException.

如果存在安全管理器，用port作参数调用checkListen方法，以确认操作被允许。这可能导致SecurityException。

The <code>backlog</code> argument must be a positive

value greater than 0. If the value passed if equal or less

than 0, then the default value will be assumed.

backlog参数必须是一个大于0的正数。如果传入的值等于或小于0，那么假定为默认值。

<DT>Parameters:<DD><CODE>port</CODE> - the specified port, or <code>0</code> to use

any free port.

指定端口，0表示使用任意空闲端口。<DD><CODE>backlog</CODE> - the maximum length of the queue. 队列的最大长度。

<DT>Throws:

<DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs when opening the socket.

当打开套接字时发生I/O错误则抛出。

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if a security manager exists and its <code>checkListen</code>

method doesn't allow the operation.

如果SecurityManager存在，它的checkListen方法不允许此操作。<DT>See Also:<DD><A HREF="../../java/net/SocketImpl.html" title="class in java.net"><CODE>SocketImpl</CODE></A>,

<A HREF="../../java/net/SocketImplFactory.html#createSocketImpl()"><CODE>SocketImplFactory.createSocketImpl()</CODE></A>,

<A HREF="../../java/net/ServerSocket.html#setSocketFactory(java.net.SocketImplFactory)"><CODE>setSocketFactory(java.net.SocketImplFactory)</CODE></A>,

<A HREF="../../java/lang/SecurityManager.html#checkListen(int)"><CODE>SecurityManager.checkListen(int)</CODE></A></DL>

<HR>

ServerSocket</H3>

<PRE>

public ServerSocket(int port,

int backlog,

<A HREF="../../java/net/InetAddress.html" title="class in java.net">InetAddress</A> bindAddr)

throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>

<DL>

<DD>Create a server with the specified port, listen backlog, and

local IP address to bind to. The bindAddr argument

can be used on a multi-homed host for a ServerSocket that

will only accept connect requests to one of its addresses.

If bindAddr is null, it will default accepting

connections on any/all local addresses.

The port must be between 0 and 65535, inclusive.

使用指定端口、监听队列和绑定地址创建服务器。

If there is a security manager, this method

calls its <code>checkListen</code> method

with the <code>port</code> argument

as its argument to ensure the operation is allowed.

This could result in a SecurityException.

如果存在安全管理器，用port作参数调用checkListen方法，以确认操作被允许。这可能导致SecurityException。

The <code>backlog</code> argument must be a positive

value greater than 0. If the value passed if equal or less

than 0, then the default value will be assumed.

backlog参数必须是一个大于0的正数。如果传入的值等于或小于0，那么假定为默认值。

<DT>Parameters:<DD><CODE>port</CODE> - the local TCP port<DD><CODE>backlog</CODE> - the listen backlog 监听队列<DD><CODE>bindAddr</CODE> - the local InetAddress the server will bind to 服务器要绑定的本地InetAddress

<DT>Throws:

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if a security manager exists and

its <code>checkListen</code> method doesn't allow the operation.

如果SecurityManager存在，它的checkListen方法不允许此操作。

<DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs when opening the socket.

当打开套接字时发生I/O错误则抛出。<DT>Since:</DT>

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

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

<A HREF="../../java/lang/SecurityManager.html#checkListen(int)"><CODE>SecurityManager.checkListen(int)</CODE></A></DL>

Method Detail</TD>

</TR>

</TABLE>

bind</H3>

<PRE>

public void bind(<A HREF="../../java/net/SocketAddress.html" title="class in java.net">SocketAddress</A> endpoint)

throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>

<DL>

<DD>Binds the <code>ServerSocket</code> to a specific address

(IP address and port number).

将ServerSocket绑定到指定地址(IP地址和端口号)。

If the address is <code>null</code>, then the system will pick up

an ephemeral port and a valid local address to bind the socket.

如果地址为null，那么系统将选择一个临时端口和一个有效本地地址来绑定套接字。

<DT>Parameters:<DD><CODE>endpoint</CODE> - The IP address & port number to bind to. 要绑定的IP地址和端口号。

<DT>Throws:

<DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if the bind operation fails, or if the socket

is already bound.

如果绑定操作失败，或者套接字已被绑定时抛出。

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if a <code>SecurityManager</code> is present and

its <code>checkListen</code> method doesn't allow the operation.

如果SecurityManager存在，它的checkListen方法不允许此操作。

<DD><CODE><A HREF="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</A></CODE> - if endpoint is a

SocketAddress subclass not supported by this socket

如果端点是一个不被此套接字支持的SocketAddress子类时抛出

<DT>Since:</DT>

</DL>

</DD>

</DL>

<HR>

bind</H3>

<PRE>

public void bind(<A HREF="../../java/net/SocketAddress.html" title="class in java.net">SocketAddress</A> endpoint,

int backlog)

throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>

<DL>

<DD>Binds the <code>ServerSocket</code> to a specific address

(IP address and port number).

将ServerSocket绑定到指定地址(IP地址和端口号)。

If the address is <code>null</code>, then the system will pick up

an ephemeral port and a valid local address to bind the socket.

如果地址为null，那么系统将选择一个临时端口和一个有效本地地址来绑定套接字。

The <code>backlog</code> argument must be a positive

value greater than 0. If the value passed if equal or less

than 0, then the default value will be assumed.

backlog参数必须是一个大于0的正数。如果传入的值小于等于0，则使用默认值。

<DT>Parameters:<DD><CODE>endpoint</CODE> - The IP address & port number to bind to. 要绑定的IP地址和端口号。<DD><CODE>backlog</CODE> - The listen backlog length. 监听队列长度。

<DT>Throws:

<DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if the bind operation fails, or if the socket

is already bound. 如果绑定操作失败，或者套接字已被绑定时抛出。

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if a <code>SecurityManager</code> is present and

its <code>checkListen</code> method doesn't allow the operation. 如果SecurityManager存在，它的checkListen方法不允许此操作。

<DD><CODE><A HREF="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</A></CODE> - if endpoint is a

SocketAddress subclass not supported by this socket

如果端点是一个不被此套接字支持的SocketAddress子类时抛出<DT>Since:</DT>

</DL>

</DD>

</DL>

<HR>

getInetAddress</H3>

<PRE>

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

<DL>

<DD>Returns the local address of this server socket.

返回此服务器套接字的本地地址。

<DT>Returns:<DD>the address to which this socket is bound,

or <code>null</code> if the socket is unbound.

此套接字绑定的地址，如果未绑定，返回null。</DL>

</DD>

</DL>

<HR>

getLocalPort</H3>

<PRE>

public int getLocalPort()</PRE>

<DL>

<DD>Returns the port on which this socket is listening.

返回此套接字的监听端口。

<DT>Returns:<DD>the port number to which this socket is listening or

-1 if the socket is not bound yet.

此套接字监听的端口号，如果套接字未绑定，返回-1。</DL>

</DD>

</DL>

<HR>

getLocalSocketAddress</H3>

<PRE>

public <A HREF="../../java/net/SocketAddress.html" title="class in java.net">SocketAddress</A> getLocalSocketAddress()</PRE>

<DL>

<DD>Returns the address of the endpoint this socket is bound to, or

<code>null</code> if it is not bound yet.

返回此套接字绑定的端点地址，如果未绑定，返回null。

<DT>Returns:<DD>a <code>SocketAddress</code> representing the local endpoint of this

socket, or <code>null</code> if it is not bound yet.

表示此套接字本地端点的SocketAddress，如果未绑定，返回null。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/net/ServerSocket.html#getInetAddress()"><CODE>getInetAddress()</CODE></A>,

<A HREF="../../java/net/ServerSocket.html#getLocalPort()"><CODE>getLocalPort()</CODE></A>,

<A HREF="../../java/net/ServerSocket.html#bind(java.net.SocketAddress)"><CODE>bind(SocketAddress)</CODE></A></DL>

</DD>

</DL>

<HR>

accept</H3>

<PRE>

public <A HREF="../../java/net/Socket.html" title="class in java.net">Socket</A> accept()

throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>

<DL>

<DD>Listens for a connection to be made to this socket and accepts

it. The method blocks until a connection is made.

监听发起到此套接字的连接并接受它。

A new Socket <code>s</code> is created and, if there

is a security manager,

the security manager's <code>checkAccept</code> method is called

with <code>s.getInetAddress().getHostAddress()</code> and

<code>s.getPort()</code>

as its arguments to ensure the operation is allowed.

This could result in a SecurityException.

创建一个新的Socket s，如果存在安全管理器，用s.getInetAddress().getHostAddress()和s.getPort()的返回值作为

参数调用安全管理器的checkAccept方法，以确认操作允许。这可能导致SecurityException。

<DT>Returns:<DD>the new Socket 新的Socket

<DT>Throws:

<DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs when waiting for a

connection. 等待连接时发生I/O错误则抛出。

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if a security manager exists and its

<code>checkListen</code> method doesn't allow the operation. 如果安全管理器存在，它的checkListen方法不允许该操作时抛出。

<DD><CODE><A HREF="../../java/net/SocketTimeoutException.html" title="class in java.net">SocketTimeoutException</A></CODE> - if a timeout was previously set with setSoTimeout and

the timeout has been reached.

之前用setSoTimeout设置了延时，而延时已满时抛出。

<DD><CODE><A HREF="../../java/nio/channels/IllegalBlockingModeException.html" title="class in java.nio.channels">IllegalBlockingModeException</A></CODE> - if this socket has an associated channel,

and the channel is in non-blocking mode.

如果此套接字有对应的通道且通道处于非阻塞模式时抛出。<DT>See Also:<DD><A HREF="../../java/lang/SecurityManager.html#checkAccept(java.lang.String, int)"><CODE>SecurityManager.checkAccept(java.lang.String, int)</CODE></A></DL>

</DD>

</DL>

<HR>

implAccept</H3>

<PRE>

protected final void implAccept(<A HREF="../../java/net/Socket.html" title="class in java.net">Socket</A> s)

throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>

<DL>

<DD>Subclasses of ServerSocket use this method to override accept()

to return their own subclass of socket. So a FooServerSocket

will typically hand this method an empty FooSocket. On

return from implAccept the FooSocket will be connected to a client.

ServerSocket的子类用该方法重载accept()以便返回自己套接字子类。

<DT>Parameters:<DD><CODE>s</CODE> - the Socket 套接字

<DT>Throws:

<DD><CODE><A HREF="../../java/nio/channels/IllegalBlockingModeException.html" title="class in java.nio.channels">IllegalBlockingModeException</A></CODE> - if this socket has an associated channel,

and the channel is in non-blocking mode 如果此套接字有对应的通道且通道处于非阻塞模式时抛出。

<DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs when waiting

for a connection.

等待连接时发生I/O错误则抛出。<DT>Since:</DT>

</DL>

</DD>

</DL>

<HR>

close</H3>

<PRE>

public void close()

throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>

<DL>

<DD>Closes this socket.

Any thread currently blocked in <A HREF="../../java/net/ServerSocket.html#accept()"><CODE>accept()</CODE></A> will throw

a <A HREF="../../java/net/SocketException.html" title="class in java.net"><CODE>SocketException</CODE></A>.

关闭套接字。任何目前阻塞于accept()的线程都将抛出SocketException。

If this socket has an associated channel then the channel is closed

as well.

如果此套接字有对应通道，那么同时关闭通道。

<DT>Throws:

<DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs when closing the socket. 如果关闭套接字时有I/O错误则抛出。</DL>

</DD>

</DL>

<HR>

getChannel</H3>

<PRE>

public <A HREF="../../java/nio/channels/ServerSocketChannel.html" title="class in java.nio.channels">ServerSocketChannel</A> getChannel()</PRE>

<DL>

<DD>Returns the unique <A HREF="../../java/nio/channels/ServerSocketChannel.html" title="class in java.nio.channels"><CODE>ServerSocketChannel</CODE></A> object

associated with this socket, if any.

如果有，返回同此套接字唯一关联的ServerSocketChannel对象。

A server socket will have a channel if, and only if, the channel

itself was created via the <A HREF="../../java/nio/channels/ServerSocketChannel.html#open()"><CODE>ServerSocketChannel.open</CODE></A>

method.

只有自身通过ServerSocketChannel.open创建通道，服务器套接字才有通道。

<DT>Returns:<DD>the server-socket channel associated with this socket,

or <tt>null</tt> if this socket was not created

for a channel

此套接字的对应的服务器套接字通道，如果套接字未创建通道，返回null<DT>Since:</DT>

</DL>

</DD>

</DL>

<HR>

isBound</H3>

<PRE>

public boolean isBound()</PRE>

<DL>

<DD>Returns the binding state of the ServerSocket.

返回此ServerSocket的绑定状态。

<DT>Returns:<DD>true if the ServerSocket succesfuly bound to an address

如果ServerSocket被成功绑定到某地址，返回true<DT>Since:</DT>

</DL>

</DD>

</DL>

<HR>

isClosed</H3>

<PRE>

public boolean isClosed()</PRE>

<DL>

<DD>Returns the closed state of the ServerSocket.

返回此ServerSocket的关闭状态。

<DT>Returns:<DD>true if the socket has been closed 如果此套接字被关闭，返回true<DT>Since:</DT>

</DL>

</DD>

</DL>

<HR>

setSoTimeout</H3>

<PRE>

public void setSoTimeout(int timeout)

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

<DL>

<DD>Enable/disable SO_TIMEOUT with the specified timeout, in

milliseconds. With this option set to a non-zero timeout,

a call to accept() for this ServerSocket

will block for only this amount of time. If the timeout expires,

a java.net.SocketTimeoutException is raised, though the

ServerSocket is still valid. The option must be enabled

prior to entering the blocking operation to have effect. The

timeout must be > 0.

A timeout of zero is interpreted as an infinite timeout.

用指定的延时（毫秒为单位）设置/取消SO_TIMEOUT选项。用设置的非零延时选项，调用此ServerSocket的accept()

将阻塞定量的时间。如果延时期满，将引起java.net.SocketTimeoutException，虽然ServerSocket仍然无效。选项

必须在进入阻塞操作前设置才有效。延时值必须>0。0值被解释为无限延时。

<DT>Parameters:<DD><CODE>timeout</CODE> - the specified timeout, in milliseconds 指定的延时，以毫秒为单位

<DT>Throws:

<DD><CODE><A HREF="../../java/net/SocketException.html" title="class in java.net">SocketException</A></CODE> - if there is an error in

the underlying protocol, such as a TCP error.

如果底层协议存在错误，例如TCP错误时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/net/ServerSocket.html#getSoTimeout()"><CODE>getSoTimeout()</CODE></A></DL>

</DD>

</DL>

<HR>

getSoTimeout</H3>

<PRE>

public int getSoTimeout()

throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>

<DL>

<DD>Retrive setting for SO_TIMEOUT. 0 returns implies that the

option is disabled (i.e., timeout of infinity).

获得SO_TIMEOUT选项的设置。返回0意味着不设置此选项（即超时无限制）。

<DT>Returns:<DD>the SO_TIMEOUT value SO_TIMEOUT值

<DT>Throws:

<DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs 如果发生I/O错误则抛出<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/net/ServerSocket.html#setSoTimeout(int)"><CODE>setSoTimeout(int)</CODE></A></DL>

</DD>

</DL>

<HR>

setReuseAddress</H3>

<PRE>

public void setReuseAddress(boolean on)

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

<DL>

<DD>Enable/disable the SO_REUSEADDR socket option.

设置/取消SO_REUSEADDR套接字选项。

When a TCP connection is closed the connection may remain

in a timeout state for a period of time after the connection

is closed (typically known as the <tt>TIME_WAIT</tt> state

or <tt>2MSL</tt> wait state).

For applications using a well known socket address or port

it may not be possible to bind a socket to the required

<tt>SocketAddress</tt> if there is a connection in the

timeout state involving the socket address or port.

对于使用众所周知的套接字地址和端口的应用程序，当关闭TCP连接时，会在连接关闭后保持一段延时状态（通常作为TIME_WAIT状态或2MSL等待状态）。

如果涉及的套接字地址和端口处于延时状态。

Enabling <tt>SO_REUSEADDR</tt> prior to binding the socket

using <A HREF="../../java/net/ServerSocket.html#bind(java.net.SocketAddress)"><CODE>bind(SocketAddress)</CODE></A> allows the socket to be

bound even though a previous connection is in a timeout

state.

在使用bind(SocketAddress)绑定套接字前设置SO_REUSEADDR选项使得套接字能够绑定，尽管先前的连接处于延时状态。

When a <tt>ServerSocket</tt> is created the initial setting

of <tt>SO_REUSEADDR</tt> is not defined. Applications can

use <A HREF="../../java/net/ServerSocket.html#getReuseAddress()"><CODE>getReuseAddress()</CODE></A> to determine the initial

setting of <tt>SO_REUSEADDR</tt>.

创建ServerSocket时，SO_REUSEADDR的初始设置未定义。应用程序可以使用getReuseAddress()确定SO_REUSEADDR的初始设置。

The behaviour when <tt>SO_REUSEADDR</tt> is enabled or

disabled after a socket is bound (See <A HREF="../../java/net/ServerSocket.html#isBound()"><CODE>isBound()</CODE></A>)

is not defined.

在套接字绑定后设置或取消SO_REUSEADDR的行为未定义。

<DT>Parameters:<DD><CODE>on</CODE> - whether to enable or disable the socket option 是否设置该套接字选项

<DT>Throws:

<DD><CODE><A HREF="../../java/net/SocketException.html" title="class in java.net">SocketException</A></CODE> - if an error occurs enabling or

disabling the <tt>SO_RESUEADDR</tt> socket option,

or the socket is closed.

在设置或取消SO_RESUEADDR套接字选项时出现错误或套接字被关闭时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/net/ServerSocket.html#getReuseAddress()"><CODE>getReuseAddress()</CODE></A>,

<A HREF="../../java/net/ServerSocket.html#bind(java.net.SocketAddress)"><CODE>bind(SocketAddress)</CODE></A>,

<A HREF="../../java/net/ServerSocket.html#isBound()"><CODE>isBound()</CODE></A>,

<A HREF="../../java/net/ServerSocket.html#isClosed()"><CODE>isClosed()</CODE></A></DL>

</DD>

</DL>

<HR>

getReuseAddress</H3>

<PRE>

public boolean getReuseAddress()

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

<DL>

<DD>Tests if SO_REUSEADDR is enabled.

测试是否设置了SO_REUSEADDR选项。

<DT>Returns:<DD>a <code>boolean</code> indicating whether or not SO_REUSEADDR is enabled.

表示是否设置了SO_REUSEADDR选项的布尔值。

<DT>Throws:

<DD><CODE><A HREF="../../java/net/SocketException.html" title="class in java.net">SocketException</A></CODE> - if there is an error

in the underlying protocol, such as a TCP error.

如果底层协议存在错误，例如TCP错误时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/net/ServerSocket.html#setReuseAddress(boolean)"><CODE>setReuseAddress(boolean)</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>Returns the implementation address and implementation port of

this socket as a <code>String</code>.

以字符串形式返回此套接字实现的地址与端口。

<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 socket. 此套接字的字符串形式。</DL>

</DD>

</DL>

<HR>

setSocketFactory</H3>

<PRE>

public static void setSocketFactory(<A HREF="../../java/net/SocketImplFactory.html" title="interface in java.net">SocketImplFactory</A> fac)

throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>

<DL>

<DD>Sets the server socket implementation factory for the

application. The factory can be specified only once.

设置应用程序的服务器套接字实现工厂。工厂只能被指定一次。

When an application creates a new server socket, the socket

implementation factory's <code>createSocketImpl</code> method is

called to create the actual socket implementation.

当应用程序创建一个新的服务器套接字时，调用套接字实现工厂的createSocketImpl方法创建一个实际的套接字实现。

If there is a security manager, this method first calls

the security manager's <code>checkSetFactory</code> method

to ensure the operation is allowed.

This could result in a SecurityException.

如果存在安全管理器，该方法首先调用安全管理器的checkSetFactory方法以确认操作允许，这可能造成SecurityException。

<DT>Parameters:<DD><CODE>fac</CODE> - the desired factory. 期望工厂。

<DT>Throws:

<DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs when setting the

socket factory. 当设置套接字工厂时发生I/O错误则抛出。

<DD><CODE><A HREF="../../java/net/SocketException.html" title="class in java.net">SocketException</A></CODE> - if the factory has already been defined. 如果该工厂已经被定义时抛出。

<DD><CODE><A HREF="../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</A></CODE> - if a security manager exists and its

<code>checkSetFactory</code> method doesn't allow the operation.

如果安全管理器存在，它的checkSetFactory方法不允许该操作时抛出。<DT>See Also:<DD><A HREF="../../java/net/SocketImplFactory.html#createSocketImpl()"><CODE>SocketImplFactory.createSocketImpl()</CODE></A>,

<A HREF="../../java/lang/SecurityManager.html#checkSetFactory()"><CODE>SecurityManager.checkSetFactory()</CODE></A></DL>

</DD>

</DL>

<HR>

setReceiveBufferSize</H3>

<PRE>

public void setReceiveBufferSize(int size)

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

<DL>

<DD>Sets a default proposed value for the SO_RCVBUF option for sockets

accepted from this <tt>ServerSocket</tt>. The value actually set

in the accepted socket must be determined by calling

<A HREF="../../java/net/Socket.html#getReceiveBufferSize()"><CODE>Socket.getReceiveBufferSize()</CODE></A> after the socket

is returned by <A HREF="../../java/net/ServerSocket.html#accept()"><CODE>accept()</CODE></A>.

设置从此ServerSocket接收的套接字的SO_RCVBUF选项的默认建议值。由accept()返回套接字后，其中设置的值必须通过调用

Socket.getReceiveBufferSize()来确定。

The value of SO_RCVBUF is used both to set the size of the internal

socket receive buffer, and to set the size of the TCP receive window

that is advertized to the remote peer.

SO_RCVBUF的值用来设置内部套接字接收缓冲区和通知给远端对方的TCP接收窗口的大小。

It is possible to change the value subsequently, by calling

<A HREF="../../java/net/Socket.html#setReceiveBufferSize(int)"><CODE>Socket.setReceiveBufferSize(int)</CODE></A>. However, if the application

wishes to allow a receive window larger than 64K bytes, as defined by RFC1323

then the proposed value must be set in the ServerSocket before

it is bound to a local address. This implies, that the ServerSocket must be

created with the no-argument constructor, then setReceiveBufferSize() must

be called and lastly the ServerSocket is bound to an address by calling bind().

通过调用Socket.setReceiveBufferSize(int)可以改变这个值。然而如果应用程序希望接收窗口大于64KB，

则ServerSocket必须在被绑定到本地地址前设置建议值。这意味着，服务器套接字必须用无参数构造函数创建，然后必须

调用setReceiveBufferSize()，最后调用bind()将ServerSocket绑定到地址。

Failure to do this will not cause an error, and the buffer size may be set to the

requested value but the TCP receive window in sockets accepted from

this ServerSocket will be no larger than 64K bytes.

操作失败将导致错误，且缓冲区大小可能被设置为请求值，但此ServerSocket产生的接收套接字的TCP接收窗口

将不再大于64KB。

<DT>Parameters:<DD><CODE>size</CODE> - the size to which to set the receive buffer

size. This value must be greater than 0.

设置的接收缓冲区大小值，必须>0。

<DT>Throws:

<DD><CODE><A HREF="../../java/net/SocketException.html" title="class in java.net">SocketException</A></CODE> - if there is an error

in the underlying protocol, such as a TCP error.

如果底层协议存在错误，例如TCP错误时抛出。

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

value is 0 or is negative.

如果该值为0，或为负数时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/net/ServerSocket.html#getReceiveBufferSize()"><CODE>getReceiveBufferSize()</CODE></A></DL>

</DD>

</DL>

<HR>

getReceiveBufferSize</H3>

<PRE>

public int getReceiveBufferSize()

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

<DL>

<DD>Gets the value of the SO_RCVBUF option for this <tt>ServerSocket</tt>,

that is the proposed buffer size that will be used for Sockets accepted

from this <tt>ServerSocket</tt>.

获得此ServerSocket SO_RCVBUF选项的值，这是用于从此ServerSocket接收的套接字的推荐缓冲区大小。

Note, the value actually set in the accepted socket is determined by

calling <A HREF="../../java/net/Socket.html#getReceiveBufferSize()"><CODE>Socket.getReceiveBufferSize()</CODE></A>.

注意，在接收套接字中该值的设置实际上通过调用Socket.getReceiveBufferSize()来确定。

<DT>Returns:<DD>the value of the SO_RCVBUF option for this <tt>Socket</tt>. 此Socket的SO_RCVBUF选项值。

<DT>Throws:

<DD><CODE><A HREF="../../java/net/SocketException.html" title="class in java.net">SocketException</A></CODE> - if there is an error

in the underlying protocol, such as a TCP error.如果底层协议存在错误，例如TCP错误时抛出。<DT>Since:</DT>

<DT>See Also:<DD><A HREF="../../java/net/ServerSocket.html#setReceiveBufferSize(int)"><CODE>setReceiveBufferSize(int)</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/PasswordAuthentication.html" title="class in java.net">PREV CLASS</A>

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

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

<A HREF="ServerSocket.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>