java.net
类 Socket

java.lang.Object
  java.net.Socket

直接已知子类：

SSLSocket

public class Socket
     

      extends 
      Object
     

此类实现客户端套接字（也可以就叫“套接字”）。套接字是两台机器间通信的端点。

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

从以下版本开始：

JDK1.0

另请参见：

setSocketImplFactory(java.net.SocketImplFactory), SocketImpl, SocketChannel

Socket

public Socket()

通过系统默认类型的 SocketImpl 创建未连接套接字

从以下版本开始：

JDK1.1

Socket

public Socket(Proxy proxy)

创建一个未连接的套接字并指定代理类型（如果有），该代理不管其他设置如何都应被使用。

如果有安全管理器，则使用代理主机地址和端口号作为参数调用其 checkConnect 方法。这可能会导致 SecurityException 异常。

示例：

• Socket s = new Socket(Proxy.NO_PROXY); 将创建忽略任何其他代理配置的普通套接字。
• Socket s = new Socket(new Proxy(Proxy.Type.SOCKS, new InetSocketAddress("socks.mydom.com", 1080))); 将创建通过指定的 SOCKS 代理服务器进行连接的套接字。

参数：

proxy - 指定应使用的代理种类的 Proxy 对象。

抛出：

IllegalArgumentException - 如果代理的类型无效或者为 null。

SecurityException - 如果存在安全管理器，但拒绝连接到代理的权限。

从以下版本开始：

1.5

另请参见：

ProxySelector, Proxy

Socket

protected Socket(SocketImpl impl)
          throws SocketException

使用用户指定的 SocketImpl 创建一个未连接 Socket。

参数：

impl - 子类希望在 Socket 上使用的 SocketImpl 的实例。

抛出：

SocketException - 如果底层协议出现错误，例如 TCP 错误。

从以下版本开始：

JDK1.1

Socket

public Socket(String host,
              int port)
       throws UnknownHostException,
              IOException

创建一个流套接字并将其连接到指定主机上的指定端口号。

如果指定的主机为 null，则等效于指定与 InetAddress.getByName(null) 相同的地址。换句话话，等效于指定回送接口的地址。

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

如果有安全管理器，则使用主机地址和 port 作为参数调用其 checkConnect 方法。这可能会导致 SecurityException 异常。

参数：

host - 主机名，或者为 null，表示回送地址。

port - 端口号。

抛出：

UnknownHostException - 如果无法确定主机的 IP 地址。

IOException - 如果创建套接字时发生 I/O 错误。

SecurityException - 如果安全管理器存在并且其 checkConnect 方法不允许进行该操作。

另请参见：

setSocketImplFactory(java.net.SocketImplFactory), SocketImpl, SocketImplFactory.createSocketImpl(), SecurityManager.checkConnect(java.lang.String, int)

Socket

public Socket(InetAddress address,
              int port)
       throws IOException

创建一个流套接字并将其连接到指定 IP 地址的指定端口号。

如果应用程序已指定套接字工厂，则调用该工厂的 createSocketImpl 方法来创建实际套接字实现。否则创建“普通”套接字。

如果有安全管理器，则使用主机地址和 port 作为参数调用其 checkConnect 方法。这可能会导致 SecurityException 异常。

参数：

address - IP 地址。

port - 端口号。

抛出：

IOException - 如果创建套接字时发生 I/O 错误。

SecurityException - 如果安全管理器存在并且其 checkConnect 方法不允许进行该操作。

另请参见：

setSocketImplFactory(java.net.SocketImplFactory), SocketImpl, SocketImplFactory.createSocketImpl(), SecurityManager.checkConnect(java.lang.String, int)

Socket

public Socket(String host,
              int port,
              InetAddress localAddr,
              int localPort)
       throws IOException

创建一个套接字并将其连接到指定远程主机上的指定远程端口。socket 会通过调用 bind() 函数来绑定提供的本地地址及端口。

如果指定的主机为 null，则等效于指定与 InetAddress.getByName(null) 相同的地址。换句话话，等效于指定回送接口的地址。

如果有安全管理器，则使用主机地址和 port 作为参数调用其 checkConnect 方法。这可能会导致 SecurityException 异常。

参数：

host - 远程主机名，或者为 null，表示回送地址。

port - 远程端口

localAddr - 要将套接字绑定到的本地地址

localPort - 要将套接字绑定到的本地端口

抛出：

IOException - 如果在创建套接字时发生 I/O 错误。

SecurityException - 如果安全管理器存在并且其 checkConnect 方法不允许进行该操作。

从以下版本开始：

JDK1.1

另请参见：

SecurityManager.checkConnect(java.lang.String, int)

Socket

public Socket(InetAddress address,
              int port,
              InetAddress localAddr,
              int localPort)
       throws IOException

创建一个套接字并将其连接到指定远程地址上的指定远程端口。socket 会通过调用 bind() 函数来绑定提供的本地地址及端口。

