四、POST 请求1:postForObject() 方法的使用
1,方法介绍
postForObject() 用于发送一个 HTTP POST 请求。它和 postForEntity() 用法几乎相同。区别在于 postForObject() 返回值返回的是响应体,省略了很多 response 的信息。
2,发送一个 JSON 格式数据
(1)下面代码使用 post 方式发送一个 Bean 对象,并将结果打印出来(以字符串的形式)。
@RestController public class HelloController { @Autowired private RestTemplate restTemplate; @GetMapping("/test") public void test() { // 请求地址 String url = "http://jsonplaceholder.typicode.com/posts"; // 要发送的数据对象 PostBean postBean = new PostBean(); postBean.setUserId(222); postBean.setTitle("abc"); postBean.setBody("航歌"); // 发送post请求,并输出结果 String result = restTemplate.postForObject(url, postBean, String.class); System.out.println(result); return; } }
(2)上面发送的 Bean 对象实际上会转成如下格式的 JSON 数据提交:
3,使用 Form 表单的形式提交数据
(1)下面样例使用 POST 方式发送 multipart/form-data 格式的数据:
@RestController public class HelloController { @Autowired private RestTemplate restTemplate; @GetMapping("/test") public void test() { // 请求地址 String url = "http://jsonplaceholder.typicode.com/posts"; // 请求头设置 HttpHeaders headers = new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED); //提交参数设置 MultiValueMapmap = new LinkedMultiValueMap<>(); map.add("title", "abc"); map.add("body", "航歌"); // 组装请求体 HttpEntity > request = new HttpEntity >(map, headers); // 发送post请求,并输出结果 String result = restTemplate.postForObject(url, request, String.class); System.out.println(result); return; } }
(2)上面代码最终会通过如下这种 form 表单方式提交数据:
4,将结果转成自定义对象
上面样例我们都是将响应结果以 String 形式接收,其实 RestTemplate 还可以自动将响应结果转成自定的对象或则数组。具体可以参考我前面写的文章:
5,设置 url 参数
(1)如果 url 地址上面需要传递一些参数,可以使用占位符的方式:
String url = "http://jsonplaceholder.typicode.com/{1}/{2}"; String url = "http://jsonplaceholder.typicode.com/{type}/{id}";
(2)具体的用法可以参考我前面写的文章:
五、POST 请求2:postForEntity()方法的使用
1,方法介绍
postForEntity() 用于发送一个 HTTP POST 请求。它和上面的 postForObject() 用法几乎相同。区别在于 getForEntity() 返回的是 ResponseEntity<T>:
- ResponseEntity<T> 是 Spring 对 HTTP 请求响应的封装,包括了几个重要的元素,如响应码、contentType、contentLength、响应消息体等。
- 其中响应消息体可以通过 ResponseEntity 对象的 getBody() 来获取。
2,发送一个 JSON 格式数据
(1)下面代码使用 post 方式发送一个 Bean 对象,并将响应体、响应头、响应码打印出来。其中响应体的类型设置为 String。
@RestController public class HelloController { @Autowired private RestTemplate restTemplate; @GetMapping("/test") public void test() { // 请求地址 String url = "http://jsonplaceholder.typicode.com/posts"; // 要发送的数据对象 PostBean postBean = new PostBean(); postBean.setUserId(222); postBean.setTitle("abc"); postBean.setBody("航歌"); // 发送post请求,并输出结果 ResponseEntityresponseEntity = restTemplate.postForEntity(url, postBean, String.class); String body = responseEntity.getBody(); // 获取响应体 HttpStatus statusCode = responseEntity.getStatusCode(); // 获取响应码 int statusCodeValue = responseEntity.getStatusCodeValue(); // 获取响应码值 HttpHeaders headers = responseEntity.getHeaders(); // 获取响应头 System.out.println("body:" + body); System.out.println("statusCode:" + statusCode); System.out.println("statusCodeValue:" + statusCodeValue); System.out.println("headers:" + headers); return; } }
(2)上面发送的 Bean 对象实际上会转成如下格式的 JSON 数据提交:
3,使用 Form 表单的形式提交数据
(1)下面样例使用 POST 方式发送 multipart/form-data 格式的数据:
@RestController public class HelloController { @Autowired private RestTemplate restTemplate; @GetMapping("/test") public void test() { // 请求地址 String url = "http://jsonplaceholder.typicode.com/posts"; // 请求头设置 HttpHeaders headers = new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED); //提交参数设置 MultiValueMapmap = new LinkedMultiValueMap<>(); map.add("title", "abc"); map.add("body", "航歌"); // 组装请求体 HttpEntity > request = new HttpEntity >(map, headers); // 发送post请求,并输出结果 ResponseEntity responseEntity = restTemplate.postForEntity(url, request, String.class); String body = responseEntity.getBody(); // 获取响应体 HttpStatus statusCode = responseEntity.getStatusCode(); // 获取响应码 int statusCodeValue = responseEntity.getStatusCodeValue(); // 获取响应码值 HttpHeaders respoensHeaders = responseEntity.getHeaders(); // 获取响应头 System.out.println("body:" + body); System.out.println("statusCode:" + statusCode); System.out.println("statusCodeValue:" + statusCodeValue); System.out.println("headers:" + respoensHeaders); return; } }
(2)上面代码最终会通过如下这种 form 表单方式提交数据:
4,将结果转成自定义对象
上面样例我们都是将响应结果以 String 形式接收,其实 RestTemplate 还可以自动将响应结果转成自定的对象或则数组。具体可以参考我前面写的文章:
5,设置 url 参数
(1)如果 url 地址上面需要传递一些参数,可以使用占位符的方式:
String url = "http://jsonplaceholder.typicode.com/{1}/{2}"; String url = "http://jsonplaceholder.typicode.com/{type}/{id}";
(2)具体的用法可以参考我前面写的文章:
六、POST 请求3:postForLocation() 方法的使用
1,方法介绍
(1)postForLocation() 也是通过 Post 方式提交新资源,postForLocation() 方法的参数和前面两种(postForObject、postForEntity)的参数基本一致。
(2)区别在于 postForLocation() 方法的返回值为 Uri,这个只需要服务提供者返回一个 Uri 即可,该 Uri 表示新资源的位置。
2,使用样例
(1)比如通常登录或者注册都是 post 请求,而这些操作完成之后大部分都是跳转到别的页面去了。这种场景下,就可以使用 postForLocation 了,提交数据,并获取返回的 URI。
(2)下面是一个简单的样例代码:
@RestController public class HelloController { @Autowired private RestTemplate restTemplate; @GetMapping("/test") public void test() { // 请求地址 String url = "http://jsonplaceholder.typicode.com/posts"; // 要发送的数据对象 MultiValueMaprequest = new LinkedMultiValueMap<>(); request.add("username", "hangge"); request.add("password", "123456"); // 发送post请求,并输出结果 URI uri = restTemplate.postForLocation(url, request); System.out.println(uri); return; }