OkHttp3.0的基本使用

概述

1.最近项目开始了，在做一个android电视的项目。我选择了OkHttp作为网络框架，已经火了很久了。写这篇博客的目的是让自己熟悉下一些网络框架，不仅仅是停留在使用上。

网络请求GET和POST

实际开发中用到的网络请求主要分为两种请求，GET请求和POST请求。
开发者角度：GET请求和POST请求的区别就是GET没有POST那么安全，还有就是POST将请求参数放到请求体(Body)里面的,而GET是将请求参数放到请求头里面的。【个人理解，不到位的地方还请多多指教】

Request

Request是封装OkHttp请求的类，Builder是其中的内部类，负责实现OkHttp请求体的各种属性.通过设置Builder就间接的设置了Request.
* Request属性介绍:[Url、method、RequestBody、tag、Headers.Builder]
* Url：访问的地址，必不可少的。必须设置。
* method：请求方式，GET方式访问调用的时候是直接:new Request.Builder()，这个时候就已经设置了method属性了，而POST方式的method属性是在new Request.Builder().post(Request)方法中帮我们设置了，总之我们调用了对应的方法也就自动的设置了method属性。
* RequestBody:个人理解就是封装请求参数的，这个不是必须的，有时候访问是没有参数的
* tag:这个暂时还不知道，但是不能为null，，在程序内部做了判断的。所以不需关心。
* Headers.Builders:请求头，封装了具体什么还不清楚。[只知道cokie就是放在请求头里面]
* 总之一句话，移动网络开发就是实现浏览器访问网页的功能！

GET请求

GET请求
···
Get同步请求：

public void RequestGet(String url) throws IOException {
    //第一步：初始化Request
    request = new Request.Builder().url(url).build();
    OkHttpClient mOkHttpClient = new OkHttpClient();
    //第二步:封装成任务
    Call call = mOkHttpClient.newCall(request);
    //第三步:同步任务执行
    call.execute();
}

Get异步请求：

public void RequestGet(String url, Callback callback) {
    //第一步：初始化Request
    request = new Request.Builder().url(url).build();
    //第二步:封装成任务
    Call call = mOkHttpClient.newCall(request);
    //第三步:异步任务执行
    call.enqueue(callback);
}

···

