1. 程式人生 > >okhttp post 上傳檔案以及Multipart/form-data 的學習理解

okhttp post 上傳檔案以及Multipart/form-data 的學習理解

在app 中,最基本的設定使用者頭像,需要進行頭像的圖片上傳,那就會使用到 post 進行上傳檔案的操作。必然要了解下 Multipart/form-data 的含義。以前在寫這部分程式碼的時候,不理解Headers.of(xxx)什麼意思,而且 裡面填寫的格式又有什麼要求代表了什麼意思 等。

這裡寫圖片描述

看到上面的api 的說明文件更是頭大,所以需要了解下 Multipart/form-data

1.Multipart/form-data 解釋

  • 1.1 什麼是 Multipart/form-data:
    Multipart/form-data是上傳檔案的一種方式,是瀏覽器用表單上傳檔案的方式

  • 1.2 Multipart/form-data 上傳步驟:


    首先,客戶端和伺服器建立連線(TCP協議)。
    第二,客戶端可以向伺服器端傳送資料。因為上傳檔案實質上也是向伺服器端傳送請求。
    第三,客戶端按照符合“multipart/form-data”的格式向伺服器端傳送資料。(這一點非常重要)。

  • 1.3 Multipart/form-data 上傳格式的說明:

這裡是相關請求頭的資訊:

POST /t2/upload.do HTTP/1.1
User-Agent: SOHUWapRebot
Accept-Language: zh-cn,zh;q=0.5
Accept-Charset: GBK,utf-8;q=0.7,*;q=0.7
Connection: keep-alive
Content-Length: 60408
Content-Type:multipart/form-data; boundary=ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC
Host: w.sohu.com

–ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC
Content-Disposition: form-data;name=”desc”
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

[……][……][……][……]………………………
–ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC
Content-Disposition: form-data;name=”pic”; filename=”photo.jpg”
Content-Type: application/octet-stream
Content-Transfer-Encoding: binary

[圖片二進位制資料]
–ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC–

我們來分析下資料,第一個空行之前自然還是HTTP header,之後則是Entity,而此時的Entity也比之前要複雜一些。根據RFC 1867定義,我們需要選擇一段資料作為“分割邊界”( boundary屬性),這個“邊界資料”不能在內容其他地方出現,一般來說使用一段從概率上說“幾乎不可能”的資料即可。 不同瀏覽器的實現不同,例如火狐某次post的 boundary=—————————32404670520626 , opera為boundary=———-E4SgDZXhJMgNE8jpwNdOAX ,每次post瀏覽器都會生成一個隨機的30-40位長度的隨機字串,瀏覽器一般不會遍歷這次post的所有資料找到一個不可能出現在資料中的字串,這樣代價太大了。一般都是隨機生成,如果你遇見boundary值和post的內容一樣,那樣的話這次上傳肯定失敗,不過我建議你去買彩票,你太幸運了。Rfc1867這樣說明{A boundary is selected that does not occur in any of the data. (This selection is sometimes done probabilisticly.)}。

選擇了這個邊界之後,瀏覽器便把它放在Content-Type 裡面傳遞給伺服器,伺服器根據此邊界解析資料。下面的資料便根據boundary劃分段,每一段便是一項資料。(每個field被分成小部分,而且包含一個value是”form-data”的”Content-Disposition”的頭部;一個”name”屬性對應field的ID,等等,檔案的話包括一個filename)
IE和Chrome在filename的選擇策略上有所不同,前者是檔案的完整路徑,而後者則僅僅是檔名。
資料內容以兩條橫線結尾,並同樣以一個換行結束。在網路協議中一般都以連續的CR、LF(即\r、\n,或0x0D、Ox0A)字元作為換行,這與Windows的標準一致。如果您使用其他作業系統,則需要考慮它們的換行符。
另外Content-length 指的是所用資料的長度。

2.okhttp post 上傳圖片檔案

public class UploadHelper extends Presenter {

    public static final String TAG = "UploadHelper";
    private static final MediaType MEDIA_TYPE_PNG = MediaType.parse("image/png");
    private final OkHttpClient client = new OkHttpClient();

    public String upload(String imageType,String userPhone,File file) throws NetworkException{

        RequestBody fileBody = RequestBody.create(MediaType.parse("image/png"), file);

        RequestBody requestBody = new MultipartBody.Builder()
                .setType(MultipartBody.FORM)
///                .addPart(
//                        Headers.of("Content-Disposition", "form-data; name=\"file\"; filename=\"" + fileName + "\""),
//                        RequestBody.create(MEDIA_TYPE_PNG, file))
//                .addPart(
//                        Headers.of("Content-Disposition", "form-data; name=\"imagetype\""),
//                        RequestBody.create(null, imageType))
//                .addPart(
//                        Headers.of("Content-Disposition", "form-data; name=\"userphone\""),
//                        RequestBody.create(null, userPhone))

                .addFormDataPart("file", "head_image", fileBody)
                .addFormDataPart("imagetype", imageType)
                .addFormDataPart("userphone", userPhone)
                .build();

        Request request = new Request.Builder()
                .url("http://xxxxx")
                .post(requestBody)
                .build();

        Response response;
        try {
            response = client.newCall(request).execute();
            String jsonString = response.body().string();
            Log.d(TAG," upload jsonString ="+jsonString);

            if(!response.isSuccessful()){
                throw new NetworkException("upload error code "+response);
            }else{
                JSONObject jsonObject = new JSONObject(jsonString);
                int errorCode = jsonObject.getInt("errorCode");
                if(errorCode == 0){
                    Log.d(TAG," upload data ="+jsonObject.getString("data"));
                    return jsonObject.getString("data");
                }else {
                    throw new NetworkException("upload error code "+errorCode+",errorInfo="+jsonObject.getString("errorInfo"));
                }
            }

        } catch (IOException e) {
            Log.d(TAG,"upload IOException ",e);
        }catch (JSONException e){
            Log.d(TAG,"upload JSONException ",e);
        }
        return null;
    }

addPart 就是傳送頭部的具體內容了,其中 addFormDataPart 封裝了部分內容,本質上 和

.addPart(
Headers.of(“Content-Disposition”, “form-data; name=\”token\”“),
RequestBody.create(null, uploadToken))

道理是一樣的,只是內部進行了自己的封裝。下面是相關的原始碼

這裡寫圖片描述

3.相關的參考的部落格