项目过程中,经常会有和第三方接口打交道的过程,今天实现调用第三方上传文件的接口!!
个人小习惯与君分享:
通常拿到第三方的接口文档的时候,不是第一时间先写代码,而是详细阅读接口文档。若接口需要第三方提供的基本参数,例如signkey,secrect等,也可以是其他的,查看文档里是否提供。再用工具(postman、swagger)构建接口请求参数进行接口测试,测试成功后, 再开始写代码!!!
1.第三方上传文件接口说明
请求方式:post
请求参数:
请求参数格式:
{
"file": ""(文件),
"file": ""(如需要可进行多文件上传)
}
返回参数:
{
"fileFlag": "1", //fileFlag: "0"代表失败;”1“代表成功
"attachmentId": [
"B3340EC8-2559-4459"
],
"message": "上传成功"
}
2.java实现第三方文件上传,支持多文件
文件上传,参数用MultipartFile类型接受
单文件 :MultipartFile file
多文件 :MultipartFile[] file
- 编写contoller层接口
接口是post请求方式,参数用MultipartFile类型接受
@ApiOperation(value = "多文件上传")
@PostMapping("/upload/file")
public RtnResult<Object> uploadAttatchmentFile(MultipartFile[] file) {
return mailService.uploadAttatchmentFile(file);
}
- 编写service成方法
逻辑:
a.先构建请求URL
b. 按第三方接口文档处理多文件上传请求参数,构建HttpHeaders,HttpEntity
c.使用RestTemplate请求第三方接口
d.处理返回结果
public RtnResult<Object> uploadAttatchmentFile(MultipartFile[] files) {
String url = urlPrefix + UPLOAD_ATTACHMENT_FILE_URL;
MultiValueMap<String, Object> param = new LinkedMultiValueMap<>();
for (MultipartFile file : files) {
param.add("file", file.getResource());
}
RestTemplate request = new RestTemplate();
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.MULTIPART_FORM_DATA);
HttpEntity<MultiValueMap<String, Object>> requestEntity = new HttpEntity<>(param, headers);
ResponseEntity<Map> response = request.postForEntity(url, requestEntity, Map.class);
if (response.getStatusCode() != HttpStatus.OK) {
return (RtnResult.errorCodeMsg.SERVER_ERROR);
}
Map result = response.getBody();
return RtnResult.success(result);
}
- postMan接口测试
接口写好,用postman进行接口测试,测试接口是否能上传多文件
通过上述操作、测试,成功调用第三方上传文件接口!!!👍👍👍