如果有安全管理器，则使用主机地址和 port 作为参数调用其 checkConnect 方法。这可能会导致 SecurityException 异常。

参数：

address - 远程地址

port - 远程端口

localAddr - 要将套接字绑定到的本地地址

localPort - 要将套接字绑定到的本地端口

抛出：

IOException - 如果在创建套接字时发生 I/O 错误。

SecurityException - 如果安全管理器存在并且其 checkConnect 方法不允许进行该操作。

从以下版本开始：

JDK1.1

另请参见：

SecurityManager.checkConnect(java.lang.String, int)

Socket

@Deprecated
public Socket(String host,
                         int port,
                         boolean stream)
       throws IOException

已过时。  使用 DatagramSocket 取代 UDP 传输。

创建一个流套接字并将其连接到指定主机上的指定端口号。

如果指定的主机为 null，则等效于指定与 InetAddress.getByName(null) 相同的地址。换句话话，等效于指定回送接口的地址。

如果流参数为 true，则创建流套接字。如果流参数为 false，则创建数据报套接字。

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

如果有安全管理器，则使用主机地址和 port 作为参数调用其 checkConnect 方法。这可能会导致 SecurityException 异常。

如果使用 UDP 套接字，则不应用与 TCP/IP 相关的套接字选项。

参数：

host - 主机名，或者为 null，表示回送地址。

port - 端口号。

stream - 指示此为流套接字还是数据报套接字的 boolean。

抛出：

IOException - 如果创建套接字时发生 I/O 错误。

SecurityException - 如果安全管理器存在并且其 checkConnect 方法不允许进行该操作。

另请参见：

setSocketImplFactory(java.net.SocketImplFactory), SocketImpl, SocketImplFactory.createSocketImpl(), SecurityManager.checkConnect(java.lang.String, int)

Socket

@Deprecated
public Socket(InetAddress host,
                         int port,
                         boolean stream)
       throws IOException

已过时。  Use DatagramSocket instead for UDP transport.

创建一个套接字并将其连接到指定 IP 地址的指定端口号。

如果流参数为 true，则创建流套接字。如果流参数为 false，则创建数据报套接字。

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

如果有安全管理器，则使用 host.getHostAddress() 和 port 作为参数调用其 checkConnect 方法。这可能会导致 SecurityException 异常。

如果使用 UDP 套接字，则不应用与 TCP/IP 相关的套接字选项。

参数：

host - IP 地址。

port - 端口号。

stream - 如果为 true，则创建流套接字；否则创建数据报套接字。

抛出：

IOException - 如果创建套接字时发生 I/O 错误。

SecurityException - 如果安全管理器存在并且其 checkConnect 方法不允许进行该操作。

另请参见：

setSocketImplFactory(java.net.SocketImplFactory), SocketImpl, SocketImplFactory.createSocketImpl(), SecurityManager.checkConnect(java.lang.String, int)

connect

public void connect(SocketAddress endpoint)
             throws IOException

将此套接字连接到服务器。

参数：

endpoint - SocketAddress

抛出：

IOException - 如果在连接期间发生错误

IllegalBlockingModeException - 如果此套接字具有关联的通道并且该通道处于非阻塞模式

IllegalArgumentException - 如果端点为 null 或者此套接字不支持 SocketAddress 子类

从以下版本开始：

1.4

connect

public void connect(SocketAddress endpoint,
                    int timeout)
             throws IOException

将此套接字连接到服务器，并指定一个超时值。超时值零被解释为无限超时。在建立连接或者发生错误之前，连接一直处于阻塞状态。

参数：

endpoint - SocketAddress

timeout - 要使用的超时值（以毫秒为单位）。

抛出：

IOException - 如果在连接期间发生错误

SocketTimeoutException - 如果在连接之前超时期满

IllegalBlockingModeException - 如果此套接字具有关联的通道并且该通道处于非阻塞模式

IllegalArgumentException - 如果端点为 null 或者此套接字不支持 SocketAddress 子类

从以下版本开始：

1.4

bind

public void bind(SocketAddress bindpoint)
          throws IOException

将套接字绑定到本地地址。

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

参数：

bindpoint - 要绑定到的 SocketAddress

抛出：

IOException - 如果绑定操作失败或者已经绑定了套接字。

IllegalArgumentException - 如果 bindpoint 是不受此套接字支持的 SocketAddress 子类。

从以下版本开始：

1.4

另请参见：

isBound()

getInetAddress

public InetAddress getInetAddress()

返回套接字连接的地址。

返回：

此套接字连接到的远程 IP 地址；如果套接字是未连接的，则返回 null。

getLocalAddress

public InetAddress getLocalAddress()

获取套接字绑定的本地地址。

返回：

将套接字绑定到的本地地址；如果尚未绑定套接字，则返回 InetAddress.anyLocalAddress()。

从以下版本开始：

JDK1.1

getPort

public int getPort()

返回此套接字连接到的远程端口。

返回：

此套接字连接到的远程端口号；如果尚未连接套接字，则返回 0。

getLocalPort

