文件上传,当前支持在vertx rest通道和servlet rest中使用。
文件上传使用标准的http form格式,可与浏览器的上传直接对接。
支持jaxrs和springmvc开发模式
jaxrs开发模式:
支持servlet定义的javax.servlet.http.Part类型
可以直接使用@FormParam传递文件类型及普通参数
springmvc开发模式:
支持servlet定义的javax.servlet.http.Part类型,也支持org.springframework.web.multipart.MultipartFile类型
两种数据类型功能是一致的,MultipartFile的底层也是Part
两种数据类型可以混合使用,比如第一个参数是Part,第二个参数是MultipartFile
可以直接使用@RequestPart传递文件类型及普通参数
注意:
先配置文件上传临时目录,默认为null不支持文件上传,文件上传请求Content-Type必须为multipart/form-data
同名参数只支持一个文件
支持一次传输多个不同参数名的文件
通过MultipartFile或Part打开流后,记得关闭,否则上传的临时文件会无法删除,最终导致上传临时目录被撑爆
Springmvc模式下的代码样例:
@PostMapping(path = "/upload", consumes = MediaType.MULTIPART_FORM_DATA) public String fileUpload(@RequestPart(name = "file1") MultipartFile file1, @RequestPart(name = "file2") Part file2, @RequestPart String param1) { …… }
配置项 | 默认值 | 取值范围 | 含义 |
---|---|---|---|
servicecomb.uploads.directory | null | 上传的临时文件保存在哪个目录,默认值null表示不支持文件上传 | |
servicecomb.uploads.maxSize | -1 | http body的最大允许大小,单位byte,默认值-1表示无限制 |
支持以下数据类型:
java.io.File
javax.servlet.http.Part
java.io.InputStream
org.springframework.core.io.Resource
使用InputStream时,因为是流的方式,此时没有客户端文件名的概念,所以producer获取客户端文件名会得到null
如果既要使用内存数据,又想让producer可以获取客户端文件名,可以使用resource类型,继承org.springframework.core.io.ByteArrayResource,且override getFilename即可。
interface UploadIntf { String upload(File file); }
获得接口引用后,直接调用即可:
String result = uploadIntf.upload(file);
Map<String, Object> map = new HashMap<>(); map.put("file", new FileSystemResource("a file path!")); map.put("param1", "test"); HttpHeaders headers = new HttpHeaders(); headers.setContentType(org.springframework.http.MediaType.MULTIPART_FORM_DATA); HttpEntity<Map<String, Object>> entry = new HttpEntity<>(map, headers); String reseult = template.postForObject( url, entry, String.class);