为何okhttpclient不能builder

1、概述
  最近在群里听到各类讨论okhttp的话题,可见okhttp的口碑至关好了。再加上Google貌似在6.0版本里面删除了HttpClient相关API,对于这个行为不作评价。为了更好的在应对网络访问,学习下okhttp仍是蛮必要的,本篇博客首先介绍okhttp的简单使用,主要包含:
  通常的get请求
  通常的post请求
  基于Http的文件上传
  文件下载
  加载图片
  支持请求回调,直接返回对象、对象集合
  支持session的保持
  最后会对上述几个功能进行封装,完整的封装类的地址见:https://github.com/hongyangAndroid/okhttp-utils
  使用前,对于Android Studio的用户,能够选择添加:
  compile 'com.squareup.okhttp:okhttp:2.4.0'1

  或者Eclipse的用户,能够下载最新的jar okhttp he latest JAR ,添加依赖就能够用了。
  注意:okhttp内部依赖okio,别忘了同时导入okio:
  gradle: compile 'com.squareup.okio:okio:1.5.0'
  最新的jar地址:okio the latest JAR
  2、使用教程
  (一)Http Get
  对了网络加载库,那么最多见的确定就是http get请求了,好比获取一个网页的内容。
  //建立okHttpClient对象
OkHttpClient mOkHttpClient = new OkHttpClient();
//建立一个Request
final Request request = new Request.Builder()
                .url("https://github.com/hongyangAndroid")
                .build();
//new call
Call call = mOkHttpClient.newCall(request); 
//请求加入调度
call.enqueue(new Callback()
        {
            @Override
            public void onFailure(Request request, IOException e)
            {
            }

            @Override
            public void onResponse(final Response response) throws IOException
            {
                    //String htmlStr =  response.body().string();
            }
        });             

123456789101112131415161718192021222324

  以上就是发送一个get请求的步骤,首先构造一个Request对象,参数最起码有个url,固然你能够经过Request.Builder设置更多的参数好比:header、method等。
  而后经过request的对象去构造获得一个Call对象,相似于将你的请求封装成了任务,既然是任务,就会有execute()和cancel()等方法。
  最后,咱们但愿以异步的方式去执行请求,因此咱们调用的是call.enqueue,将call加入调度队列,而后等待任务执行完成,咱们在Callback中便可获得结果。
  看到这,你会发现,总体的写法仍是比较长的,因此封装确定是要作的,否则每一个请求这么写,得累死。
  ok,须要注意几点:
  onResponse回调的参数是response,通常状况下,好比咱们但愿得到返回的字符串,能够经过response.body().string()获取;若是但愿得到返回的二进制字节数组,则调用response.body().bytes();若是你想拿到返回的inputStream,则调用response.body().byteStream()
  看到这,你可能会奇怪,居然还能拿到返回的inputStream,看到这个最起码能意识到一点,这里支持大文件下载,有inputStream咱们就能够经过IO的方式写文件。不过也说明一个问题,这个onResponse执行的线程并非UI线程。的确是的,若是你但愿操做控件,仍是须要使用handler等,例如:
  @Override
public void onResponse(final Response response) throws IOException
{
      final String res = response.body().string();
      runOnUiThread(new Runnable()
      {
          @Override
          public void run()
          {
            mTv.setText(res);
          }

      });
}

  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
  13
  14
  咱们这里是异步的方式去执行,固然也支持阻塞的方式,上面咱们也说了Call有一个execute()方法,你也能够直接调用call.execute()经过返回一个Response。
  (二) Http Post 携带参数
  看来上面的简单的get请求,基本上整个的用法也就掌握了,好比post携带参数,也仅仅是Request的构造的不一样。
  Request request = buildMultipartFormRequest(
        url, new File[]{file}, new String[]{fileKey}, null);
FormEncodingBuilder builder = new FormEncodingBuilder();   
builder.add("username","张鸿洋");

Request request = new Request.Builder()
                   .url(url)
                .post(builder.build())
                .build();
 mOkHttpClient.newCall(request).enqueue(new Callback(){});12345678910

  你们都清楚,post的时候,参数是包含在请求体中的;因此咱们经过FormEncodingBuilder。添加多个String键值对,而后去构造RequestBody,最后完成咱们Request的构造。
  后面的就和上面同样了。
  (三)基于Http的文件上传
  接下来咱们在介绍一个能够构造RequestBody的Builder,叫作MultipartBuilder。当咱们须要作相似于表单上传的时候,就可使用它来构造咱们的requestBody。
  File file = new File(Environment.getExternalStorageDirectory(), "balabala.mp4");

RequestBody fileBody = RequestBody.create(MediaType.parse("application/octet-stream"), file);

RequestBody requestBody = new MultipartBuilder()
     .type(MultipartBuilder.FORM)
     .addPart(Headers.of(
          "Content-Disposition", 
              "form-data; name=\"username\""), 
          RequestBody.create(null, "张鸿洋"))
     .addPart(Headers.of(
         "Content-Disposition", 
         "form-data; name=\"mFile\"; 
         filename=\"wjd.mp4\""), fileBody)
     .build();

Request request = new Request.Builder()
    .url("http://192.168.1.103:8080/okHttpServer/fileUpload")
    .post(requestBody)
    .build();

Call call = mOkHttpClient.newCall(request);
call.enqueue(new Callback()
{
    //...
});1234567891011121314151617181920212223242526

  上述代码向服务器传递了一个键值对username:张鸿洋和一个文件。咱们经过MultipartBuilder的addPart方法能够添加键值对或者文件。
  其实相似于咱们拼接模拟浏览器行为的方式,若是你对这块不了解,能够参考:从原理角度解析Android (Java) http 文件上传
  ok,对于咱们最开始的目录还剩下图片下载,文件下载;这两个一个是经过回调的Response拿到byte[]而后decode成图片;文件下载,就是拿到inputStream作写文件操做,咱们这里就不赘述了。
  关于用法,也能够参考泡网OkHttp使用教程
  接下来咱们主要看如何封装上述的代码。
  3、封装
  因为按照上述的代码,写多个请求确定包含大量的重复代码,因此我但愿封装后的代码调用是这样的
相关文章
相关标签/搜索