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

关于Android上传功能的更多内容请点击专题：Android上传操作汇总进行学习。

您可能感兴趣的文章:android ListView结合xutils3仿微信实现下拉加载更多Android Xutils3网络请求的封装详解及实例代码Android XUtils3框架的基本使用方法(二)Android中XUtils3框架使用方法详解(一)Android使用Xutils3进行断点下载的实例