Android使用xUtils3.0實現文件上傳

幾個月前寫過一篇博客《xUtils3.0框架學習筆記》 ，上面也有記錄通過xUtils實現文件上傳的使用方法，代碼如下：

private void upLoadOnClick(View v) {
    String upUrl = "/mnt/sdcard/pic/test.jpg";//指定要上傳的文件
    final ProgressDialog dia = new ProgressDialog(this);
    dia.setMessage("加載中....");
    dia.show();
    RequestParams params = new RequestParams(upUrl);
    params.addBodyParameter("file", new File(upUrl));
    x.http().post(params, new Callback.CommonCallback<String>() {
      @Override
      public void onSuccess(String result) {
        //加載成功回調，返回獲取到的數據
        Log.i(TAG, "onSuccess: " + result);
      }

      @Override
      public void onFinished() {
        dia.dismiss();//加載完成
      }

      @Override
      public void onCancelled(CancelledException cex) {

      }

      @Override
      public void onError(Throwable ex, boolean isOnCallback) {

      }
    });
  }

我在項目中通過以上方法進行圖片上傳，發現有點小問題，或許是我把這個方法使 用不到位。
在與服務器聯調時，同事總是告訴我沒有收到文件流數據，結果肯定是上傳失敗。後來繼續看代碼跟進，發現通過
` params.addBodyParameter("file", new File(upUrl));`
這種方式傳遞文件數據，默認的請求數據類型並不是文件類型所需要的multipart/form-data類型數據。
通過看相應源碼，我們在使用xUtils實現網絡請求時，通過
`RequestParams params = new RequestParams(Constants.ADD_ZONE_PLANE);`創建請求，然後通過
` params.setRequestBody(body);`傳遞請求參數。
其實setRequestBody(RequestBody requestBody)方法是調用RequestParams的父類BaseParams中的方法：

 public void setRequestBody(RequestBody requestBody) {
    this.requestBody = requestBody;
  } 

考慮是參數數據類型問題，我們就從傳遞參數RequestBody入手，發現在xUtils中，默認有：
 FileBody,InputStreamBody,MultipartBody及StringBody等幾種類型的請求Body，當然這些都是RequestBody的子類 。
 發現MultipartBody類型中，有這個方法：

 private void generateContentType() {
    String boundaryPostfix = Double.toHexString(Math.random() * 0xFFFF);
    boundaryPostfixBytes = boundaryPostfix.getBytes();
    contentType = "multipart/form-data; boundary=" + new String(BOUNDARY_PREFIX_BYTES) + boundaryPostfix;
  }

看到返回的類型是multipart/form-data...，正是我想要的，所以請求參數就從MultipartBody入手考慮上傳文件。
MultipartBody類的構造方法如下：

//參數分別是要傳入的數據，和數據編碼類型
 public MultipartBody(List<KeyValue> multipartParams, String charset) {
    if (!TextUtils.isEmpty(charset)) {
      this.charset = charset;
    }
    this.multipartParams = multipartParams;
    generateContentType();
    ...
  }

從構造方法需要的參數開始，我們一步一步地實現MultipartBody所需要的數據。

    //創建List<KeyValue>對象
    List<KeyValue> list = new ArrayList<>();
    //給list中添加數據，filePah是上傳的文件路徑，比如sd卡中圖片
    list.add(new KeyValue("file", new File(filePah)));//文件流數據
    //其它參數，根據項目而定，比如我的項目中要傳入的參數是json格式的
    list.add(new KeyValue("parameters", json.toString()));
    //創建MultipartBody
     MultipartBody body = new MultipartBody(list, "UTF-8");
     //添加請求參數
    params.setRequestBody(body); 

這樣就可以實現文件上傳，最後貼下整個請求方法的相關代碼：

//要傳遞給服務器的json格式參數
JSONObject json = new JSONObject();
    try {
      json.put("devId", id);
      json.put("devName", devName);
      json.put("keyWord", keyWord);
    } catch (JSONException e) {
      e.printStackTrace();
    }
    //構建RequestParams對象，傳入請求的服務器地址URL
    RequestParams params = new RequestParams(Constants.UPLOAD_FILE);
    params.setAsJsonContent(true);
    List<KeyValue> list = new ArrayList<>();
    list.add(new KeyValue("file", new File(filePah)));
    list.add(new KeyValue("parameters", json.toString()));
    MultipartBody body = new MultipartBody(list, "UTF-8");
    params.setRequestBody(body);
    x.http().post(params, new org.xutils.common.Callback.CommonCallback<String>() {
      @Override
      public void onSuccess(String result) {
        LogUtil.e("請求結果：" + result);
      }

      @Override
      public void onFinished() {
        //上傳完成
      }

      @Override
      public void onCancelled(CancelledException cex) {
      //取消上傳
      }

      @Override
      public void onError(Throwable ex, boolean isOnCallback) {
      //上傳失敗
        LogUtil.e("請求失敗：" + ex.toString());

      }
    });

以上就是本文的全部內容，希望對大家的學習有所幫助，也希望大家多多支持本站。