okhttp

本文出自:【张鸿洋的博客】


一、概述


最近在群里听到各种讨论okhttp的话题,可见okhttp的口碑相当好了。再加上Google貌似在6.0版本里面删除了HttpClient相关API,对于这个行为不做评价。为了更好的在应对网络访问,学习下okhttp还是蛮必要的,本篇博客首先介绍okhttp的简单使用,主要包含:


一般的get请求


一般的post请求


基于Http的文件上传


文件下载


加载图片


最后会对上述几个功能进行封装,完整的封装类的地址见:https://github.com/hongyangAndroid/okhttp-utils


使用前,对于Android Studio的用户,可以选择添加:


compile 'com.squareup.okhttp:okhttp:2.4.0'


或者Eclipse的用户,可以下载最新的jarokhttp he latest JAR ,添加依赖就可以用了。


注意:okhttp内部依赖okio,别忘了同时导入okio:


gradle: compile 'com.squareup.okio:okio:1.5.0'


最新的jar地址:okio the latest JAR


二、使用教程


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


            }


        });


以上就是发送一个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);


          }




      });


}


我们这里是异步的方式去执行,当然也支持阻塞的方式,上面我们也说了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(){});


大家都清楚,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()


{


    //...


});


上述代码向服务器传递了一个键值对username:张鸿洋和一个文件。我们通过MultipartBuilder的addPart方法可以添加键值对或者文件。


其实类似于我们拼接模拟浏览器行为的方式,如果你对这块不了解,可以参考:从原理角度解析Android (Java) http 文件上传


ok,对于我们最开始的目录还剩下图片下载,文件下载;这两个一个是通过回调的Response拿到byte[]然后decode成图片;文件下载,就是拿到inputStream做写文件操作,我们这里就不赘述了。


关于用法,也可以参考泡网OkHttp使用教程

你可能感兴趣的:(okhttp)