Spring MVC 教程-接口调用利器RestTemplate

本文介绍Spring web中特别牛逼的一个类RestTemplate。

1、RestTemplate概述

发送http请求，估计很多人用过httpclient和okhttp，确实挺好用的，而Spring web中的RestTemplate和这俩的功能类似，也是用来发送http请求的，不过用法上面比前面的2位要容易很多。

spring框架提供的RestTemplate类可用于在应用中调用rest服务，它简化了与http服务的通信方式，统一了RESTful的标准，封装了http链接，我们只需要传入url及返回值类型即可。相较于之前常用的HttpClient，RestTemplate是一种更优雅的调用RESTful服务的方式。

在Spring应用程序中访问第三方REST服务与使用Spring RestTemplate类有关。RestTemplate类的设计原则与许多其他Spring模板类(例如JdbcTemplate、JmsTemplate)相同，为执行复杂任务提供了一种具有默认行为的简化方法。

RestTemplate默认依赖JDK提供http连接的能力（HttpURLConnection），如果有需要的话也可以通过setRequestFactory方法替换为例如 Apache HttpComponents、Netty或OkHttp等其它HTTP library。

考虑到RestTemplate类是为调用REST服务而设计的，因此它的主要方法与REST的基础紧密相连就不足为奇了，后者是HTTP协议的方法:HEAD、GET、POST、PUT、DELETE和OPTIONS。例如，RestTemplate类具有headForHeaders()、getForObject()、postForObject()、put()和delete()等方法。

下面给大家上案例，案例是重点，通过案例，把我知道的用法都给盘出来。

2、案例代码

2.1、git地址

    https://gitee.com/javacode2018/springmvc-series

2.2、关键代码位置

文中的所有controller代码，在RestTemplateTestController类中。

所有@Test用例的代码，在RestTemplateTest。

2.3、如何运行测试用例？

拉取项目
将chat16-RestTemplate模块发布到tomcat9中
运行RestTemplateTest中对应的用例即可

下面咱们来看RestTemplate常见的用法汇总。

3、发送Get请求

3.1、普通请求

接口代码

    @GetMapping("/test/get")
    @ResponseBody
    public BookDto get() {
        return new BookDto(1, "SpringMVC系列");
    }

使用RestTemplate调用上面这个接口，通常有2种写法，如下

    @Test
    public void test1() {
        RestTemplate restTemplate = new RestTemplate();
        String url = "http://localhost:8080/chat16/test/get";
        //getForObject方法，获取响应体，将其转换为第二个参数指定的类型
        BookDto bookDto = restTemplate.getForObject(url, BookDto.class);
        System.out.println(bookDto);
    }
    
    @Test
    public void test2() {
        RestTemplate restTemplate = new RestTemplate();
        String url = "http://localhost:8080/chat16/test/get";
        //getForEntity方法，返回值为ResponseEntity类型
        // ResponseEntity中包含了响应结果中的所有信息，比如头、状态、body
        ResponseEntity<BookDto> responseEntity = restTemplate.getForEntity(url, BookDto.class);
        //状态码
        System.out.println(responseEntity.getStatusCode());
        //获取头
        System.out.println("头：" + responseEntity.getHeaders());
        //获取body
        BookDto bookDto = responseEntity.getBody();
        System.out.println(bookDto);
    }

test1输出

    BookDto{id=1, name='SpringMVC系列'}

test2输出

    200 OK
    头：[Content-Type:"application/json;charset=UTF-8", Transfer-Encoding:"chunked", Date:"Sat, 02 Oct 2021 07:05:15 GMT", Keep-Alive:"timeout=20", Connection:"keep-alive"]
    BookDto{id=1, name='SpringMVC系列'}

3.2、url中含有动态参数

接口代码

    @GetMapping("/test/get/{id}/{name}")
    @ResponseBody
    public BookDto get(@PathVariable("id") Integer id, @PathVariable("name") String name) {
        return new BookDto(id, name);
    }

