原文链接：使用Feign接口实现文件上传的解决方案
一般的情况下，后端有个微服务，暴露出一个文件上传的restful接口给前端，前端调用该接口获取上传后的链接以及oss key值完成上传。假设提供restful接口的这个服务叫做A，现在有个微服务B有个本地文件，需要将本地文件调用A文件文件上传接口上传到文件服务器，该如何做？
一般情况下，一个文件上传的restful接口如下所示：
@PostMapping("/upload")
public WrapperResult<UploadResult> uploadFile(@RequestParam("file") MultipartFile multipartFile){
......
}
那对应的Feign接口就如下所示
@PostMapping("/upload")
public WrapperResult<UploadResult> uploadFile(@RequestParam("file") MultipartFile multipartFile);
从直觉上来看，直接调用八成会出问题（笑），通过踩坑，我梳理了下后端调用Feign接口实现文件上传的改造点
1. 接口修改
一般的文件上传接口定义：
@PostMapping("/upload")
public WrapperResult<UploadResult> uploadFile(@RequestParam("file") MultipartFile multipartFile){
......
}
在Feign接口暴露出来的情况下，则不能再使用@RequestParam注解，应当使用@RequestPart注解，另外需要指定consumes类型为表单类型，否则会翻车。
修改后的接口如下
@PostMapping(
value = {
"/upload"},
consumes = {
"multipart/form-data"}
)
UploadResult uploadFile(@RequestPart("file") @NotNull MultipartFile multipartFile);
这里注意两点：
- 使用@RequestPart注解替换掉@RequestParam注解
- 指定consumes类型为表单类型
2. Encoder修改
在springboot中，一般的Encoder定义如下
@Bean
@Primary
public Encoder feignEncoder() {
HttpMessageConverter jacksonConverter = new MappingJackson2HttpMessageConverter(
JsonUtils.getObjectMapper()
);
ObjectFactory<HttpMessageConverters> objectFactory =
() -> new HttpMessageConverters(jacksonConverter);
return new SpringEncoder(objectFactory);
}
返回了一个SpringEncoder对象，这里需要返回一个SpringFormEncoder对象以支持Feign接口的表单功能，只需要将new SpringEncoder(objectFactory)修改为new SpringFormEncoder(new SpringEncoder(objectFactory))即可，修改后的代码如下
@Bean
@Primary
public Encoder feignEncoder() {
HttpMessageConverter jacksonConverter = new MappingJackson2HttpMessageConverter(
JsonUtils.getObjectMapper()
);
ObjectFactory<HttpMessageConverters> objectFactory =
() -> new HttpMessageConverters(jacksonConverter);
return new SpringFormEncoder(new SpringEncoder(objectFactory));
}
3. 客户端调用修改
现在Feign接口长这个样子
@PostMapping(
value = {
"/upload"},
consumes = {
"multipart/form-data"}
)
UploadResult uploadFile(@RequestPart("file") @NotNull MultipartFile multipartFile);
那我们Feign接口调用的时候就得构造MultipartFile对象，这里需要引入spring-test的依赖
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
</dependency>
然后代码这么写
FileInputStream fis = null;
try {
Tika tika = new Tika();
String mimeType = tika.detect(file);
fis = new FileInputStream(file);
MockMultipartFile mockMultipartFile = new MockMultipartFile(
"file",
file.getName(),
mimeType,
fis
);
UploadResult uploadResult = ossPublicApi.uploadFile(mockMultipartFile);
}catch(Exception e){
......
}
这里为了告知正确的媒体类型，引入了tika，关于tika，参考文章 使用tika获取文件的实际类型 引入
需要注意以下几点
- 需要引入spring-test，注意scope默认就行，不能为provided
- 需要引入tika，告知正确的媒体类型，否则上传到minio等文件服务器，在浏览器中打开图片、mp4视频等文件本来应当在浏览器打开的文件会变成自动下载
END.
