HEADER:

BODY:

Content-type: multipart/form-data, boundary=AaB03x--AaB03xcontent-disposition: form-data; name="field1"Joe Blow--AaB03xcontent-disposition: form-data; name="pics"Content-type: multipart/mixed, boundary=BbC04y--BbC04yContent-disposition: attachment; filename="file1.txt"

注释：

1 传文件的时候 使用的Media Type name: multipart , Media subtype name: form-data

2 boundary用来标识分割不同的field，其中文件是一个特殊的field

3 多个文件的时候得继续制定 Content-type: multipart/mixed ，同时定义新的 boundary

4 不同的field注意区分 Content-disposition 的值，是 form/data 还是 attachment

5 这里定义的是POST方式的上传，不针对PUT 。

2 如果需求非常确定每次请求只上传一个文件，那么我们可以不使用HTTP约定的这种方式，而改用一种更简单直接的方式：

- 在 HEDER 里的 POST 后的URL里携带普通参数 field

- 在 BODY里直接装在要上传的文件内容，抛弃任何格式等约束

- 服务端直接从BODY里读取流数据保存为文件，其他参数从URL里读取

这样以来HTTP报文就类似：

HEDER

BODY

注释：

1 这不是标准的文件上传方式，但仍然是标准的HTTP报文

2 这种私有约定的方式，需要服务端和客户端同时特异化处理

3 针对每次请求只传一个文件的需求，这样改良后就会比较简洁，至于效率上是否有明显差别还不得而知，未做测试对比

3 总结：

在HTTP协议这一层上做文件的上传下载，也是很常见的方式，尤其很多移动应用里会采用；因为对客户端来说打开一个URL来GET或POST数据，相比打开一个scocke连接来读取或写入数据要简单得多，实现也快捷高效。

HTTP协议上的上传下载，也可以轻松实现断点续传，和进度反馈等，主要依赖length和range两个值。所以作为标准考虑，一定要明确地设置header里的length属性 --- 如果不设置，对于一般浏览器来说无碍，仍然可以成功下载，但是对于诸如libcurl这样的类库来说则无法取到数据。

另外，TCP协议层上的文件上传下载，也是很常见的应用场景，改日再次涉及另作详谈。

/

在开发中，我们使用的比较多的HTTP请求方式基本上就是GET、POST。其中GET用于从服务器获取数据，POST主要用于向服务器提交一些表单数据，例如文件上传等。而我们在使用HTTP请求时中遇到的比较麻烦的事情就是构造文件上传的HTTP报文格式，这个格式虽说也比较简单，但也比较容易出错。今天我们就一起来学习HTTP POST的报文格式以及通过Java来模拟文件上传的请求。

首先我们来看一个POST的报文请求，然后我们再来详细的分析它。

POST报文格式

POST /api/feed/ HTTP/1.1
Accept-Encoding: gzip
Content-Length: 225873
Content-Type: multipart/form-data; boundary=OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp
Host: www.myhost.com
Connection: Keep-Alive--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp
Content-Disposition: form-data; name="lng"
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit116.361545
--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp
Content-Disposition: form-data; name="lat"
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit39.979006
--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp
Content-Disposition: form-data; name="images"; filename="/storage/emulated/0/Camera/jdimage/1xh0e3yyfmpr2e35tdowbavrx.jpg"
Content-Type: application/octet-stream
Content-Transfer-Encoding: binary这里是图片的二进制数据
--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp--

这里我们提交的是经度、纬度和一张图片（图片数据比较长，而且比较杂乱，这里省略掉了）。

格式分析

请求头分析

我们先看 报文格式中的第一行：

POST /api/feed/ HTTP/1.1

Accept-Encoding: gzip
Content-Length: 225873
Content-Type: multipart/form-data; boundary=OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp
Host: www.myhost.com
Connection: Keep-Alive

其中这里需要注意的一点是分隔符，即boundary。 boundary用于作为请求参数之间的界限标识，例如参数1和参数2之间需要有一个明确的界限，这样服务器才能正确的解析到参数1和参数2。但是分隔符并不仅仅是boundary，而是下面这样的格式：-- + boundary。例如这里的boundary为 OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp，那么参数分隔符则为:

--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp

请求实体分析

请求实体其实就是HTTP POST请求的参数列表，每个参数以请求分隔符开始，即-- + boundary。例如下面这个参数。

--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp
Content-Disposition: form-data; name="lng"
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit116.361545

注意这里的每行之间都是使用“\r\n”来换行的，最后一行和参数内容之间是两个换行。文件参数也是一样的格式，只是文件参数的内容是字节流。

这里要注意一下，普通文本参数和文件参数有如下两个地方的不同，因为其内容本身的格式是不一样的。

