Github地址---MyOkhttpUtils

初衷

对于okhttp3出来以后，使用的都是网上封装好的库，为了更好地理解封装的内容，对okhttp本身的熟悉，肯定学一下子了，网上okhttp的方法很多，但是网上okhttp3方面的东西并不多，很多都过时的方法，总结了一下，讲了一下okhttp3的基本使用方法，在下边要耐心才会。
封装了一下基本大家使用得到的功能，想用的话可以直接拿去用，想扩展的话也可以直接下载扩展，代码比较少，不了解okhttp的可以下载学习一下，大神门口右走吧。
封装逻辑和使用的好多方法找不到，借鉴了两位大神的逻辑，相当于简化版本吧，封装的比较全面的可以参照
hongyangAndroid / okhttputils
jeasonlzy/okhttp-OkGo

本文中库的简单使用介绍

在project中添加依赖

allprojects {
  repositories {
      ...
      maven { url 'https://jitpack.io' }
  }
 }

在app中添加依赖

  dependencies {
        compile 'com.github.jlcclidong:MyOkhttpUtils:0.10'
  }

在本项目中使用okhttp的方法步骤
在application中初始化，此步骤必须，别忘记在清单文件中注册application否则不能使用

  Ok.init(this)
          .connectTimeout(3000l, TimeUnit.MILLISECONDS)
          .readTimeout(3000l, TimeUnit.MILLISECONDS)
          .commonParams("haha","1") //添加公共参数
          .commonHeader("nihao","1")  //添加公共头
          .AppInterceptor("eason", new LogInterceptor())   //应用拦截器
          .NetWorkInterceptor("eason",new LogInterceptor()) //网络拦截器 将重定向等的request response页拦截打印
          .CookieJar(new PersistentCookieJar(new SetCookieCache(), new SharedPrefsCookiePersistor(App.this)))
          .build();

请求其中callback有三种类型 fail都会返回Exception，不管是本身网络问题还是404等问题都会返回此回调，可以通过Exception类型进行自行处理

callback有三种类型
- JsonCallback<T> 传入类自动转换成bean，但是并未处理超大Json文件OOM 可自行通过流的方式来处理解析
- CallBack 返回String
- FileCallBack(String dir, String filename) 其中传入文件夹和文件名来保存返回进度(0-100)

get

Ok.get().url("http://lab.zuimeia.com/wallpaper/category/1/")
        .param("page_size", 1)
        .build()
        .call(new JsonCallBack<Bean>() {  //傳入實體類
            @Override
            public void fail(Exception e) {

            }

            @Override
            public void success(Bean bean) {
                mTv.setText(bean.getData().getBase_url());
            }
        });

post 支持键值对和文件表单上传

Ok.post().url("https://www.baidu.com")
        .param("test", 1)
        .file("test", new File(""))
        .build()
        .call(new CallBack() {
            @Override
            public void fail(Exception e) {

            }

            @Override
            public void success(String response) {
                mTv.setText(response);
            }
        });

download 文件下载只做到最基本的下载,断点续传和暂停下载暂未做，后续会追加

 Ok.download().url("http://static.oschina.net/uploads/space/2015/0629/170157_rxDh_1767531.png")
        .build()
        .tag(MainActivity.this)
        .call(new FileCallBack(getCacheDir().getAbsolutePath(), "github.png") {
            @Override
            public void progress(int progress) {
                mTv.setText(progress + "");
            }

            @Override
            public void success(File file) {
                mIV.setImageBitmap(BitmapFactory.decodeFile(file.getAbsolutePath()));
            }

            @Override
            public void fail(Exception e) {

            }
        });

取消
```
 Ok.cancle(MainActivity.this);
```
同时支持PostJson() 和 PostFile()两种方法

其中日志打印时使用了格式化JsonFormat工具类
请求时自动添加了 Accept-Language 和 User-Agent
简单封装没有太多的代码，可以自行下载扩展
okhttp本身的基本使用

初始化一个全局的okhttpclient

   OkHttpClient okHttpClient = new OkHttpClient.Builder()
          .connectTimeout(3000l, TimeUnit.MILLISECONDS)
          .readTimeout(3000l, TimeUnit.MILLISECONDS)
          .addInterceptor( new LogInterceptor())
          .cookieJar(...)
          .build();

当然初始化的方法有很多这里只是列出常用的方法，okhttp建议全局使用同一个

为了更好的理解get，post方法，我们可以写一个interceptor来监听request和response，实现这个类不可以出现问题否则是无法进行正常请求的
可以在此处修改request和response的参数添加缓存设置等，可自行添加
主要方法有这样几个，必须重写的方法

 @Override
  public Response intercept(Chain chain) throws IOException {
    Request request = chain.request(); 
    logForRequest(request);
    return logForResponse(response, time);
  }