总结归纳：

  第一步:生成Request[可通过Builder设置各种属性]
  第二步:通过OkHttpClient将Request封装成任务
  第三步:执行任务[可以选择同步还是异步执行：一般都是异步执行，加入队列]
  注意事项:
 1.请求返回的是Response类，可以调用不同方法获得不同的数据
  A.获取字符串：Response.body().string()。
  B.获取字节数组:Response.body().bytes()。
  C.获取流:Response.body().byteStream()。这个就可以用来下载文件！
  2.第三步中可以选择call.enqueue()，也就是不加参数。
  A.不加参数就是同步执行。同步执行就会阻塞主线程，相信这个一般情况下应该是不希望出现的吧。
  B.加参数callback就是异步执行。
  C.异步执行的方法不是在UI线程执行，所以需要结合Handler或者其他的工具进行UI更新。
  D.GET方式是无法设置Requestbody属性的。[主要是因为设置了Requestbody属性后就变成了POST请求了。

POST请求

···
Post异步请求

public void RequestAsyncPost(String url, Callback callback) {
    FormEncodingBuilder builder = new FormEncodingBuilder();
    builder.add("name", "ZHUWANG");

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

Post同步请求

public void RequestAsyncPost(String url, Callback callback) {
    FormEncodingBuilder builder1 = new FormEncodingBuilder(); 2.0的
    FormBody.Builder builder=new FormBody.Builder();
    builder.add("name","zhuwang");
    Request request = new Request.Builder()
            .url(url)
            .post(builder.build())
            .build();
    mOkHttpClient.newCall(request).enqueue(callback);
}

···

总结归纳：

  第一步:准备好requestBody.通过查看源码可以知道：Post请求时必须要调用post(Requestbody body)方法的，不然要报错。【这是和GET请求最大的区别：必须调用Request.Builder.post()方法，目的是构造请求体和设置Request的method属性】
 第二步:生成Request[可通过Builder设置各种属性]
 第三步:通过OkHttpClient将Request封装成任务
 第四步:执行任务[可以选择同步还是异步执行：一般都是异步执行，加入队列]
 注意事项:
 1.请求返回的是Response类，可以调用不同方法获得不同的数据
  A.获取字符串：Response.body().string()。
  B.获取字节数组:Response.body().bytes()。
  C.获取流:Response.body().byteStream()。这个就可以用来下载文件！
 2.第三步中可以选择call.enqueue()，也就是不加参数。
  A.不加参数就是同步执行。同步执行就会阻塞主线程，相信这个一般情况下应该是不希望出现的吧。
  B.加参数callback就是异步执行。
  C.异步执行的方法不是在UI线程执行，所以需要结合Handler或者其他的工具进行UI更新。
 3.Callback:这是异步请求的返回接口。

这是异步请求的返回接口。

Callback


void onFailure(Request request, IOException e);
void onResponse(Response response) throws IOException;

很简单不用多说，只是提醒一下，这两个回调方法不能在UI线程执行更新UI的操作！

RequestBody

RequestBody是POST请求独有的，能够构造RequestBody的类有很多，从最简单的表单到复杂的文件上传，OkHttp3.0都有对应的类，使用这些类进行封装RequestBody在以后的操作中会经常遇到。下面我总结几种经常使用到的。
1. 表单提交
FormEncodingBuilder 这是2.0使用的。而3.0使用的是FromBody，它是RequestBody的子类。专门用于提交表单信息。

FormEncodingBuilder 2.0
FormEncodingBuilder builder = new FormEncodingBuilder();
builder.add("name", "zhuwang");
FormBody.Builder 3.0
FormBody.Builder builder=new FormBody.Builder();
builder.add("name","zhuwang");

从名字上来说也很符合表单提交的意义！
2.如果是文件上传
MultipartBody：这个也是RequestBody的子类。这个是用于多文件上传的！
“`
/* 第一个要上传的file */
File file1 = new File(Environment.getExternalStorageDirectory().getAbsolutePath() + “/a.jpg”);
RequestBody fileBody1 = RequestBody.create(MediaType.parse(“application/octet-stream”) , file1);
String file1Name = “testFile1.txt”;

/* 第二个要上传的文件,这里偷懒了,和file1用的一个图片 */  
File file2 = new File(Environment.getExternalStorageDirectory().getAbsolutePath() + "/a.jpg");  
RequestBody fileBody2 = RequestBody.create(MediaType.parse("application/octet-stream") , file2);  
String file2Name = "testFile2.txt";  


/* form的分割线,自己定义 */  
String boundary = "xx--------------------------------------------------------------xx";  

MultipartBody mBody = new MultipartBody.Builder(boundary).setType(MultipartBody.FORM)  
        /* 上传一个普通的String参数 , key 叫 "p" */  
        .addFormDataPart("p" , "666")  
        /* 底下是上传了两个文件 */  
        .addFormDataPart("file" , file1Name , fileBody1)  
        .addFormDataPart("file" , file2Name , fileBody2)  
        .build();  
  Request request = new Request.Builder()
            .url(url)
            .post(mBody )
            .build();
    mOkHttpClient.newCall(request).enqueue(callback);

“`
好了，RequestBody就先总结道这儿了！下次再来修改！

总结

所以OkHttp的回调接口Callback不能在UI线程执行更新UI的操作，这点很不爽，还需要自己封装。另外就是返回的Response类里面仅仅只能拿到字符串，流，bytes。不能直接拿到已经Json转出来的对象，所以还是得自己封装！
今天就这样！明天封装完成后再发表！希望能和大家一起交流沟通！