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

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
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,839评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,543评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,116评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,371评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,384评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,111评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,416评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,053评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,558评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,007评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,117评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,756评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,324评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,315评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,539评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,578评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,877评论 2 345

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,600评论 18 139
  • 适配器模式上一篇文章我们已经分析了Retrofit解析注解封装进ServiceMethod的流程,读者在这里要记住...
    andcoder阅读 644评论 0 2
  • 这篇文章主要总结Android著名网络框架-okhttp的基础使用。 okhttp是什么 okhttp是Andro...
    磨砺营IT阅读 721评论 0 1
  • 这篇文章主要讲 Android 网络请求时所使用到的各个请求库的关系,以及 OkHttp3 的介绍。(如理解有误,...
    小庄bb阅读 1,145评论 0 4
  • 李笑来的书里讲到一个“既勤奋又懒惰”的例子,说是他的学生宁愿把书里的英语作文范例全部背下来也不愿意自己思考。仔细想...
    龙姑姑阅读 516评论 8 2