如何在Java中设置RestTemplate的请求超时时间

一、RestTemplate简介

RestTemplate是Spring Framework提供的一个用于访问RESTful服务的模板类。它提供了一套基于REST的服务的高层抽象，并封装了HTTP协议包括GET、POST、PUT和DELETE等请求方法，以及对象序列化和反序列化等功能。在Java应用中，RestTemplate是访问RESTful服务的一个非常常用的工具类。

二、RestTemplate设置超时时间的必要性

在默认情况下，RestTemplate没有设置请求超时时间，这意味着当应用程序请求响应超过默认时间时，应用程序将阻塞并一直等待直到接收到响应或发生超时异常。为了更好地控制应用程序响应时间并防止请求过度阻塞，我们需要手动设置RestTemplate请求超时时间。

三、RestTemplate设置超时时间的方法

1、全局设置

可以通过配置RestTemplateBuilder对象的setConnectTimeout()和setReadTimeout()方法对所有的RestTemplate实例设置全局的请求超时时间。例如：

RestTemplateBuilder builder = new RestTemplateBuilder();
builder.setConnectTimeout(Duration.ofMillis(1000));
builder.setReadTimeout(Duration.ofMillis(5000));
RestTemplate restTemplate = builder.build();

上述代码中，我们使用RestTemplateBuilder对象设置请求连接超时时间为1000毫秒，读取超时时间为5000毫秒。此时，通过restTemplate对象发出的所有请求都将遵循这个超时配置。

2、针对单个请求设置

除了全局设置超时时间外，我们还可以针对某些重要的请求单独设置超时时间。在RestTemplate中，我们可以使用ClientHttpRequest的实现类（如SimpleClientHttpRequestFactory）的setConnectTimeout()和setReadTimeout()方法设置超时时间。例如：

SimpleClientHttpRequestFactory requestFactory = new SimpleClientHttpRequestFactory();
requestFactory.setConnectTimeout(1000);
requestFactory.setReadTimeout(5000);
RestTemplate restTemplate = new RestTemplate(requestFactory);

上述代码中，我们使用SimpleClientHttpRequestFactory创建了一个特定的请求工厂，并设置请求连接超时时间为1000毫秒、读取超时时间为5000毫秒。此时，通过restTemplate对象发出的所有请求都将遵循这个请求工厂的超时配置。

四、完整示例代码

/**
 * RestTemplate设置超时时间示例代码
 */
public class RestTemplateTimeoutDemo {

    public static void main(String[] args) {
        // 全局设置超时时间
        RestTemplateBuilder builder = new RestTemplateBuilder();
        builder.setConnectTimeout(Duration.ofMillis(1000));
        builder.setReadTimeout(Duration.ofMillis(5000));
        RestTemplate restTemplate = builder.build();

        // 单个请求设置超时时间
        SimpleClientHttpRequestFactory requestFactory = new SimpleClientHttpRequestFactory();
        requestFactory.setConnectTimeout(1000);
        requestFactory.setReadTimeout(5000);
        RestTemplate restTemplateTimeout = new RestTemplate(requestFactory);

        // 请求超过全局设置超时时间，应用程序将抛出超时异常
        try {
            restTemplate.getForObject("http://slowapi.com/delay/5", String.class);
        } catch (RuntimeException e) {
            System.out.println("全局设置超时时间，请求超时");
            e.printStackTrace();
        }

        // 请求超过单个请求设置超时时间，应用程序将抛出超时异常
        try {
            restTemplateTimeout.getForObject("http://slowapi.com/delay/5", String.class);
        } catch (RuntimeException e) {
            System.out.println("单个请求设置超时时间，请求超时");
            e.printStackTrace();
        }
    }
}