文件上传，当前支持在vertx rest通道和servlet rest中使用。

文件上传使用标准的http form格式，可与浏览器的上传直接对接。

Producer：

支持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) {
  ……
}

配置说明：

Consumer：

支持以下数据类型：

• 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即可。

透明RPC代码样例：

interface UploadIntf {
  String upload(File file);
}

获得接口引用后，直接调用即可：

String result = uploadIntf.upload(file);

RestTemplate代码样例：

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);