在Java中，RestTemplate 是一个用于同步客户端 HTTP 请求的工具，常用于消费 RESTful web服务。当我们需要通过 RestTemplate 上传或发送文件时，通常涉及到使用 MultiValueMap 来构建 multipart 请求。以下是如何使用 RestTemplate 进行带有文件参数的高级应用案例。
发送单个文件
首先，我们会构建 MultiValueMap 以包含我们要发送的文件和其它表单参数。然后，我们使用 RestTemplate 的 postForObject 或 exchange 方法来发送请求。
RestTemplate restTemplate = new RestTemplate();
// 设置请求的 headers
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.MULTIPART_FORM_DATA);
// 创建一个 FileSystemResource 用于发送文件
FileSystemResource fileResource = new FileSystemResource(new File("path/to/your/file"));
// 使用 MultiValueMap 来封装文件资源和其他表单字段
MultiValueMap body = new LinkedMultiValueMap<>();
body.add("file", fileResource);
body.add("param1", "value1");
// 创建 HttpEntity 对象
HttpEntity> requestEntity = new HttpEntity<>(body, headers);
// 发送请求并获取响应
ResponseEntity response = restTemplate.postForEntity("http://example.com/upload", requestEntity, String.class);
发送多个文件
如果需要发送多个文件，我们可以继续往 MultiValueMap 中添加多个文件资源。
// 添加多个文件资源
body.add("file2", new FileSystemResource(new File("path/to/your/second/file")));
body.add("file3", new FileSystemResource(new File("path/to/your/third/file")));
设置连接与读取超时时间
创建 RestTemplate 实例时，可能需要设置连接超时和读取超时时间，这通常通过 ClientHttpRequestFactory 实现。
HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory();
factory.setConnectTimeout(3000);
factory.setReadTimeout(3000);
RestTemplate restTemplate = new RestTemplate(factory);
错误处理
正确的错误处理对于 RestTemplate 的高级使用也是至关重要的。自定义错误处理器可以帮助我们更精细地控制如何处理不同的 HTTP 状态码。
restTemplate.setErrorHandler(new ResponseErrorHandler() {
@Override
public boolean hasError(ClientHttpResponse response) throws IOException {
// 根据状态码判断是否为错误响应
return (
response.getStatusCode().series() == HttpStatus.Series.CLIENT_ERROR ||
response.getStatusCode().series() == HttpStatus.Series.SERVER_ERROR
);
}
@Override
public void handleError(ClientHttpResponse response) throws IOException {
// 自定义错误处理逻辑
if (response.getStatusCode() == HttpStatus.NOT_FOUND) {
throw new FileNotFoundException();
}
}
});
此外，高级案例可能还包括配置消息转换器来支持不同类型的内容，使用拦截器在请求发送前后进行处理，或是配置 SSL/TLS 以进行安全的 https 通信。
将这些高级特性组合起来，可以创建一个 RestTemplate 实例，它能够处理各种复杂的请求场景，包括大型文件上传、安全的 https 传输和详细的错误管理，在与外部服务的交互过程中提供强大和灵活的 HTTP 客户端功能。
