前言

最近在做一個部落格的小專案，需要用到檔案上傳，HttpClient又被Android給棄用了，圖片框架暫時還沒學。只能使用HttpURLConnection來上傳。折騰了好久，今天終於順利地跟後臺完成了對接。因此，寫這篇部落格梳理一下知識。

理論知識

背景

最早的HTTP POST是 不支援 檔案上傳的，給程式設計開發帶來很多問題。但是在1995年，ietf出臺了rfc1867,也就是《RFC 1867 -Form-based File Upload in HTML》，用以支援檔案上傳。所以Content-Type的型別擴充了multipart/form-data用以支援向伺服器傳送二進位制資料。因此傳送post請求時候，表單屬性enctype共有二個值可選，這個屬性管理的是表單的MIME編碼：

• ①application/x-www-form-urlencoded( 注：不設定enctype屬性時預設為①)
• ②multipart/form-data

POST的報文請求分析

使用瀏覽器進行post請求將會發送以下資料：

//我是請求頭
POST /t2/upload.do HTTP/1.1
Accept-Charset: GBK,utf-8;
Connection: keep-alive
Content-Length: 60408
Content-Type:multipart/form-data; boundary=ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC //設定內容型別為表單型別，同時定義了boundary “界限標識”
 

Host: w.sohu.com

 //這裡開始請求體的地盤啦，第一條請求體的實體資料（字串引數）
--ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC       //這裡是"--"+boundary
Content-Disposition: form-data;name="xxx"   //name="xxx", xxx為要傳送的引數名
Content-Type: text/plain; charset=UTF-8     //設定內容型別為text 編碼格式為utf-8
Content-Transfer-Encoding: 8bit
 //這裡是一個空行（不可少）
116.361545        // 我勒個去（到這裡[空行之後的一行]才能寫上xxx的引數值）有點坑是吧，我也覺得
 

--ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC   //這一大串還是"--"+boundary

//第二條請求體的實體資料（圖片檔案上傳）
Content-Disposition: form-data;name="pic"; filename="photo.jpg" //指定了檔案
Content-Type: application/octet-stream          //設定了內容型別為application/octet-stream  
Content-Transfer-Encoding: binary
 //還是一個空行（不可少）
[這裡是圖片二進位制資料]
--ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC--

Boundary說明

根據RFC 1867定義，我們需要選擇一段資料作為作為請求引數之間的“界限標識” （即boundary屬性），這個“邊界資料”不能在內容其他地方出現，一般來說使用一段從概率上說“幾乎不可能”的資料即可。
不同瀏覽器的實現不同
火狐某次post的 boundary=---------------------------32404670520626，
operade某次post的 boundary=----------E4SgDZXhJMgNE8jpwNdOAX

例如引數1和引數2之間需要有一個明確的界限，這樣伺服器才能正確的解析到引數1和引數2。但是分隔符並不僅僅是boundary，而是下面這樣的格式：–+ boundary。
如：boundary為ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC，那麼引數分隔符則為:
--ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC
不管boundary本身有沒有這個”--“（字首），這個字首都是不能省略的。
最後--ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC--為結束標識

注:以上內容整理自

\r （回車） 與 \n （換行）

• ‘\r’ 回車，回到當前行的行首，而不會換到下一行，如果接著輸出的話，本行以前的內容會被逐一覆蓋；
• ‘\n’ 換行，換到當前位置的下一行，而不會回到行首；
  所以在寫完每一行資料之後要使用 \r\n才能達到切換至下一行行首的效果

例項

下面就直接貼程式碼了

    private static final int TIME_OUT = 8 * 1000;                          //超時時間
    private static final String CHARSET = "utf-8";                         //編碼格式
    private static final String PREFIX = "--";                            //字首
    private static final String BOUNDARY = UUID.randomUUID().toString();  //邊界標識 隨機生成
    private static final String CONTENT_TYPE = "multipart/form-data";     //內容型別
    private static final String LINE_END = "\r\n";                        //換行
