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());

            }
        });