Spring RestTemplate使用方法总结

干翻全岛蛙蛙  论坛元老 | 2025-4-11 09:21:26 | 显示全部楼层 | 阅读模式
打印 上一主题 下一主题
楼主

主题 1516|帖子 1516|积分 4548

1. 引入依赖

首先，需要确认项目中是否直接大概间接引入过spring-web依赖，如果没有引入过，需要在pom.xml中添加以下代码引入依赖：
  1. <dependency>
  2.     <groupId>org.springframework</groupId>
  3.     <artifactId>spring-web</artifactId>
  4.     <version>4.3.24.RELEASE</version>
  5. </dependency>
复制代码
2. 发送GET请求

使用RestTemplate发送GET请求主要有getForObject()和getForEntity()2个方法，每个方法分别提供了3种不同的重载。
2.1 使用getForObject发送GET请求(无参数)

使用getForObject()实现：
  1. RestTemplate restTemplate = new RestTemplate();
  3. String url = "https://www.example.com/getCurrentEnv";
  4. String response = restTemplate.getForObject(url, String.class);
  5. System.out.println(response);
复制代码
假设以上接口返回的报文为：
  1. {
  2.     "serverAddress": "www.example.dev.com",
  3.     "env": "dev"
  4. }
复制代码
也可以直接解析为自定义的范例：
  1. import lombok.Getter;
  2. import lombok.Setter;
  4. @Getter
  5. @Setter
  6. public class EnvInfo {
  7.     private String serverAddress;
  9.     private String env;
  10. }
复制代码
  1. RestTemplate restTemplate = new RestTemplate();
  3. String url = "https://www.example.com/getCurrentEnv";
  4. EnvInfo response = restTemplate.getForObject(url, EnvInfo.class);
  5. System.out.println(JSON.toJSONString(response));
复制代码
2.2 使用getForEntity发送GET请求(无参数)

也可以使用getForEntity()实现和2.1同样的功能，代码如下所示：
  1. RestTemplate restTemplate = new RestTemplate();
  3. String url = "https://www.example.com/getCurrentEnv";
  4. ResponseEntity<EnvInfo> responseEntity = restTemplate.getForEntity(url, EnvInfo.class);
  5. if (responseEntity.getStatusCode() == HttpStatus.OK) {
  6.     EnvInfo response = responseEntity.getBody();
  7.     System.out.println(JSON.toJSONString(response));
  8. }
复制代码
2.3 使用getForObject发送GET请求(带参数)

第一种方法是直接在url上拼接上参数，如下所示：
  1. RestTemplate restTemplate = new RestTemplate();
  3. String url = "https://www.example.com/getDataList?pageIndex=1&pageSize=20";
  4. EnvInfo response = restTemplate.getForObject(url, EnvInfo.class);
  5. System.out.println(JSON.toJSONString(response));
复制代码
第二种方法是使用占位符添加参数，如下所示：
  1. RestTemplate restTemplate = new RestTemplate();
  3. String url = "https://www.example.com/getDataList?pageIndex={1}&pageSize={2}";
  4. EnvInfo response = restTemplate.getForObject(url, EnvInfo.class, 1, 20);
  5. System.out.println(JSON.toJSONString(response));
复制代码
以上代码也可以替换为：
  1. RestTemplate restTemplate = new RestTemplate();
  3. String url = "https://www.example.com/getDataList?pageIndex={pageIndex}&pageSize={pageSize}";
  4. Map<String, String> uriVariables = new HashMap<>();
  5. uriVariables.put("pageIndex", "1");
  6. uriVariables.put("pageSize", "20");
  7. EnvInfo response = restTemplate.getForObject(url, EnvInfo.class, uriVariables);
  8. System.out.println(JSON.toJSONString(response));
复制代码
留意事项：
uriVariables中的key必须和url中的占位符名称一致，否则会抛出非常：
java.lang.IllegalArgumentException: Map has no value for 'pageIndex'
第三种方法是使用UriComponentsBuilder添加参数，该种方法相比于前两种方法更加机动，可以实现动态添加参数，代码如下所示：
  1. RestTemplate restTemplate = new RestTemplate();
  3. String httpUrl = "https://www.example.com/getDataList";
  4. UriComponentsBuilder uriComponentsBuilder = UriComponentsBuilder.fromHttpUrl(httpUrl);
  5. uriComponentsBuilder.queryParam("pageIndex", 1);
  6. uriComponentsBuilder.queryParam("pageSize", 20);
  8. String url = uriComponentsBuilder.toUriString();
  9. EnvInfo response = restTemplate.getForObject(url, EnvInfo.class);
  10. System.out.println(JSON.toJSONString(response));
复制代码
2.4 使用getForEntity发送GET请求(带参数)