普通参数：

Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

文件参数：

Content-Type: application/octet-stream
Content-Transfer-Encoding: binary

参数实体的最后一行是: --加上boundary加上--，最后换行，这里的 格式即为: --OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp--。

模拟文件上传请求

public static void uploadFile(String fileName) {try {
  // 换行符
  final String newLine = "\r\n";
  final String boundaryPrefix = "--";
  // 定义数据分隔线
  String BOUNDARY = "========7d4a6d158c9";
  // 服务器的域名
  URL url = new URL("www.myhost.com");
  HttpURLConnection conn = (HttpURLConnection) url.openConnection();
  // 设置为POST情
  conn.setRequestMethod("POST");
  // 发送POST请求必须设置如下两行
  conn.setDoOutput(true);
  conn.setDoInput(true);
  conn.setUseCaches(false);
  // 设置请求头参数
  conn.setRequestProperty("connection", "Keep-Alive");
  conn.setRequestProperty("Charsert", "UTF-8");
  conn.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + BOUNDARY);
  OutputStream out = new DataOutputStream(conn.getOutputStream());
  // 上传文件
  File file = new File(fileName);
  StringBuilder sb = new StringBuilder();
  sb.append(boundaryPrefix);
  sb.append(BOUNDARY);
  sb.append(newLine);
  // 文件参数,photo参数名可以随意修改
  sb.append("Content-Disposition: form-data;name=\"photo\";filename=\"" + fileName
          + "\"" + newLine);
  sb.append("Content-Type:application/octet-stream");
  // 参数头设置完以后需要两个换行，然后才是参数内容
  sb.append(newLine);
  sb.append(newLine);
  // 将参数头的数据写入到输出流中
  out.write(sb.toString().getBytes());
  // 数据输入流,用于读取文件数据
  DataInputStream in = new DataInputStream(new FileInputStream(
          file));
  byte[] bufferOut = new byte[1024];
  int bytes = 0;
  // 每次读1KB数据,并且将文件数据写入到输出流中
  while ((bytes = in.read(bufferOut)) != -1) {
      out.write(bufferOut, 0, bytes);
  }
  // 最后添加换行
  out.write(newLine.getBytes());
  in.close();
  // 定义最后数据分隔线，即--加上BOUNDARY再加上--。
  byte[] end_data = (newLine + boundaryPrefix + BOUNDARY + boundaryPrefix + newLine)
          .getBytes();
  // 写上结尾标识
  out.write(end_data);
  out.flush();
  out.close();
  // 定义BufferedReader输入流来读取URL的响应
//	BufferedReader reader = new BufferedReader(new InputStreamReader(
//	        conn.getInputStream()));
//	String line = null;
//	while ((line = reader.readLine()) != null) {
//	    System.out.println(line);
//	}} catch (Exception e) {
  System.out.println("发送POST请求出现异常！" + e);
  e.printStackTrace();}}

使用Apache Httpmime上传文件

/*** @param fileName 图片路径*/public static void uploadFileWithHttpMime(String fileName) {// 定义请求urlString uri = "www.myhost.com";// 实例化http客户端HttpClient httpClient = new DefaultHttpClient();// 实例化post提交方式HttpPost post = new HttpPost(uri);// 添加json参数try {
  // 实例化参数对象
  MultipartEntity params = new MultipartEntity();
  // 图片文本参数
  params.addPart("textParams", new StringBody(
          "{'user_name':'我的用户名','channel_name':'却道明','channel_address':'(123.4,30.6)'}",
          Charset.forName("UTF-8")));
  // 设置上传文件
  File file = new File(fileName);
  // 文件参数内容
  FileBody fileBody = new FileBody(file);
  // 添加文件参数
  params.addPart("photo", fileBody);
  params.addPart("photoName", new StringBody(file.getName()));
  // 将参数加入post请求体中
  post.setEntity(params);
  // 执行post请求并得到返回对象 [ 到这一步我们的请求就开始了 ]
  HttpResponse resp = httpClient.execute(post);
  // 解析返回请求结果
  HttpEntity entity = resp.getEntity();
  InputStream is = entity.getContent();
  BufferedReader reader = new BufferedReader(new InputStreamReader(is));
  StringBuffer buffer = new StringBuffer();
  String temp;
  while ((temp = reader.readLine()) != null) {
      buffer.append(temp);
  }
  System.out.println(buffer);} catch (UnsupportedEncodingException e) {
  e.printStackTrace();} catch (ClientProtocolException e) {
  e.printStackTrace();} catch (IOException e) {
  e.printStackTrace();} catch (IllegalStateException e) {
  e.printStackTrace();}}