RestTemplate 是 Spring 框架中用于进行 HTTP 请求的一个工具类。它简化了与 RESTful 服务的交互，提供了多种方法来发送 HTTP 请求（如 GET、POST、PUT、DELETE 等）并处理响应。尽管在 Spring 5 之后，RestTemplate 被标记为过时（Deprecated），推荐使用 WebClient，但在许多现有的 Spring Boot 项目中，RestTemplate 仍然被广泛使用。

1. 引入依赖

在 Spring Boot 项目中使用 RestTemplate，首先需要在 pom.xml 中引入相关依赖：

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

2. 配置 RestTemplate

在 Spring Boot 中，可以通过 @Bean 注解将 RestTemplate 注入到 Spring 容器中：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.client.RestTemplate;

@Configuration
public class AppConfig {

    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}

3. 使用 RestTemplate 发送请求

RestTemplate 提供了多种方法来发送 HTTP 请求。以下是一些常见的示例：

3.1 GET 请求

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;

@Service
public class MyService {

    @Autowired
    private RestTemplate restTemplate;

    public String getData() {
        String url = "https://api.example.com/data";
        String response = restTemplate.getForObject(url, String.class);
        return response;
    }
}

3.2 POST 请求

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;

@Service
public class MyService {

    @Autowired
    private RestTemplate restTemplate;

    public String postData(String data) {
        String url = "https://api.example.com/data";
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);
        HttpEntity<String> request = new HttpEntity<>(data, headers);
        String response = restTemplate.postForObject(url, request, String.class);
        return response;
    }
}

3.3 PUT 请求

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;

@Service
public class MyService {

    @Autowired
    private RestTemplate restTemplate;

    public void updateData(String data) {
        String url = "https://api.example.com/data/1";
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);
        HttpEntity<String> request = new HttpEntity<>(data, headers);
        restTemplate.put(url, request);
    }
}

3.4 DELETE 请求

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;

@Service
public class MyService {

    @Autowired
    private RestTemplate restTemplate;

    public void deleteData() {
        String url = "https://api.example.com/data/1";
        restTemplate.delete(url);
    }
}

4. 应用场景

RestTemplate 适用于以下场景：

微服务通信‌：在微服务架构中，服务之间需要通过 HTTP 进行通信，RestTemplate 可以方便地实现这一点。

第三方 API 调用‌：当需要调用第三方提供的 RESTful API 时，RestTemplate 是一个很好的选择。

数据同步‌：在不同系统之间进行数据同步时，可以使用 RestTemplate 发送 HTTP 请求来获取或更新数据。

5. 注意事项

线程安全‌：RestTemplate 是线程安全的，可以在多个线程中共享同一个实例。

异常处理‌：RestTemplate 在请求失败时会抛出 RestClientException，建议在调用时进行异常处理。

性能优化‌：可以通过配置连接池、超时时间等参数来优化 RestTemplate 的性能。

6. 替代方案

在 Spring 5 之后，推荐使用 WebClient 作为 RestTemplate 的替代方案。WebClient 支持异步和非阻塞的 HTTP 请求，适合在高并发场景下使用。

import org.springframework.stereotype.Service;
import org.springframework.web.reactive.function.client.WebClient;
import reactor.core.publisher.Mono;

@Service
public class MyService {

    private final WebClient webClient = WebClient.create();

    public Mono<String> getData() {
        return webClient.get()
                .uri("https://api.example.com/data")
                .retrieve()
                .bodyToMono(String.class);
    }
}

总结

RestTemplate 是 Spring Boot 中用于 HTTP 请求的强大工具，尽管它已经被标记为过时，但在许多项目中仍然广泛使用。掌握 RestTemplate 的使用方法，可以帮助你更好地进行 RESTful 服务的交互。随着技术的发展，建议逐步迁移到 WebClient 等更现代的解决方案。