也可以使用getForEntity()实现和2.3同样的功能，代码如下所示：
  1. RestTemplate restTemplate = new RestTemplate();
  3. String httpUrl = "https://www.example.com/getDataList";
  4. UriComponentsBuilder uriComponentsBuilder = UriComponentsBuilder.fromHttpUrl(httpUrl);
  5. uriComponentsBuilder.queryParam("pageIndex", 1);
  6. uriComponentsBuilder.queryParam("pageSize", 20);
  8. String url = uriComponentsBuilder.toUriString();
  9. ResponseEntity<EnvInfo> responseEntity = restTemplate.getForEntity(url, EnvInfo.class);
  10. if (responseEntity.getStatusCode() == HttpStatus.OK) {
  11.     EnvInfo response = responseEntity.getBody();
  12.     System.out.println(JSON.toJSONString(response));
  13. }
复制代码
2.5 getForObject与getForEntity的区别

getForEntity()与getForObject()相比，返回值用了ResponseEntity进行封装，可以多获取到以下2种信息：

  • HTTP状态码
  • Response Headers
代码示例：
  1. RestTemplate restTemplate = new RestTemplate();
  3. String httpUrl = "https://www.example.com/getDataList";
  4. UriComponentsBuilder uriComponentsBuilder = UriComponentsBuilder.fromHttpUrl(httpUrl);
  5. uriComponentsBuilder.queryParam("pageIndex", 1);
  6. uriComponentsBuilder.queryParam("pageSize", 20);
  8. String url = uriComponentsBuilder.toUriString();
  9. ResponseEntity<EnvInfo> responseEntity = restTemplate.getForEntity(url, EnvInfo.class);
  10. System.out.println("statusCode: " + responseEntity.getStatusCode().toString());
  11. System.out.println("statusCodeValue: " + responseEntity.getStatusCodeValue());
  12. responseEntity.getHeaders().forEach((key, values) -> {
  13.     System.out.println(key + ": " + values);
  14. });
复制代码
输出结果：
statusCode: 200
statusCodeValue: 200
Server: [openresty]
Date: [Thu, 10 Apr 2025 05:39:02 GMT]
Content-Type: [application/json]
Transfer-Encoding: [chunked]
Connection: [keep-alive]
其中Response Headers输出部分和Chrome浏览器Network中的Response Headers是一致的：

2.6 发送GET请求(带参数及请求头)

一般情况下，请求第三方接口都需要签名、时间戳等请求头，但getForObject()和getForEntity()都不支持，
此时需要使用exchange()方法，代码如下所示：
  1. RestTemplate restTemplate = new RestTemplate();
  3. String httpUrl = "https://www.example.com/getDataList";
  4. UriComponentsBuilder uriComponentsBuilder = UriComponentsBuilder.fromHttpUrl(httpUrl);
  5. uriComponentsBuilder.queryParam("pageIndex", 1);
  6. uriComponentsBuilder.queryParam("pageSize", 20);
  8. HttpHeaders headers = new HttpHeaders();
  9. headers.set("signature", "3045022100875efcef9eb54626bb0168a6baa7c61265d0001d49243f");
  10. headers.set("timestamp", String.valueOf(System.currentTimeMillis()));
  12. String url = uriComponentsBuilder.toUriString();
  13. ResponseEntity<EnvInfo> responseEntity = restTemplate.exchange(url,
  14.         HttpMethod.GET,
  15.         new HttpEntity<>(headers),
  16.         EnvInfo.class);
  17. if (responseEntity.getStatusCode() == HttpStatus.OK) {
  18.     EnvInfo response = responseEntity.getBody();
  19.     System.out.println(JSON.toJSONString(response));
  20. }
复制代码
3. 发送POST请求

使用RestTemplate发送POST请求主要有postForObject()和postForEntity()2个方法，每个方法分别提供了3种不同的重载。
3.1 发送POST请求(带参数、json方式)

使用postForObject()实现：
  1. RestTemplate restTemplate = new RestTemplate();
  3. HttpHeaders headers = new HttpHeaders();
  4. headers.setContentType(MediaType.APPLICATION_JSON_UTF8);
  6. LoginParams loginParams = new LoginParams();
  7. loginParams.setUsername("zhangsan");
  8. loginParams.setPassword("123456");
  10. HttpEntity<LoginParams> request = new HttpEntity<>(loginParams, headers);
  12. String url = "https://www.example.com/login";
  13. String response = restTemplate.postForObject(url, request, String.class);
  14. System.out.println(response);
复制代码
LoginParams的定义如下所示：
  1. import lombok.Getter;
  2. import lombok.Setter;
  4. @Getter
  5. @Setter
  6. public class LoginParams {
  7.     private String username;
  9.     private String password;
  10. }