public int getLocalPort()

返回此套接字绑定到的本地端口。

返回：

此套接字绑定到的本地端口号；如果尚未绑定套接字，则返回 -1。

getRemoteSocketAddress

public SocketAddress getRemoteSocketAddress()

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

返回：

表示此套接字远程端点的 SocketAddress，如果尚未连接则返回 null。

从以下版本开始：

1.4

另请参见：

getInetAddress(), getPort(), connect(SocketAddress, int), connect(SocketAddress)

getLocalSocketAddress

public SocketAddress getLocalSocketAddress()

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

返回：

表示此套接字的本地端点的 SocketAddress，如果尚未绑定则返回 null。

从以下版本开始：

1.4

另请参见：

getLocalAddress(), getLocalPort(), bind(SocketAddress)

getChannel

public SocketChannel getChannel()

返回与此数据报套接字关联的唯一 SocketChannel 对象（如果有）。

当且仅当通过 SocketChannel.open 或 ServerSocketChannel.accept 方法创建了通道本身时，套接字才具有一个通道。

返回：

与此套接字关联的套接字通道，如果没有为通道创建套接字，则返回 null。

从以下版本开始：

1.4

getInputStream

public InputStream getInputStream()
                           throws IOException

返回此套接字的输入流。

如果此套接字具有关联的通道，则所得的输入流会将其所有操作委托给通道。如果通道为非阻塞模式，则输入流的 read 操作将抛出 IllegalBlockingModeException。

在非正常条件下，底层连接可能被远程主机或网络软件中断（例如，TCP 连接情况下的连接重置）。当网络软件检测到中断的连接时，将对返回的输入流应用以下操作：

• 网络软件可能丢弃经过套接字缓冲的字节。网络软件没有丢弃的字节可以使用 read 读取。

• 如果没有任何字节在套接字上缓冲，或者 read 已经消耗了所有缓冲的字节，则对 read 的所有后续调用都将抛出 IOException。

• 如果没有任何字节在套接字上缓冲，并且没有使用 close 关闭套接字，则 available 将返回 0。

关闭返回的 InputStream 将关闭关联套接字。

返回：

从此套接字读取字节的输入流。

抛出：

IOException - 如果在创建输入流时发生 I/O 错误、没有关闭套接字、没有连接套接字或者使用 shutdownInput() 关闭了套接字输入

getOutputStream

public OutputStream getOutputStream()
                             throws IOException

返回此套接字的输出流。

如果此套接字具有关联的通道，则得到的输出流会将其所有操作委托给通道。如果通道为非阻塞模式，则输出流的 write 操作将抛出 IllegalBlockingModeException。

关闭返回的 OutputStream 将关闭关联套接字。

返回：

将字节写入此套接字的输出流。

抛出：

IOException - 如果创建输出流时发生 I/O 错误或者没有连接套接字。

setTcpNoDelay

public void setTcpNoDelay(boolean on)
                   throws SocketException

启用/禁用 TCP_NODELAY（启用/禁用 Nagle 算法）。

参数：

on - 为 true 表示启用 TCP_NODELAY；为 false 表示禁用。

抛出：

SocketException - 如果底层协议出现错误，例如 TCP 错误。

从以下版本开始：

JDK1.1

另请参见：

getTcpNoDelay()

getTcpNoDelay

public boolean getTcpNoDelay()
                      throws SocketException

测试是否启用 TCP_NODELAY。

返回：

指示是否启用 TCP_NODELAY 的 boolean 值。

抛出：

SocketException - 如果底层协议出现错误，例如 TCP 错误。

从以下版本开始：

JDK1.1

另请参见：

setTcpNoDelay(boolean)

setSoLinger

public void setSoLinger(boolean on,
                        int linger)
                 throws SocketException

启用/禁用具有指定逗留时间（以秒为单位）的 SO_LINGER。最大超时值是特定于平台的。 该设置仅影响套接字关闭。

参数：

on - 是否逗留。

linger - 逗留时间，如果 on 为 true。

抛出：

SocketException - 如果底层协议出现错误，例如 TCP 错误。

IllegalArgumentException - 如果逗留值为负。

从以下版本开始：

JDK1.1

另请参见：

getSoLinger()

getSoLinger

public int getSoLinger()
                throws SocketException

返回 SO_LINGER 的设置。返回 -1 意味着禁用该选项。 该设置仅影响套接字关闭。

返回：

SO_LINGER 的设置。

抛出：

SocketException - 如果底层协议出现错误，例如 TCP 错误。

从以下版本开始：

JDK1.1

另请参见：

setSoLinger(boolean, int)

sendUrgentData

public void sendUrgentData(int data)
                    throws IOException

在套接字上发送一个紧急数据字节。要发送的字节是数据参数的八个最低位。紧急字节在对套接字 OutputStream 的所有预先写入之后但在任何以后写入之前发送。

参数：

data - 要发送的数据字节

抛出：

IOException - 如果发送数据时发生错误。

从以下版本开始：

1.4