使用spring的restTemplate注意点

使用Spring的RestTemplate是在Java中向REST API发送HTTP请求的一种常见方法。它提供了许多方便的方法来处理HTTP请求和响应。使用RestTemplate时需要注意以下几点。

注意点一：配置RestTemplate的HttpClient

RestTemplate的默认实现使用HttpURLConnection作为底层客户端，然而在实际应用中，通常使用Apache HttpClient作为底层客户端。

使用Apache HttpClient作为底层客户端有以下优势：

• 更好的连接管理
• 更全面的HTTP协议支持
• 更好的性能

创建使用Apache HttpClient作为底层客户端的RestTemplate的示例如下：

RestTemplate restTemplate = new RestTemplate(clientHttpRequestFactory());

private ClientHttpRequestFactory clientHttpRequestFactory() {
    HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory();
    factory.setReadTimeout(5000);
    factory.setConnectTimeout(5000);
    return factory;
}

注意点二：处理超时

在发送HTTP请求时，超时是一个非常常见的问题。为避免不必要的等待和延迟，需要加入适当的超时设置。

在RestTemplate中，可以通过设置ClientHttpRequestFactory的连接超时时间和读取超时时间来处理超时。示例如下：

RestTemplate restTemplate = new RestTemplate(clientHttpRequestFactory());

private ClientHttpRequestFactory clientHttpRequestFactory() {
    HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory();
    factory.setReadTimeout(5000);
    factory.setConnectTimeout(5000);
    return factory;
}

在这个示例中，连接超时和读取超时都被设置为五秒。在这五秒内如果没有得到服务器的响应，将会抛出SocketTimeoutException。

注意点三：处理HTTP响应

RestTemplate可以处理多种HTTP响应，包括JSON、XML、字符串等。

对于JSON响应，可以使用exchange()方法和Jackson2HttpMessageConverter实现自动JSON序列化/反序列化。示例如下：

RestTemplate restTemplate = new RestTemplate(clientHttpRequestFactory());

List<HttpMessageConverter<?>> messageConverters = new ArrayList<>();
MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
converter.setSupportedMediaTypes(Collections.singletonList(MediaType.APPLICATION_JSON));
messageConverters.add(converter);

restTemplate.setMessageConverters(messageConverters);

ResponseEntity<List<User>> responseEntity = restTemplate.exchange(
    "http://localhost:8080/users", 
    HttpMethod.GET,
    null,
    new ParameterizedTypeReference<List<User>>() {});

在这个示例中，通过exchange()方法来执行GET请求，并使用匿名内部类作为响应类型。并使用Jackson2HttpMessageConverter自动完成对JSON格式响应的处理。

对于字符串响应，可以使用getForObject()或postForObject()方法即可。示例如下：

RestTemplate restTemplate = new RestTemplate(clientHttpRequestFactory());

String responseString = restTemplate.getForObject(
    "http://localhost:8080/hello?name={name}", 
    String.class, 
    "world");

在这个示例中，调用getForObject()方法以执行GET请求，并使用匿名内部类作为响应类型。最终将响应结果封装为字符串返回。