打印request没有什么特别注意的地方

private void logForRequest(Request request) {
  try {
      Log.e("============request start===============");
      Log.e("url:" + request.url());
      Log.e("method:" + request.method());
      if (request.headers() != null && request.headers().size() > 0)
          Log.e("headers:" + request.headers().toString());
      Log.e("============request end=================");
  } catch (Exception e) {
      Log.e("log request has something worng!!");
  }
  }

打印response时注意，如果添加了interceptor则不能直接调用response.body().string()方法，调用此方法会直接close掉这个response，在callback中得不到正确的结果会报异常，只能使用response.newbuilder() 方法来使用新创建的response调用，eg

  private Response logForResponse(Response response, long time) {
  try {
      Log.e("============response start==============");
      //response.body().string()只能调用一次 body()就会关掉
      //每次使用前都clone一份使用保证原来的body没有被关掉
      Response copy = response.newBuilder().build();
      Log.e("responseurl:" + copy.request().url());
      Log.e("response code:" + copy.code());
      Log.e("total time:" + time);
      if (!TextUtils.isEmpty(copy.message()))
          Log.e("message:" + copy.message());
      if (copy.headers() != null && copy.headers().size() > 0)
          Log.e("headers:" + copy.headers().toString());
      Log.e("============response end================");
      ResponseBody body = copy.body();
      if (body != null) {
          MediaType mediaType = body.contentType();
          if (mediaType != null) {
              Log.e("============response body===============");
              Log.e("Content-type:" + mediaType.toString());
              if (isText(mediaType)) {
                  String content = body.string();
                  Log.e(JsonFormat.formatJson(content));
                  Log.e("============response body===============");
                  return response.newBuilder().body(ResponseBody.create(mediaType, content)).build();
              } else {
                  Log.e(" maybe response content too large too print , ignored!");
              }
          }
      } else {
          Log.e(" body is null , ignored!");
      }
  } catch (Exception e) {
      Log.e("log response has something worng!!");
  }
  return response;
}

这样每次调用http请求是就可以详细监听其中的内容了
全部具体内容详见github代码

okhttp请求就是构建一个request加入到okhttpclicent中就可以了
这里实例只讲okhttp的异步请求，当然同步只是将enqueue()方法替换成execute()
注意这个回调的onFailure只是回调了本身请求的一些失败回调，例如超时IOException....当成功返回之后需要在onResponse中判断response.code()来判断是否是200，404，500之类的统一处理
- get
```
Request request = new Request.Builder().get()
        .url("https://www.baidu.com")
        .header("test","fds")
        .build();
okHttpClient.newCall(request).enqueue(new Callback() {
    @Override
    public void onFailure(Call call, IOException e) {

    }

    @Override
    public void onResponse(Call call, Response response) throws IOException {

    }
});
```
- post
  只需要替换request post中需要传一个requestBody，不同的post请求，需要不同的请求体，当然只是方便我们不同的需求。
  基本的键值对上传在下面贴出，使用FormBody即可创建
  键值对加上文件上传则需要MultipartBody来创建
  而普通的上传json，上传文件可以直接调用RequestBody的静态方法来创建
```
Request request = new Request.Builder().post(new FormBody.Builder().add("sdf","Sdfa").build())
        .url("https://www.baidu.com")
        .header("test","fds")
        .build();
```
  其他方法详见本库中request中做的封装，都包含入内了
https的影响，okhttps本身不添加任何代码就可以支持okhttps中公认的证书，类似于百度之类的，当时像12306这种只能手动添加了，当然也可以默认信任所有证书，具体由于本人公司并不需要就没写,推荐[ Android Https相关完全解析当OkHttp遇到Https]
cookie持久化网上有很多方法，本库采用的是franmontiel / PersistentCookieJar

okhttp3取消请求
这个是比较坑的网上传统的okhttpclicent.cancle(tag)方法发现没有了，只可以通过call.cancle来取消请求，后来发现是这样子根据tag来取消请求的，当然如果请求已经开始回调无法结束，正在上传或者下载时会产生IOException

  //隊列中的call
  for (Call call : getInstance().dispatcher().queuedCalls()) {
      if (object.equals(call.request().tag())) {
          call.cancel();
      }
  }
  //運行中的call
  for (Call call : getInstance().dispatcher().runningCalls()) {
      if (object.equals(call.request().tag())) {
          call.cancel();
      }
  }

最后

好像没什么了，感觉有帮助的帮忙点个star，辣眼睛了的我也没办法

啦啦啦啦.gif

OkHttp3 - 从零开始的详细使用到简单封装

Github地址---MyOkhttpUtils

初衷

本文中库的简单使用介绍

okhttp本身的基本使用

最后