/**
     * post請求方法
     * */
    public static void postRequest(final Map<String, String> strParams, final Map<String, File> fileParams) {
        new Thread(new Runnable() {
            @Override
            public void run() {
                HttpURLConnection conn = null;
                try {
                    URL url = new URL(requestUrl);
                    conn = (HttpURLConnection) url.openConnection();
                    conn.setRequestMethod("POST");
                    conn.setReadTimeout(TIME_OUT);
                    conn.setConnectTimeout(TIME_OUT);
                    conn.setDoOutput(true);
                    conn.setDoInput(true);
                    conn.setUseCaches(false);//Post 請求不能使用快取   
                    //設定請求頭引數
                    conn.setRequestProperty("Connection", "Keep-Alive");
                    conn.setRequestProperty("Charset", "UTF-8");
                    conn.setRequestProperty("Content-Type", CONTENT_TYPE+";boundary=" + BOUNDARY);
                    /**
                     * 請求體
                     */
                    //上傳引數
                    DataOutputStream dos = new DataOutputStream(conn.getOutputStream());
                    //getStrParams()為一個
                    dos.writeBytes( getStrParams(strParams).toString() );
                    dos.flush();

                    //檔案上傳
                    StringBuilder fileSb = new StringBuilder();
                    for (Map.Entry<String, File> fileEntry: fileParams.entrySet()){
                        fileSb.append(PREFIX)
                                .append(BOUNDARY)
                                .append(LINE_END)
                                /**
                                 * 這裡重點注意： name裡面的值為服務端需要的key 只有這個key 才可以得到對應的檔案
                                 * filename是檔案的名字，包含字尾名的 比如:abc.png
                                 */
                                .append("Content-Disposition: form-data; name=\"file\"; filename=\""
                                        + fileEntry.getKey() + "\"" + LINE_END)
                                .append("Content-Type: image/jpg" + LINE_END) //此處的ContentType不同於 請求頭 中Content-Type
                                .append("Content-Transfer-Encoding: 8bit" + LINE_END)
                                .append(LINE_END);// 引數頭設定完以後需要兩個換行，然後才是引數內容
                        dos.writeBytes(fileSb.toString());
                        dos.flush();
                        InputStream is = new FileInputStream(fileEntry.getValue());
                        byte[] buffer = new byte[1024];
                        int len = 0;
                        while ((len = is.read(buffer)) != -1){
                            dos.write(buffer,0,len);
                        }
                        is.close();
                        dos.writeBytes(LINE_END);
                    }
                    //請求結束標誌
                    dos.writeBytes(PREFIX + BOUNDARY + PREFIX + LINE_END);
                    dos.flush();
                    dos.close();
                    Log.e(TAG, "postResponseCode() = "+conn.getResponseCode() );
                    //讀取伺服器返回資訊
                    if (conn.getResponseCode() == 200) {
                        InputStream in = conn.getInputStream();
                        BufferedReader reader = new BufferedReader(new InputStreamReader(in));
                        String line = null;
                        StringBuilder response = new StringBuilder();
                        while ((line = reader.readLine()) != null) {
                            response.append(line);
                        }
                        Log.e(TAG, "run: " + response);
                    }
                } catch (Exception e) {
                    e.printStackTrace();
                }finally {
                    if (conn!=null){
                        conn.disconnect();
                    }
                }
            }
        }).start();
    }

    /**
     * 對post引數進行編碼處理
     * */
    private static StringBuilder getStrParams(Map<String,String> strParams){
        StringBuilder strSb = new StringBuilder();
        for (Map.Entry<String, String> entry : strParams.entrySet() ){
            strSb.append(PREFIX)
                    .append(BOUNDARY)
                    .append(LINE_END)
                    .append("Content-Disposition: form-data; name=\"" + entry.getKey() + "\"" + LINE_END)
                    .append("Content-Type: text/plain; charset=" + CHARSET + LINE_END)
                    .append("Content-Transfer-Encoding: 8bit" + LINE_END)
                    .append(LINE_END)// 引數頭設定完以後需要兩個換行，然後才是引數內容
                    .append(entry.getValue())
                    .append(LINE_END);
        }
        return strSb;
    }

程式設計剛入門，水平有限，如有錯漏之處，請多多指教。