使用Spring Cloud Feign上传文件

原文：http://http://www.itmuch.com/spring-cloud-sum/spring-cloud-feign-upload/

采用 CC BY 3.0 CN 许可协议。可自由转载、引用，但需署名作者且注明文章出处。如转载至微信公众号，请在文末添加作者公众号二维码。

最近经常有人问Spring Cloud Feign如何上传文件。有团队的新成员，也有其他公司的兄弟。本文简单做个总结——

早期的Spring Cloud中，Feign本身是没有上传文件的能力的（1年之前），要想实现这一点，需要自己去编写

Encoder

去实现上传。现在我们幸福了很多。因为Feign官方提供了子项目feign-form ，其中实现了上传所需的

Encoder

。

注：笔者测试的版本是Edgware.RELEASE。Camden、Dalston同样适应本文所述。

加依赖

<dependency>
<groupId>io.github.openfeign.form</groupId>
<artifactId>feign-form</artifactId>
<version>3.0.3</version>
</dependency>
<dependency>
<groupId>io.github.openfeign.form</groupId>
<artifactId>feign-form-spring</artifactId>
<version>3.0.3</version>
</dependency>

编写Feign Client

@FeignClient(name = "ms-content-sample", configuration = UploadFeignClient.MultipartSupportConfig.class)
public interface UploadFeignClient {
@RequestMapping(value = "/upload", method = RequestMethod.POST,
produces = {MediaType.APPLICATION_JSON_UTF8_VALUE},
consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
@ResponseBody
String handleFileUpload(@RequestPart(value = "file") MultipartFile file);

class MultipartSupportConfig {
@Bean
public Encoder feignFormEncoder() {
return new SpringFormEncoder();
}
}
}

如代码所示，在这个Feign Client中，我们引用了配置类

MultipartSupportConfig

，在

MultipartSupportConfig

中，我们实例化了

SpringFormEncoder

。这样这个Feign Client就能够上传啦。

注意点

@RequestMapping(value = "/upload", method = RequestMethod.POST,
produces = {MediaType.APPLICATION_JSON_UTF8_VALUE},
consumes = MediaType.MULTIPART_FORM_DATA_VALUE)

中的

produeces

、

consumes

不能少；

接口定义中的注解

@RequestPart(value = "file")

不能写成

@RequestParam(value = "file"

。

最好将Hystrix的超时时间设长一点，例如5秒，否则可能文件还没上传完，Hystrix就超时了，从而导致客户端侧的报错。