复制代码
假设以上接口返回的报文为：
  1. {
  2.     "code": 200,
  3.     "expire": "2025-04-11 14:42:22",
  4.     "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NDQzNTM3NDIsImlkZW50aXR5"
  5. }
复制代码
也可以直接解析为自定义的范例：
  1. import lombok.Getter;
  2. import lombok.Setter;
  4. @Getter
  5. @Setter
  6. public class LoginResponse {
  7.     private Integer code;
  9.     private String expire;
  11.     private String token;
  12. }
复制代码
  1. RestTemplate restTemplate = new RestTemplate();
  3. HttpHeaders headers = new HttpHeaders();
  4. headers.setContentType(MediaType.APPLICATION_JSON_UTF8);
  6. LoginParams loginParams = new LoginParams();
  7. loginParams.setUsername("zhangsan");
  8. loginParams.setPassword("123456");
  10. HttpEntity<LoginParams> request = new HttpEntity<>(loginParams, headers);
  12. String url = "https://www.example.com/login";
  13. LoginResponse response = restTemplate.postForObject(url, request, LoginResponse.class);
  14. System.out.println(JSON.toJSONString(response));
复制代码
也可以使用postForEntity()实现同样的功能，代码如下所示：
  1. ResponseEntity<LoginResponse> responseEntity = restTemplate.postForEntity(url, request, LoginResponse.class);
  2. if (responseEntity.getStatusCode() == HttpStatus.OK) {
  3.     LoginResponse response = responseEntity.getBody();
  4.     System.out.println(JSON.toJSONString(response));
  5. }
复制代码
3.2 发送POST请求(带参数、form表单方式)

使用postForObject()实现：
  1. RestTemplate restTemplate = new RestTemplate();
  3. HttpHeaders headers = new HttpHeaders();
  4. headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);
  6. MultiValueMap<String, String> map = new LinkedMultiValueMap<>();
  7. map.add("username", "zhangsan");
  8. map.add("password", "123456");
  10. HttpEntity<MultiValueMap<String, String>> request = new HttpEntity<>(map, headers);
  12. String url = "https://www.example.com/login";
  13. LoginResponse response = restTemplate.postForObject(url, request, LoginResponse.class);
  14. System.out.println(JSON.toJSONString(response));
复制代码
也可以使用postForEntity()实现同样的功能，代码如下所示：
  1. ResponseEntity<LoginResponse> responseEntity = restTemplate.postForEntity(url, request, LoginResponse.class);
  2. if (responseEntity.getStatusCode() == HttpStatus.OK) {
  3.     LoginResponse response = responseEntity.getBody();
  4.     System.out.println(JSON.toJSONString(response));
  5. }
复制代码
3.3 postForObject与postForEntity的区别

postForObject()与postForEntity()的区别，与getForEntity()与getForObject()的区别一样，
返回值用了ResponseEntity进行封装。
4. 超时时间设置

如果需要自定义HTTP请求的毗连超时时间和数据传输超时时间，代码如下所示：
  1. import org.springframework.beans.factory.annotation.Value;
  2. import org.springframework.context.annotation.Bean;
  3. import org.springframework.context.annotation.Configuration;
  4. import org.springframework.http.client.SimpleClientHttpRequestFactory;
  5. import org.springframework.web.client.RestTemplate;
  7. @Configuration
  8. public class RestTemplateConfig {
  9.     @Value("${restTemplate.connectTimeout:5000}")
  10.     private int connectTimeout;
  12.     @Value("${restTemplate.readTimeout:10000}")
  13.     private int readTimeout;
  15.     @Bean
  16.     public RestTemplate restTemplate() {
  17.         SimpleClientHttpRequestFactory simpleClientHttpRequestFactory = new SimpleClientHttpRequestFactory();
  18.         simpleClientHttpRequestFactory.setConnectTimeout(connectTimeout);
  19.         simpleClientHttpRequestFactory.setReadTimeout(readTimeout);
  21.         return new RestTemplate(simpleClientHttpRequestFactory);
  22.     }
  23. }
复制代码
文章持续更新，欢迎关注微信公众号「申城异乡人」第一时间阅读！

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

本帖子中包含更多资源

您需要 登录 才可以下载或查看，没有账号？立即注册

x
回复

使用道具 举报

0 个回复

倒序浏览
返回列表

快速回复

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

干翻全岛蛙蛙

论坛元老
这个人很懒什么都没写!

楼主热帖

标签云

AI 运维 CIO 存储 服务器
微信订阅号
微信服务号
微信客服
小程序
H5
关于我们 商务合作 网站地图
©Copyright 2022-2024 杭州祥升科技有限公司 版权所有 浙ICP备20004199号
快速回复 返回顶部 返回列表