文件上传（v1.8.7）

  • SDK 

    1. /**
    2. * 上传文件，读取本地文件
    3. *
    4. * @throws IOException
    5. */
    6. @Test
    7. public void testUpload() throws IOException {
    8.   GoodsParam param = new GoodsParam();
    9.   param.setGoods_name("iphone6");
    10.   GoodsReq req = new GoodsReq("file.upload", param);
    12.   String path = this.getClass().getResource("").getPath();
    14.   List<UploadFile> files = new ArrayList<>();
    16.   // 这里的headImg，idcardImg要跟服务端参数名对应
    17.   files.add(new UploadFile("headImg", new File(path + "1.txt")));
    18.   files.add(new UploadFile("idcardImg", new File(path + "2.txt")));
    20.   GoodsResp result = client.requestFile(req, files);
    22.   System.out.println("--------------------");
    23.   if (result.isSuccess()) {
    24.       System.out.println(result.getData());
    25.   } else {
    26.       System.out.println("errorMsg:" + result.getMsg());
    27.   }
    28.   System.out.println("--------------------");
    29. }

  • 服务端处理 

    1. @Api(name = "file.upload")
    2.   @ApiDocMethod(description = "文件上传")
    3.   Object upload(UploadParam param) throws IllegalStateException, IOException {
    4.       // 获取上传文件
    5.       MultipartFile headImgFile = param.getHeadImg();
    6.       MultipartFile idcardImgFile = param.getIdcardImg();
    8.       StringBuilder sb = new StringBuilder();
    9.       sb.append("表单名：").append(headImgFile.getName()).append(",")
    10.       .append("文件大小：").append(headImgFile.getSize()).append(";");
    12.       sb.append("表单名：").append(idcardImgFile.getName()).append(",")
    13.       .append("文件大小：").append(idcardImgFile.getSize()).append(";");
    15.       // headImgFile.getInputStream(); // 返回文件流
    16.       // headImgFile.getBytes(); // 返回文件数据流
    18.       headImgFile.transferTo(new File("D:/new_" + headImgFile.getOriginalFilename()));
    19.       idcardImgFile.transferTo(new File("D:/new_" + idcardImgFile.getOriginalFilename()));
    21.       return new ApiResult(sb.toString());
    22.   }

  • UploadParam.java

    1. public class UploadParam {
    2.   @ApiDocField(description = "商品名称", required = true, example = "iphoneX")
        @NotEmpty(message = "商品名称不能为空")
        @Length(min = 3, max = 20, message = "{goods.name.length}=3,20")
        private String goods_name;
    3.   // 这里定义上传的文件，属性名称对应客户端上传的name
        @ApiDocField(description = "头像图片", required = true, dataType = DataType.FILE)
        @NotNull(message = "请上传头像图片")
        private MultipartFile headImg;
    4.   @ApiDocField(description = "身份证图片", required = true, dataType = DataType.FILE)
        @NotNull(message = "请上传身份证图片")
        private MultipartFile idcardImg;
    5.   //getter,setter
      }

    headImg,idcardImg就是上传的表单名，客户端需要于此对应。

上传内存文件

有些文件不是从本地读取的，而是从其它地方下载到内存中，比如从阿里云下载文件到内存中，不落地。

  1. List<UploadFile> files = new ArrayList<>();
  3. files.add(new UploadFile("headImg","headImg.txt", this.getClass().getResourceAsStream("1.txt")));
  4. files.add(new UploadFile("idcardImg", "idcardImg.txt", this.getClass().getResourceAsStream("2.txt")));
  6. GoodsResp result = client.requestFile(req, files);

或者

  1. List<UploadFile> files = new ArrayList<>();
  3. files.add(new UploadFile("headImg","headImg.txt", byte[]));
  4. files.add(new UploadFile("idcardImg", "idcardImg.txt", byte[]));
  6. GoodsResp result = client.requestFile(req, files);

主要通过UploadFile类的构造方法来区分

  1. /**
  2.  * @param name 表单名称，不能重复
  3.  * @param file 文件
  4.  * @throws IOException
  5.  */
  6. public UploadFile(String name, File file)
  8. /**
  9.  * @param name 表单名称，不能重复
  10.  * @param fileName 文件名
  11.  * @param input 文件流
  12.  * @throws IOException
  13.  */
  14. public UploadFile(String name, String fileName, InputStream input)
  16. /**
  17.  * @param name 表单名称，不能重复
  18.  * @param fileName 文件名
  19.  * @param fileData 文件数据
  20.  */
  21. public UploadFile(String name, String fileName, byte[] fileData)