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