Spring Boot-休息模板

介绍

Spring Boot-休息模板（Rest Template）是Spring Framework中的一个核心组件，提供了一种方便的方式来进行HTTP请求。它是一个简单的RESTful客户端实现，用于调用RESTful Web服务，并将结果映射为Java对象。使用Rest Template，可以轻松地与RESTful Web服务进行交互，而无需复杂的配置。

Rest Template提供了许多方便的方法来发送HTTP请求，并支持多种HTTP方法，如GET，POST，PUT和DELETE。它还支持文件上传和下载。Rest Template提供了许多自定义选项，包括请求头，参数，身份验证等。

使用

添加依赖

在使用Rest Template之前，我们要先在项目中添加依赖。在pom.xml文件中添加以下依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web-services</artifactId>
</dependency>

发送GET请求

使用Rest Template发送GET请求非常简单。我们只需要创建一个Rest Template实例，然后使用它来发送请求。以下是一个发送GET请求的示例：

RestTemplate restTemplate = new RestTemplate();

String url = "https://example.com/api/users";

ResponseEntity<User[]> responseEntity = restTemplate.getForEntity(url, User[].class);

User[] users = responseEntity.getBody();

在上面的示例中，我们创建了一个Rest Template实例，并使用它来发送GET请求。我们指定了URL，然后调用getForEntity方法。这个方法返回一个ResponseEntity对象，其中包含HTTP响应的状态码，头信息和响应体。我们使用getBody方法从响应实体中获取用户数组。

发送POST请求

使用Rest Template发送POST请求也非常简单。我们只需要创建一个包含请求体的对象，然后使用Rest Template发送POST请求。以下是一个发送POST请求的示例：

RestTemplate restTemplate = new RestTemplate();

String url = "https://example.com/api/users";

User newUser = new User("John", "Doe");

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);

HttpEntity<User> requestEntity = new HttpEntity<>(newUser, headers);

ResponseEntity<User> responseEntity = restTemplate.postForEntity(url, requestEntity, User.class);

User user = responseEntity.getBody();

在上面的示例中，我们创建了一个Rest Template实例，并使用它来发送POST请求。我们创建了一个包含请求体的User对象，并将其作为参数传递给HttpEntity构造函数。我们还创建了一个包含Content-Type头的HttpHeaders对象。我们使用Rest Template的postForEntity方法发送POST请求，指定URL和请求实体。这个方法返回一个ResponseEntity对象，其中包含HTTP响应的状态码，头信息和响应体。我们使用getBody方法从响应实体中获取用户对象。

自定义Rest Template

除了默认的Rest Template实例外，我们还可以自定义Rest Template实例，以满足不同的需求。以下是一个自定义Rest Template实例的示例：

@Bean
public RestTemplate customRestTemplate() {
    RestTemplate restTemplate = new RestTemplate();

    restTemplate.getMessageConverters().add(new MappingJackson2HttpMessageConverter());

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

    return restTemplate;
}

在上面的示例中，我们使用@Bean注解创建一个自定义的Rest Template bean。我们使用getMessageConverters方法获取Rest Template的消息转换器列表，并添加一个MappingJackson2HttpMessageConverter实例，以支持JSON请求。我们还创建了一个SimpleClientHttpRequestFactory实例，并设置连接超时和读取超时。最后，我们将这个请求工厂设置为Rest Template的请求工厂。

总结

Rest Template是一个非常方便的RESTful客户端实现，用于调用RESTful Web服务，并将结果映射为Java对象。它提供了许多方便的方法来发送HTTP请求，并支持多种HTTP方法，如GET，POST，PUT和DELETE。使用Rest Template，可以轻松地与RESTful Web服务进行交互，而无需复杂的配置。我们还可以自定义Rest Template实例，以满足不同的需求。