记一次android 客户端对接网站联调文件上传工作
后端：spring boot 框架
客户端：retrofit + okhttp + rxjava
1.文本
后端：
/**
* 会话组内信息发送
* @param groupSendMsgQuery 发送信息
* @return 消息ID、会话组Id
*/
@RequestMapping(value = "/groupsendmsg", method = RequestMethod.POST)
MsgGroupVO groupSendMsg(@Valid @RequestBody GroupSendMsgQuery groupSendMsgQuery);
客户端：
@POST("zxjx/jxgt/msg/groupsendmsg")
Observable<JsonObject> sendMsg(@Body Map map);
客户端数据结构：
{
username：“username”，
password：“password”，
xxx：xxx,
...
}
客户端组装map入参时候，也不用对字段进行编码转为requestBody
2.图文
思路：
- 文件：先调通只传文件
- 文件，文本：之后加入其他文本字段。比如：file。username，password，xxx
- 文件+文本：由于文件 跟 文本 分开，在客户端实现上分开传只有这一种方案，毕竟不合乎小伙伴们的探索精神，所以，调试一下文件体跟文本放到一个map中上传。
2.1 文件，文本分开传方案
后端：
/**
* 测试文件上传
* @param files 要上传的文件
* @return
*/
@PostMapping(value = "/upload-file")
String uploadFile(@RequestParam("files") MultipartFile[] files, @RequestParam("username") String username);
客户端：
@Multipart
@POST("msg/upload-file-test2")
Observable<JsonObject> sendMsgfile(@Part("files") RequestBody body，@PartMap Map<String ,Object> map);
可看到, 服务端是用files为key接收客户端传递以files为文件标识的文件数据。但是其他文件的参数怎么传：1：放入map中。2：包装文件体时候设置：如下
RequestBody mbody = new MultipartBody.Builder()
.addFormDataPart("file-type", "profile")
.addFormDataPart("files", "image.png", body)
.build();
后端接收到客户端请求，拿到那个files，就能获取到文件名，文件大小等：
files[0].getName
files[0].getSize
files[0].getContentType()
以上方案：主要是先调试走通文件上传功能。大家能发现：后端接收其他文本字段时候，也是通过“@RequestParam("username") String username”，客户端不可能只传一个字段的。所以，接下来首先要解决的问题就是后端接收 file + map
2.2 文件，文本一起方案 过渡
后端 file + map。大家一看就能想到：发送纯文本的，和文件的结合一下喽
后端：
/**
* 测试文件上传
* @param files 要上传的文件
* @return
*/
@PostMapping(value = "/upload-file")
String uploadFile(@RequestParam("files") MultipartFile[] files, @Valid @RequestBody SendMsgQuery sendMsgQuery);
可是后端一运行工程，才知道，哪TM这么顺利啊。不支持，一运行就崩溃，我一客户端，其实我也不知道为啥，，
2.3 文件+文本
既然上面天真的想法走不通，那就后端想办法呗
哈哈：办法总是比问题多的
后端：
/**
* 测试文件上传
* @param files 要上传的文件
* @return
*/
@PostMapping(value = "/upload-file-test2")
String uploadFileTest2(HttpServletRequest request)
客户端：
@Multipart
@POST("msg/upload-file-test2")
Observable<JsonObject> sendMsgfile(@PartMap Map<String ,Object> map);
参考文章：Android Retrofit 实现图文上传-文字参数类型
后端请求结果：
看后端结果，客户端的文件传过去了。是不是小激动
以上方案：这种方案的客户端数据结构是单层map。形如：{xx:xx, xx:xx}。。但是，但是，但是。不满足工程使用：我们走通的这种方案，跟工程里的不太一样，放到工程里，可能走不通。说工程里传的时候json串，我在想，传了文件，怎么还能形成json串，怎么还能？。所以，家下来是先解决数据结构多次对象嵌套的问题{xx：xx，fileInfo：{xx：xx}}。之后再继续跟进。
2.4 后端优化
后端：
/**
* 测试文件上传
* @param files 要上传的文件
* @return
*/
@PostMapping(value = "/upload-file-test2")
String uploadFileTest2(HttpServletRequest request)
3.3中已经实践过，但层map数据结构文件和文本可以上传成功，但是多层次的就不行了。经过各种测试，也是不行。
见上面后端代码，使用的是HttpServletRequest。规范跟工程中不统一。需要使用springmvc注解。所以，结果如下：
后端：
/**
* 测试文件上传
* @param files 要上传的文件
* @return
*/
@PostMapping(value = "/upload-file")
String uploadFile(@RequestParam("files") MultipartFile[] files, @RequestParam Map map);
客户端：
@Multipart
@POST("msg/upload-file-test2")
Observable<JsonObject> sendMsgfile(@Part("file") RequestBody body, @PartMap Map<String ,Object> map);
客户端数据结构：
{
username：“username”，
password：“password”，
fileinfo：{
fileid：xxx
filename：xxx
filesize：xxx
}
xxx：xxx
}
蓝搜香菇，转了一圈。收获甚小。虽然走通了。但是后续放入工程之后，不知道能不能用，所以，以上内容可以选择性参考，后续接口上传正式联调，如果有新的内容，会更新该文章。。。
结语：android经验不足，网络相关知识欠缺，所以，只有结果，没有深入的剖析，都是查资料实践出来的，所以，大牛勿喷。