使用RestTemplate调用上面这个接口，通常有2种写法，如下

    @Test
    public void test3() {
        RestTemplate restTemplate = new RestTemplate();
        //url中有动态参数
        String url = "http://localhost:8080/chat16/test/get/{id}/{name}";
        Map<String, String> uriVariables = new HashMap<>();
        uriVariables.put("id", "1");
        uriVariables.put("name", "SpringMVC系列");
        //使用getForObject或者getForEntity方法
        BookDto bookDto = restTemplate.getForObject(url, BookDto.class, uriVariables);
        System.out.println(bookDto);
    }
    
    @Test
    public void test4() {
        RestTemplate restTemplate = new RestTemplate();
        //url中有动态参数
        String url = "http://localhost:8080/chat16/test/get/{id}/{name}";
        Map<String, String> uriVariables = new HashMap<>();
        uriVariables.put("id", "1");
        uriVariables.put("name", "SpringMVC系列");
        //getForEntity方法
        ResponseEntity<BookDto> responseEntity = restTemplate.getForEntity(url, BookDto.class, uriVariables);
        BookDto bookDto = responseEntity.getBody();
        System.out.println(bookDto);
    }

test3输出

    BookDto{id=1, name='SpringMVC系列'}

test4输出

    BookDto{id=1, name='SpringMVC系列'}

3.3、接口返回值为泛型

接口代码

    @GetMapping("/test/getList")
    @ResponseBody
    public List<BookDto> getList() {
        return Arrays.asList(
                new BookDto(1, "Spring高手系列"),
                new BookDto(2, "SpringMVC系列")
        );
    }

当接口的返回值为泛型的时候，这种情况比较特殊，使用RestTemplate调用上面这个接口，代码如下，需要用到restTemplate.exchange的方法，这个方法中有个参数是ParameterizedTypeReference类型，通过这个参数类指定泛型类型

    @Test
    public void test5() {
        RestTemplate restTemplate = new RestTemplate();
        //返回值为泛型
        String url = "http://localhost:8080/chat16/test/getList";
        //若返回结果是泛型类型的，需要使用到exchange方法，
        //这个方法中有个参数是ParameterizedTypeReference类型，通过这个参数类指定泛型类型
        ResponseEntity<List<BookDto>> responseEntity =
                restTemplate.exchange(url,
                        HttpMethod.GET,
                        null,
                        new ParameterizedTypeReference<List<BookDto>>() {
                        });
        List<BookDto> bookDtoList = responseEntity.getBody();
        System.out.println(bookDtoList);
    }

输出

    [BookDto{id=1, name='Spring高手系列'}, BookDto{id=2, name='SpringMVC系列'}]

3.4、下载小文件

接口代码如下，这个接口会下载服务器端的1.txt文件。

    /**
     * 下载文件
     *
     * @return
     */
    @GetMapping("/test/downFile")
    @ResponseBody
    public HttpEntity<InputStreamResource> downFile() {
        //将文件流封装为InputStreamResource对象
        InputStream inputStream = this.getClass().getResourceAsStream("/1.txt");
        InputStreamResource inputStreamResource = new InputStreamResource(inputStream);
        //设置header
        MultiValueMap<String, String> headers = new HttpHeaders();
        headers.add(HttpHeaders.CONTENT_DISPOSITION, "attachment;filename=1.txt");
        HttpEntity<InputStreamResource> httpEntity = new HttpEntity<>(inputStreamResource);
        return httpEntity;
    }

使用RestTemplate调用这个接口，代码如下，目前这个文件的内容比较少，可以直接得到一个数组。

    @Test
    public void test6() {
        RestTemplate restTemplate = new RestTemplate();
        String url = "http://localhost:8080/chat16/test/downFile";
        //文件比较小的情况，直接返回字节数组
        ResponseEntity<byte[]> responseEntity = restTemplate.getForEntity(url, byte[].class);
        //获取文件的内容
        byte[] body = responseEntity.getBody();
        String content = new String(body);
        System.out.println(content);
    }

注意：如果文件大的时候，这种方式就有问题了，会导致oom，要用下面的方式了。

3.5、下载大文件

接口代码，继续使用上面下载1.txt的代码

    /**
     * 下载文件
     *
     * @return
     */
    @GetMapping("/test/downFile")
    @ResponseBody
    public HttpEntity<InputStreamResource> downFile() {
        //将文件流封装为InputStreamResource对象
        InputStream inputStream = this.getClass().getResourceAsStream("/1.txt");
        InputStreamResource inputStreamResource = new InputStreamResource(inputStream);
        //设置header
        MultiValueMap<String, String> headers = new HttpHeaders();
        headers.add(HttpHeaders.CONTENT_DISPOSITION, "attachment;filename=1.txt");
        HttpEntity<InputStreamResource> httpEntity = new HttpEntity<>(inputStreamResource);
        return httpEntity;
    }

