本文是精讲响应式WebClient第4篇，前篇的blog访问地址如下：

• 精讲响应式webclient第1篇-响应式非阻塞IO与基础用法
• 精讲响应式WebClient第2篇-GET请求阻塞与非阻塞调用方法详解
• 精讲响应式WebClient第3篇-POST、DELETE、PUT方法使用

WebClient是从Spring 5开始提供的一个HTTP客户端库，为了使用WebClient进行文件上传和下载，需要我们先编写服务端的支持文件上传和下载的程序。请参考我之前写的一篇文章：SpringBoot实现本地存储文件上传及提供HTTP访问服务。按照此文完成学习之后，可以获得

• 一个以访问服务URI为"/upload”的文件上传服务端点
• 服务端点上传文件成功后会返回一个HTTP连接,可以用来下载文件。

下面我们就开始学习使用WebClient是HTTP客户端库，进行文件的上传与下载。

一、文件上传

在本地8888端口搭建了一个文件上传接收的服务端，服务端点为“/upload”。上传本地磁盘中的一个文件"D:\data\local\splash.png"

@SpringBootTest
class UpDownLoadTests {

   //创建webClient
   private WebClient webClient = WebClient.builder()
               .baseUrl("http://localhost:8888/")
               .build();

   @Test
   void testUpload()  {
      // 待上传的文件（存在客户端本地磁盘）
      String filePath = "D:\\data\\local\\splash.png";
      // 封装请求参数
      FileSystemResource resource = new FileSystemResource(new File(filePath));
      MultiValueMap<String, Object> param = new LinkedMultiValueMap<>();
      param.add("uploadFile", resource);  //服务端MultipartFile uploadFile
      //param.add("param1", "test");   //服务端如果接受额外参数，可以传递

      // 发送请求
      Mono<String> mono = webClient
                  .post() // POST 请求
                  .uri("/upload")  // 请求路径
                  .contentType(MediaType.APPLICATION_FORM_URLENCODED)
                  .body(BodyInserters.fromMultipartData(param))
                  .retrieve() // 获取响应体
                  .bodyToMono(String.class); //响应数据类型转换

      // 输出结果
      System.out.println(mono.block());
   }
}

输出打印结果如下：

文章上传之后返回一个HTTP URL访问地址，可以通过浏览器访问，也可以通过程序下载。

二、文件下载

执行下列代码之后，被下载文件url，会被正确的保存到本地磁盘目录

@Test
void testDownLoad() throws IOException {
   Mono<ClientResponse> mono = webClient
               .get() // GET 请求
               .uri("/2020/08/22/0f0a353a-7033-4a13-832e-d043f6360514.png")  // 请求路径
               .accept(MediaType.APPLICATION_OCTET_STREAM)
               .exchange(); // 获取响应体

   ClientResponse response = mono.block();
   Resource resource = response.bodyToMono(Resource.class).block();

   assert resource != null;
   Files.copy(resource.getInputStream(),
            Paths.get("D:\\data\\local\\splash-down.png" ));

}