Android之文件上传原理
个人主页：http://shiyiliang.cn
基本原理
我们知道，在浏览器中，我们上传文件时，是这样的（jsp）实现：
<form action="/blog/upload" method="post" enctype="multipart/form-data">
<input type="text" name="token"><br/>
<input type="file" name="uploadFile">
<input type="submit" value="Upload File">
</form>
我们需要指定表单的方法类型，这里一般是post,enctype 属性规定在发送到服务器之前应该如何对表单数据进行编码，一般有如下几种：
- application/x-www-form-urlencoded：在发送前编码所有字符（默认）
- multipart/form-data: 不对字符编码。在使用包含文件上传控件的表单时，必须使用该值。
- text/plain: 空格转换为 "+" 加号，但不对特殊字符编码。
当点击上传时，可以打开浏览器的网络调试，查看请求体中的数据如下：
------WebKitFormBoundaryT1HoybnYeFOGFlBR
Content-Disposition: form-data; name="token"
xjjdke2m5hkjk3j3k43
------WebKitFormBoundaryT1HoybnYeFOGFlBR
Content-Disposition: form-data; name="file"; filename="ss.jpg"
Content-Type: image/jpeg
....jpg的二进制数据...
------WebKitFormBoundaryT1HoybnYeFOGFlBR--
从请求中的数据可以看出，请求体中，把所有的数据封装起来，使用------WebKitFormBoundaryT1HoybnYeFOGFlBR来进行隔开，不同类型，一些指定的参数也不一样：
- 如果是简单的键值对，需要指定
Content-Disposition也就是内容的描述，同时指定名字和值，也即是name的值以及与其对应的值（这里是token的值） - 如果是文件的话，不仅要指定内容的描述，name值，还要指定文件的名称
filename，内容的类型（如这里传的图片类型），图片的二进制数据
浏览器把这些数据封装到固定的格式后，发送给服务端，而服务端在接受到请求之后，会以这个Boundary的值来分割获取传送过来的值，从而进行处理。
Android如何来上传文件(不用框架)
我们知道Android开发时，不像浏览器，会自动的组装这些数据，那么我们在不使用现成的网络请求框架的情况下，如何上传数据呢？
答案很明晰那里 ，只要我们模仿浏览器的行为，人为的把这些数据封装成跟浏览器的一样，放到请求体中，不就可以正常上传了。不多说~~，直接上[lisdye2的使用的代码]例子：
/**
* 文件表单上传
*/
public class FileUpLoadTest {
// 分割符
private static final String BOUNDARY = "----WebKitFormBoundaryT1HoybnYeFOGFlBR";
/**
* HttpUrlConnection 实现文件上传
* @param params 普通参数
* @param fileFormName 文件在表单中的键
* @param uploadFile 上传的文件
* @param newFileName 文件在表单中的值（服务端获取到的文件名）
* @param urlStr url
* @throws IOException
*/
public static void uploadForm(Map<String, String> params, String fileFormName, File uploadFile, String newFileName,
String urlStr) throws IOException {
if (newFileName == null || newFileName.trim().equals("")) {
newFileName = uploadFile.getName();
}
//开始拼接数据
StringBuilder sb = new StringBuilder();
/**
* 普通的表单数据
*/
if (params != null) {
for (String key : params.keySet()) {
sb.append("--" + BOUNDARY + "\r\n");
sb.append("Content-Disposition: form-data; name=\"" + key + "\"" + "\r\n");
sb.append("\r\n");
sb.append(params.get(key) + "\r\n");
}
}
/**
* 上传文件的头
*/
sb.append("--" + BOUNDARY + "\r\n");
sb.append("Content-Disposition: form-data; name=\"" + fileFormName + "\"; filename=\"" + newFileName + "\""
+ "\r\n");
sb.append("Content-Type: image/jpeg" + "\r\n");// 如果服务器端有文件类型的校验，必须明确指定ContentType
sb.append("\r\n");
byte[] headerInfo = sb.toString().getBytes("UTF-8");
byte[] endInfo = ("\r\n--" + BOUNDARY + "--\r\n").getBytes("UTF-8");
URL url = new URL(urlStr);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
// 设置传输内容的格式，以及长度
conn.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + BOUNDARY);
conn.setRequestProperty("Content-Length",
String.valueOf(headerInfo.length + uploadFile.length() + endInfo.length));
conn.setDoOutput(true);
OutputStream out = conn.getOutputStream();
InputStream in = new FileInputStream(uploadFile);
// 写入头部 （包含了普通的参数，以及文件的标示等）
out.write(headerInfo);
// 写入文件
byte[] buf = new byte[1024];
int len;
while ((len = in.read(buf)) != -1) {
out.write(buf, 0, len);
}
// 写入尾部
out.write(endInfo);
in.close();
out.close();
if (conn.getResponseCode() == 200) {
System.out.println("文件上传成功");
}
}
public static void main(String[] args) throws IOException {
//上传的文件
File file = new File("ss.png");
// 普通参数
HashMap<String , String> params = new HashMap<>();
params.put("user", "admin");
uploadForm(params, "file", file, "ss.jpg", "http://localhost:8080/Web/UploadFile");
}
}
上面的代码还是比较简单的，相信大部分人，都能够看懂。其基本的原理就是按照顺序，不断的把数据拼接成服务器能够识别的格式也就是上面讲的格式，然后传递给服务端，让其解析处理即可。
总结思考：如果自己想封装一个上传的框架或者工具类，一般会做哪些工作呢？
从上面例子我们可以看到，上传的数据一般分为：键值对和文件两类，如果封装成一个框架，只需要把外面要传入的键值对即键值对的name和value对外暴露。如果是文件，那只要指定文件的路径，文件的名称(filename)，文件的类型(Content-type)，而我们把拼接流程和请求的流程封装起来，不就完成了封装了吗~~
如果想知道框架是怎么上传文件的，可以看下[Retrofit学习之文件上传]
如果你觉得文章让你有一些收获，你就关注一下~。