此时使用RestTemplate调用这个接口，代码如下

文件比较大的时候，比如好几个G，就不能返回字节数组了，会把内存撑爆，导致OOM，需要使用execute方法了，这个方法中有个ResponseExtractor类型的参数，restTemplate拿到结果之后，会回调{@link ResponseExtractor#extractData}这个方法，在这个方法中可以拿到响应流，然后进行处理，这个过程就是变读边处理，不会导致内存溢出

    @Test
    public void test7() {
        RestTemplate restTemplate = new RestTemplate();
        String url = "http://localhost:8080/chat16/test/downFile";
        /**
         * 文件比较大的时候，比如好几个G，就不能返回字节数组了，会把内存撑爆，导致OOM
         * 需要这么玩：
         * 需要使用execute方法了，这个方法中有个ResponseExtractor类型的参数，
         * restTemplate拿到结果之后，会回调{@link ResponseExtractor#extractData}这个方法，
         * 在这个方法中可以拿到响应流，然后进行处理，这个过程就是变读边处理，不会导致内存溢出
         */
        String result = restTemplate.execute(url,
                HttpMethod.GET,
                null,
                new ResponseExtractor<String>() {
                    @Override
                    public String extractData(ClientHttpResponse response) throws IOException {
                        System.out.println("状态："+response.getStatusCode());
                        System.out.println("头："+response.getHeaders());
                        //获取响应体流
                        InputStream body = response.getBody();
                        //处理响应体流
                        String content = IOUtils.toString(body, "UTF-8");
                        return content;
                    }
                }, new HashMap<>());
    
        System.out.println(result);
    }

3.6、传递头

接口代码

    @GetMapping("/test/header")
    @ResponseBody
    public Map<String, List<String>> header(HttpServletRequest request) {
        Map<String, List<String>> header = new LinkedHashMap<>();
        Enumeration<String> headerNames = request.getHeaderNames();
        while (headerNames.hasMoreElements()) {
            String name = headerNames.nextElement();
            Enumeration<String> values = request.getHeaders(name);
            List<String> list = new ArrayList<>();
            while (values.hasMoreElements()) {
                list.add(values.nextElement());
            }
            header.put(name, list);
        }
        return header;
    }

使用RestTemplate调用接口，请求头中传递数据，代码如下，注意代码①和②，这两处是关键，用到了HttpHeaders和RequestEntity

请求头放在HttpHeaders对象中

RequestEntity：请求实体，请求的所有信息都可以放在RequestEntity中，比如body部分、头、请求方式、url等信息

    @Test
    public void test8() {
        RestTemplate restTemplate = new RestTemplate();
        String url = "http://localhost:8080/chat16/test/header";
        //①：请求头放在HttpHeaders对象中
        MultiValueMap<String, String> headers = new HttpHeaders();
        headers.add("header-1", "V1");
        headers.add("header-2", "Spring");
        headers.add("header-2", "SpringBoot");
        //②：RequestEntity：请求实体，请求的所有信息都可以放在RequestEntity中，比如body部分、头、请求方式、url等信息
        RequestEntity requestEntity = new RequestEntity(
                null, //body部分数据
                headers, //头
                HttpMethod.GET,//请求方法
                URI.create(url) //地址
        );
        ResponseEntity<Map<String, List<String>>> responseEntity = restTemplate.exchange(requestEntity,
                new ParameterizedTypeReference<Map<String, List<String>>>() {
                });
        Map<String, List<String>> result = responseEntity.getBody();
        System.out.println(result);
    }

输出

    {accept=[application/json, application/*+json], header-1=[V1], header-2=[Spring, SpringBoot], user-agent=[Java/1.8.0_121], host=[localhost:8080], connection=[keep-alive]}

3.7、综合案例：含头、url动态参数

接口

    @GetMapping("/test/getAll/{path1}/{path2}")
    @ResponseBody
    public Map<String, Object> getAll(@PathVariable("path1") String path1,
                                      @PathVariable("path2") String path2,
                                      HttpServletRequest request) {
        Map<String, Object> result = new LinkedHashMap<>();
        result.put("path1", path1);
        result.put("path2", path2);
        //头
        Map<String, List<String>> header = new LinkedHashMap<>();
        Enumeration<String> headerNames = request.getHeaderNames();
        while (headerNames.hasMoreElements()) {
            String name = headerNames.nextElement();
            Enumeration<String> values = request.getHeaders(name);
            List<String> list = new ArrayList<>();
            while (values.hasMoreElements()) {
                list.add(values.nextElement());
            }
            header.put(name, list);
        }
        result.put("header", header);
        return result;
    }

如下，使用RestTemplate调用接口，GET方式、传递header、path中动态参数。

    @Test
    public void test9() {
        RestTemplate restTemplate = new RestTemplate();
        String url = "http://localhost:8080/chat16/test/getAll/{path1}/{path2}";
        //①：请求头
        MultiValueMap<String, String> headers = new HttpHeaders();
        headers.add("header-1", "V1");
        headers.add("header-2", "Spring");
        headers.add("header-2", "SpringBoot");
        //②：url中的2个参数
        Map<String, String> uriVariables = new HashMap<>();
        uriVariables.put("path1", "v1");
        uriVariables.put("path2", "v2");
        //③：HttpEntity：HTTP实体，内部包含了请求头和请求体
        HttpEntity requestEntity = new HttpEntity(
            null,//body部分，get请求没有body，所以为null
            headers //头
        );
        //④：使用exchange发送请求
        ResponseEntity<Map<String, Object>> responseEntity = restTemplate.exchange(
            url, //url
            HttpMethod.GET, //请求方式
            requestEntity, //请求实体（头、body）
            new ParameterizedTypeReference<Map<String, Object>>() {
            },//返回的结果类型
            uriVariables //url中的占位符对应的值
        );
        Map<String, Object> result = responseEntity.getBody();
        System.out.println(result);
    }

输出

    {path1=v1, path2=v2, header={accept=[application/json, application/*+json], header-1=[V1], header-2=[Spring, SpringBoot], user-agent=[Java/1.8.0_121], host=[localhost:8080], connection=[keep-alive]}}

4、POST请求

4.1、post请求常见的3种类型

http请求头中的Content-Type用来指定请求的类型，常见的有3种

Content-Type	说明
application/x-www-form-urlencoded	页面中普通的form表单提交时就是这种类型，表单中的元素会按照名称和值拼接好，然后之间用&连接，格式如：p1=v1&p2=v2&p3=v3然后通过urlencoded编码之后丢在body中发送
multipart/form-data	页面中表单上传文件的时候，用到的就是这种格式
application/json	将发送的数据转换为json格式，丢在http请求的body中发送，后端接口通常用@RequestBody配合对象来接收。

下面看则种方式的案例。

4.2、普通表单请求

普通表单默认为application/x-www-form-urlencoded类型的请求。

接口代码

    @PostMapping("/test/form1")
    @ResponseBody
    public BookDto form1(BookDto bookDto) {
        return bookDto;
    }

使用RestTemplate调用接口

    @Test
    public void test10() {
        RestTemplate restTemplate = new RestTemplate();
        String url = "http://localhost:8080/chat16/test/form1";
        //①：表单信息，需要放在MultiValueMap中，MultiValueMap相当于Map<String,List<String>>
        MultiValueMap<String, String> body = new LinkedMultiValueMap<>();
        //调用add方法填充表单数据(表单名称:值)
        body.add("id","1");
        body.add("name","SpringMVC系列");
        //②：发送请求(url,请求体，返回值需要转换的类型)
        BookDto result = restTemplate.postForObject(url, body, BookDto.class);
        System.out.println(result);
    }

如果想携带头信息，代码如下

    @Test
    public void test11() {
        RestTemplate restTemplate = new RestTemplate();
        String url = "http://localhost:8080/chat16/test/form1";
        //①：表单信息，需要放在MultiValueMap中，MultiValueMap相当于Map<String,List<String>>
        MultiValueMap<String, String> body = new LinkedMultiValueMap<>();
        //调用add方法放入表单元素(表单名称:值)
        body.add("id","1");
        body.add("name","SpringMVC系列");
        //②：请求头
        HttpHeaders headers = new HttpHeaders();
        //调用set方法放入请求头
        headers.set(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_FORM_URLENCODED_VALUE);
        //③：请求实体：包含了请求体和请求头
        HttpEntity<MultiValueMap<String, String>> httpEntity = new HttpEntity<>(body, headers);
        //④：发送请求(url,请求实体，返回值需要转换的类型)
        BookDto result = restTemplate.postForObject(url, httpEntity, BookDto.class);
        System.out.println(result);
    }

4.3、上传本地文件

上传文件Content-Type为multipart/form-data 类型。

接口如下，上传上传单个文件，返回值为一个Map类型，是泛型类型

    @PostMapping(value = "/test/form2")
    @ResponseBody
    public Map<String, String> form2(@RequestParam("file1") MultipartFile file1) {
        Map<String, String> fileMetadata = new LinkedHashMap<>();
        fileMetadata.put("文件名", file1.getOriginalFilename());
        fileMetadata.put("文件类型", file1.getContentType());
        fileMetadata.put("文件大小(byte)", String.valueOf(file1.getSize()));
        return fileMetadata;
    }

使用RestTemplate调用接口，主要下面代码②上传的文件需要包装为org.springframework.core.io.Resource，常用的有3中[FileSystemResource、InputStreamResource、ByteArrayResource]，这里案例中我们用到的是FileSystemResource来上传本地文件，另外2种（InputStreamResource、ByteArrayResource）用法就比较特殊了，见下个案例。

    @Test
    public void test12() {
        RestTemplate restTemplate = new RestTemplate();
        String url = "http://localhost:8080/chat16/test/form2";
        //①：表单信息，需要放在MultiValueMap中，MultiValueMap相当于Map<String,List<String>>
        MultiValueMap<String, Object> body = new LinkedMultiValueMap<>();
        //调用add方法放入表单元素(表单名称:值)
        //②：文件对应的类型，需要是org.springframework.core.io.Resource类型的，常见的有[FileSystemResource、InputStreamResource、ByteArrayResource]
        body.add("file1", new FileSystemResource(".\\src\\main\\java\\com\\javacode2018\\springmvc\\chat16\\dto\\UserDto.java"));
        //③：头
        HttpHeaders headers = new HttpHeaders();
        headers.add("header1", "v1");
        headers.add("header2", "v2");
        //④：请求实体
        RequestEntity<MultiValueMap<String, Object>> requestEntity = new RequestEntity<>(body, headers, HttpMethod.POST, URI.create(url));
        //⑤：发送请求(请求实体，返回值需要转换的类型)
        ResponseEntity<Map<String, String>> responseEntity = restTemplate.exchange(
            requestEntity,
            new ParameterizedTypeReference<Map<String, String>>() {
            });
        Map<String, String> result = responseEntity.getBody();
        System.out.println(result);
    }

4.4、通过流或字节数组的方式上传文件

有时候，上传的文件是通过流的方式或者字节数组的方式，那么就需要用到InputStreamResource、ByteArrayResource这俩了。

**注意：**使用这俩的时候，需要重写2个方法，否则会上传失败

getFilename：文件名称

contentLength：长度

    @Test
    public void test13() {
        RestTemplate restTemplate = new RestTemplate();
        String url = "http://localhost:8080/chat16/test/form2";
        //①：表单信息，需要放在MultiValueMap中，MultiValueMap相当于Map<String,List<String>>
        MultiValueMap<String, Object> body = new LinkedMultiValueMap<>();
        /**
         * ②：通过流的方式上传文件，流的方式需要用到InputStreamResource类，需要重写2个方法
         * getFilename：文件名称
         * contentLength：长度
         */
        InputStream inputStream = RestTemplateTest.class.getResourceAsStream("/1.txt");
        InputStreamResource inputStreamResource = new InputStreamResource(inputStream) {
            @Override
            public String getFilename() {
                return "1.txt";
            }
    
            @Override
            public long contentLength() throws IOException {
                return inputStream.available();
            }
        };
        body.add("file1", inputStreamResource);
        //③：头
        HttpHeaders headers = new HttpHeaders();
        headers.add("header1", "v1");
        headers.add("header2", "v2");
        //④：请求实体
        RequestEntity<MultiValueMap<String, Object>> requestEntity = new RequestEntity<>(body, headers, HttpMethod.POST, URI.create(url));
        //⑤：发送请求(请求实体，返回值需要转换的类型)
        ResponseEntity<Map<String, String>> responseEntity = restTemplate.exchange(
                requestEntity,
                new ParameterizedTypeReference<Map<String, String>>() {
                });
        Map<String, String> result = responseEntity.getBody();
        System.out.println(result);
    }

4.5、复杂表单：多个普通元素+多文件上传

接口

    /**
     * 复杂的表单：包含了普通元素、多文件
     *
     * @param userDto
     * @return
     */
    @PostMapping("/test/form3")
    @ResponseBody
    public Map<String, String> form3(UserDto userDto) {
        Map<String, String> result = new LinkedHashMap<>();
        result.put("name", userDto.getName());
        result.put("headImg", userDto.getHeadImg().getOriginalFilename());
        result.put("idImgList", Arrays.toString(userDto.getIdImgList().stream().
                                                map(MultipartFile::getOriginalFilename).toArray()));
        return result;
    }

UserDto：包含了多个元素（姓名、头像、多张证件照），这种可以模拟复杂的表单

    public class UserDto {
        //姓名
        private String name;
        //头像
        private MultipartFile headImg;
        //多张证件照
        private List<MultipartFile> idImgList;
    
        //get set 省略了...
    }

用RestTemplate调用这个接口，代码如下

    @Test
    public void test14() {
        RestTemplate restTemplate = new RestTemplate();
        String url = "http://localhost:8080/chat16/test/form3";
        //①：表单信息，需要放在MultiValueMap中，MultiValueMap相当于Map<String,List<String>>
        MultiValueMap<String, Object> body = new LinkedMultiValueMap<>();
        body.add("name", "路人");
        body.add("headImg", new FileSystemResource(".\\src\\main\\resources\\1.jpg"));
        //来2张证件照，元素名称一样
        body.add("idImgList", new FileSystemResource(".\\src\\main\\resources\\2.jpg"));
        body.add("idImgList", new FileSystemResource(".\\src\\main\\resources\\3.jpg"));
        //③：头
        HttpHeaders headers = new HttpHeaders();
        headers.add("header1", "v1");
        headers.add("header2", "v2");
        //④：请求实体
        RequestEntity<MultiValueMap<String, Object>> requestEntity = new RequestEntity<>(body, headers, HttpMethod.POST, URI.create(url));
        //⑤：发送请求(请求实体，返回值需要转换的类型)
        ResponseEntity<Map<String, String>> responseEntity = restTemplate.exchange(
                requestEntity,
                new ParameterizedTypeReference<Map<String, String>>() {
                });
        Map<String, String> result = responseEntity.getBody();
        System.out.println(result);
    }

输出

    {name=路人, headImg=1.jpg, idImgList=[2.jpg, 3.jpg]}

4.6、发送json格式数据：传递java对象

接口

    /**
     * body中json格式的数据，返回值非泛型
     *
     * @param bookDto
     * @return
     */
    @PostMapping("/test/form4")
    @ResponseBody
    public BookDto form4(@RequestBody BookDto bookDto) {
        return bookDto;
    }

RestTemplate调用接口

    @Test
    public void test15() {
        RestTemplate restTemplate = new RestTemplate();
        String url = "http://localhost:8080/chat16/test/form4";
        BookDto body = new BookDto(1, "SpringMVC系列");
        BookDto result = restTemplate.postForObject(url, body, BookDto.class);
        System.out.println(result);
    }

输出

    BookDto{id=1, name='SpringMVC系列'}

4.7、发送json格式数据：传递java对象，返回值为泛型

接口

    /**
     * body中json格式的数据，返回值为泛型
     *
     * @param bookDtoList
     * @return
     */
    @PostMapping("/test/form5")
    @ResponseBody
    public List<BookDto> form5(@RequestBody List<BookDto> bookDtoList) {
        return bookDtoList;
    }

用RestTemplate调用这个接口，代码如下

    @Test
    public void test16() {
        RestTemplate restTemplate = new RestTemplate();
        String url = "http://localhost:8080/chat16/test/form5";
        //①：请求体，发送的时候会被转换为json格式数据
        List<BookDto> body = Arrays.asList(
                new BookDto(1, "SpringMVC系列"),
                new BookDto(2, "MySQL系列"));
        //②：头
        HttpHeaders headers = new HttpHeaders();
        headers.add("header1", "v1");
        headers.add("header2", "v2");
        //③：请求实体
        RequestEntity requestEntity = new RequestEntity(body, headers, HttpMethod.POST, URI.create(url));
        //④：发送请求(请求实体，返回值需要转换的类型)
        ResponseEntity<List<BookDto>> responseEntity = restTemplate.exchange(
                requestEntity,
                new ParameterizedTypeReference<List<BookDto>>() {
                });
        //⑤：获取结果
        List<BookDto> result = responseEntity.getBody();
        System.out.println(result);
    }

输出

    [BookDto{id=1, name='SpringMVC系列'}, BookDto{id=2, name='MySQL系列'}]

4.8、发送json字符串格式数据

上面2个json案例body都是java对象，RestTemplate默认自动配上Content-Type=application/json

但是如果body的值是json格式字符串的时候，调用的时候需要在头中明确指定Content-Type=application/json，写法如下：

    @Test
    public void test17() {
        RestTemplate restTemplate = new RestTemplate();
        String url = "http://localhost:8080/chat16/test/form5";
        //①：请求体为一个json格式的字符串
        String body = "[{\"id\":1,\"name\":\"SpringMVC系列\"},{\"id\":2,\"name\":\"MySQL系列\"}]";
        /**
         * ②：若请求体为json字符串的时候，需要在头中设置Content-Type=application/json；
         * 若body是普通的java类的时候，无需指定这个，RestTemplate默认自动配上Content-Type=application/json
         */
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);
        //③：请求实体（body，头、请求方式，uri）
        RequestEntity requestEntity = new RequestEntity(body, headers, HttpMethod.POST, URI.create(url));
        //④：发送请求(请求实体，返回值需要转换的类型)
        ResponseEntity<List<BookDto>> responseEntity = restTemplate.exchange(
                requestEntity,
                new ParameterizedTypeReference<List<BookDto>>() {
                });
        //⑤：获取结果
        List<BookDto> result = responseEntity.getBody();
        System.out.println(result);
    }

输出

    [BookDto{id=1, name='SpringMVC系列'}, BookDto{id=2, name='MySQL系列'}]

5、DELETE、PUT、OPTION请求

5.1、DELETE请求

    public void delete(String url, Object... uriVariables);
    public void delete(String url, Map<String, ?> uriVariables);
    public void delete(URI url);

5.2、PUT请求

PUT请求和POST请求类似，将类型改为PUT就可以了。

5.3、OPTIONS请求

OPTIONS请求用来探测接口支持哪些http方法

    public Set<HttpMethod> optionsForAllow(String url, Object... uriVariables);
    public Set<HttpMethod> optionsForAllow(String url, Map<String, ?> uriVariables);
    public Set<HttpMethod> optionsForAllow(URI url);

6、集成HttpClient

RestTemplate内部默认用的是jdk自带的HttpURLConnection发送请求的，性能上面并不是太突出。

可以将其替换为httpclient或者okhttp。

先来看下如何替换为HttpClient。

引入maven配置

    <dependency>
        <groupId>org.apache.httpcomponents</groupId>
        <artifactId>httpclient</artifactId>
        <version>4.5.7</version>
    </dependency>

创建RestTemplate时指定HttpClient配置，代码如下

    public HttpClient httpClient() {
        HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();
        try {
            //设置信任ssl访问
            SSLContext sslContext = new SSLContextBuilder().loadTrustMaterial(null, (arg0, arg1) -> true).build();
            httpClientBuilder.setSSLContext(sslContext);
            HostnameVerifier hostnameVerifier = NoopHostnameVerifier.INSTANCE;
            SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, hostnameVerifier);
            Registry<ConnectionSocketFactory> socketFactoryRegistry = RegistryBuilder.<ConnectionSocketFactory>create()
                    // 注册http和https请求
                    .register("http", PlainConnectionSocketFactory.getSocketFactory())
                    .register("https", sslConnectionSocketFactory).build();
    
            //使用Httpclient连接池的方式配置(推荐)，同时支持netty，okHttp以及其他http框架
            PoolingHttpClientConnectionManager poolingHttpClientConnectionManager = new PoolingHttpClientConnectionManager(socketFactoryRegistry);
            // 最大连接数
            poolingHttpClientConnectionManager.setMaxTotal(1000);
            // 同路由并发数
            poolingHttpClientConnectionManager.setDefaultMaxPerRoute(100);
            //配置连接池
            httpClientBuilder.setConnectionManager(poolingHttpClientConnectionManager);
            // 重试次数
            httpClientBuilder.setRetryHandler(new DefaultHttpRequestRetryHandler(0, true));
            //设置默认请求头
            List<Header> headers = new ArrayList<>();
            httpClientBuilder.setDefaultHeaders(headers);
            return httpClientBuilder.build();
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }
    
    public ClientHttpRequestFactory clientHttpRequestFactory() {
        HttpComponentsClientHttpRequestFactory clientHttpRequestFactory = new HttpComponentsClientHttpRequestFactory(httpClient());
        // 连接超时(毫秒)，这里设置10秒
        clientHttpRequestFactory.setConnectTimeout(10 * 1000);
        // 数据读取超时时间(毫秒)，这里设置60秒
        clientHttpRequestFactory.setReadTimeout(60 * 1000);
        // 从连接池获取请求连接的超时时间(毫秒)，不宜过长，必须设置，比如连接不够用时，时间过长将是灾难性的
        clientHttpRequestFactory.setConnectionRequestTimeout(10 * 1000);
        return clientHttpRequestFactory;
    }
    
    public RestTemplate restTemplate(){
        //创建RestTemplate的时候，指定ClientHttpRequestFactory
        return new RestTemplate(this.clientHttpRequestFactory());
    }
    
    @Test
    public void test18() {
        RestTemplate restTemplate = this.restTemplate();
        String url = "http://localhost:8080/chat16/test/get";
        //getForObject方法，获取响应体，将其转换为第二个参数指定的类型
        BookDto bookDto = restTemplate.getForObject(url, BookDto.class);
        System.out.println(bookDto);
    }

7、集成okhttp

引入maven配置

    <dependency>
        <groupId>com.squareup.okhttp3</groupId>
        <artifactId>okhttp</artifactId>
        <version>4.3.1</version>
    </dependency>

创建RestTemplate

    new RestTemplate(new OkHttp3ClientHttpRequestFactory());

8、总结

RestTemplate使用确实非常容易，建议大家去看一下RestTemplate的源码，debug跟踪一下过程，这样用起来就非常顺手了。

《尚硅谷Java学科全套教程（总207.77GB）》

Java 面试宝典是大明哥全力打造的 Java 精品面试题，它是一份靠谱、强大、详细、经典的 Java 后端面试宝典。它不仅仅只是一道道面试题，而是一套完整的 Java 知识体系，一套你 Java 知识点的扫盲贴。

它的内容包括：

大厂真题：Java 面试宝典里面的题目都是最近几年的高频的大厂面试真题。
原创内容：Java 面试宝典内容全部都是大明哥原创，内容全面且通俗易懂，回答部分可以直接作为面试回答内容。
持续更新：一次购买，永久有效。大明哥会持续更新 3+ 年，累计更新 1000+，宝典会不断迭代更新，保证最新、最全面。
覆盖全面：本宝典累计更新 1000+，从 Java 入门到 Java 架构的高频面试题，实现 360° 全覆盖。
不止面试：内容包含面试题解析、内容详解、知识扩展，它不仅仅只是一份面试题，更是一套完整的 Java 知识体系。
宝典详情：https://www.yuque.com/chenssy/sike-java/xvlo920axlp7sf4k
宝典总览：https://www.yuque.com/chenssy/sike-java/yogsehzntzgp4ly1
宝典进展：https://www.yuque.com/chenssy/sike-java/en9ned7loo47z5aw

目前 Java 面试宝典累计更新 400+ 道，总字数 42w+。大明哥还在持续更新中，下图是大明哥在 2024-12 月份的更新情况：

想了解详情的小伙伴，扫描下面二维码加大明哥微信【daming091】咨询

同时，大明哥也整理一套目前市面最常见的热点面试题。微信搜[大明哥聊 Java]或扫描下方二维码关注大明哥的原创公众号[大明哥聊 Java] ，回复【面试题】即可免费领取。

阅读全文

Spring MVC 详细教程

Spring MVC 教程-接口调用利器RestTemplate

目录

1、RestTemplate概述

2、案例代码

2.1、git地址

2.2、关键代码位置

2.3、如何运行测试用例？

3、发送Get请求

3.1、普通请求

3.2、url中含有动态参数

3.3、接口返回值为泛型

3.4、下载小文件

3.5、下载大文件

3.6、传递头

3.7、综合案例：含头、url动态参数

4、POST请求

4.1、post请求常见的3种类型

4.2、普通表单请求

4.3、上传本地文件

4.4、通过流或字节数组的方式上传文件

4.5、复杂表单：多个普通元素+多文件上传

4.6、发送json格式数据：传递java对象

4.7、发送json格式数据：传递java对象，返回值为泛型

4.8、发送json字符串格式数据

5、DELETE、PUT、OPTION请求

5.1、DELETE请求

5.2、PUT请求

5.3、OPTIONS请求

6、集成HttpClient

7、集成okhttp

8、总结