Java - Socket setSoTimeout(int timeout) 方法

描述

Java Socket setSoTimeout(int timeout) 方法用于启用/禁用 SO_TIMEOUT，以毫秒为单位指定超时时间。对于非零超时，与该 Socket 关联的 InputStream 上的 read() 调用将仅阻塞指定的时间量。如果超时过期，则会引发 java.net.SocketTimeoutException，尽管 Socket 仍然有效。必须在进入阻塞操作之前启用该选项才能生效。超时时间必须始终大于 0。零超时被解释为无限超时。

声明

以下是 java.net.Socket.setSoTimeout(int timeout) 方法的声明。

public void setSoTimeout(int timeout) throws SocketException

参数

timeout − 指定的超时时间，以毫秒为单位。

返回值

N/A

异常

SocketException − 如果底层协议中存在错误，例如 TCP 错误。

示例 1

以下示例演示了如何使用 Java Socket setSoTimeout() 方法设置 socket 实例的 SO_TIMEOUT 选项的值。第一步，我们使用无参数构造函数创建了一个 Socket 实例。然后，为了创建一个 SocketAddress 对象，我们初始化了一个 localhost 地址的 InetAddress 实例。使用 InetSocketAddress 对象，我们创建了一个 SocketAddress 对象，然后使用 bind() 方法将地址绑定到 socket。使用 setSoTimeout()，我们将 SO_TIMEOUT 选项的值设置为 1000。完成后，我们使用 getSoTimeout() 方法打印 SO_TIMEOUT 值、本地端口和 InetAddress，如下所示。最后，我们使用 close() 方法关闭了 socket。

package com.tutorialspoint;

import java.io.IOException;
import java.net.InetAddress;
import java.net.InetSocketAddress;
import java.net.Socket;
import java.net.SocketAddress;

public class SocketDemo {
   public static void main(String[] args) throws IOException {
      Socket socket = new Socket();  
      InetAddress inetAddress=InetAddress.getByName("localhost");  
      SocketAddress socketAddress=new InetSocketAddress(inetAddress, 6066);  
      socket.bind(socketAddress); 
      socket.setSoTimeout(1000);
      System.out.println("SO_TIMEOUT: "+socket.getSoTimeout()); 
      System.out.println("Port number: "+socket.getLocalPort()); 
      System.out.println("Inet Address: "+socket.getInetAddress()); 
      socket.close();
   }
}

输出

让我们编译并运行上述程序，这将产生以下结果：

SO_TIMEOUT: 1000
Port number: 6066
Inet Address: null

示例 2

以下示例演示了如何使用 Java Socket setSoTimeout() 方法设置 socket 实例的 SO_TIMEOUT 值。第一步，我们使用无参数构造函数创建了一个 Socket 实例。现在，我们使用 getSoTimeout() 方法打印 SO_TIMEOUT 值。然后，我们使用 setSoTimeout() 方法将 SO_TIMEOUT 值设置为 1 并打印相同的值。最后，我们使用 close() 方法关闭了 socket。

package com.tutorialspoint;

import java.io.IOException;
import java.net.Socket;

public class SocketDemo {
   public static void main(String[] args) throws IOException {
      Socket socket = new Socket();  

      System.out.println("SO_TIMEOUT: "+socket.getSoTimeout());
      socket.setSoTimeout(1000);  
      System.out.println("SO_TIMEOUT: "+socket.getSoTimeout());
      socket.close();
   }
}

输出

让我们编译并运行上述程序，这将产生以下结果：

SO_TIMEOUT: 0
SO_TIMEOUT: 1000

示例 3

以下示例演示了如果 socket 已关闭，如何使用 Java Socket setSoTimeout() 方法设置 socket 实例的 SO_TIMEOUT 值。第一步，我们使用无参数构造函数创建了一个 Socket 实例。使用 socket.close()，我们关闭了 socket。现在，我们使用 getSoTimeout() 方法打印 SO_TIMEOUT 标志。然后，我们使用 setSoTimeout() 方法将 SO_TIMEOUT 值设置为 1000 并打印相同的值。最后，我们使用 close() 方法关闭了 socket。由于 socket 已关闭，getSoTimeout() 方法调用会抛出异常，如下所示：

package com.tutorialspoint;

import java.io.IOException;
import java.net.Socket;

public class SocketDemo {
   public static void main(String[] args) throws IOException {
      Socket socket = new Socket();  
      socket.close();	  

      System.out.println("SO_TIMEOUT: "+socket.getSoTimeout());
      socket.setSoTimeout(1000);  
      System.out.println("SO_TIMEOUT: "+socket.getSoTimeout());
      socket.close();
   }
}

输出

让我们编译并运行上述程序，这将产生以下结果：

Exception in thread "main" java.net.SocketException: Socket is closed
	at java.base/java.net.Socket.getSoTimeout(Socket.java:1174)
	at com.tutorialspoint.SocketDemo.main(SocketDemo.java:11)