一、简介
该库是封装了okhttp的标准RESTful风格的网络框架,可以与RxJava完美结合,比Retrofit更简单易用。支持大文件上传下载,上传进度回调,下载进度回调,表单上传(多文件和多参数一起上传),链式调用,可以自定义返回对象,支持Https和自签名证书,支持超时自动重连,支持cookie与session的自动管理,支持四种缓存模式缓存网络数据,支持301、302重定向,扩展了统一的上传管理和下载管理功能。
二、添加依赖
//默认添加okhttp3.4.1、okio1.9.0
compile 'com.lzy.net:okgo:2.1.4'
三、解锁技能
进行全局配置,一般在 Aplication,或者基类的onCreate方法中,只需要调用一次即可,可以配置调试开关,全局的超时时间,公共的请求头和请求参数等信息。如果在Aplication中初始化,需要在清单文件中注册 Aplication。
//---------这里给出的是示例代码,告诉你可以这么传,实际使用的时候,根据需要传,不需要就不传-------------// HttpHeaders headers = new HttpHeaders(); headers.put("commonHeaderKey1", "commonHeaderValue1"); //header不支持中文 headers.put("commonHeaderKey2", "commonHeaderValue2"); HttpParams params = new HttpParams(); params.put("commonParamsKey1", "commonParamsValue1"); //param支持中文,直接传,不要自己编码 params.put("commonParamsKey2", "这里支持中文参数"); //-----------------------------------------------------------------------------------// //必须调用初始化 OkGo.init(this); //以下设置的所有参数是全局参数,同样的参数可以在请求的时候再设置一遍,那么对于该请求来讲,请求中的参数会覆盖全局参数 //好处是全局参数统一,特定请求可以特别定制参数 try { //以下都不是必须的,根据需要自行选择,一般来说只需要 debug,缓存相关,cookie相关的 就可以了 OkGo.getInstance() // 打开该调试开关,打印级别INFO,并不是异常,是为了显眼,不需要就不要加入该行 // 最后的true表示是否打印okgo的内部异常,一般打开方便调试错误 .debug("OkGo", Level.INFO, true) //如果使用默认的 60秒,以下三行也不需要传 .setConnectTimeout(OkGo.DEFAULT_MILLISECONDS) //全局的连接超时时间 .setReadTimeOut(OkGo.DEFAULT_MILLISECONDS) //全局的读取超时时间 .setWriteTimeOut(OkGo.DEFAULT_MILLISECONDS) //全局的写入超时时间 //可以全局统一设置缓存模式,默认是不使用缓存,可以不传,具体其他模式看 github 介绍 https://github.com/jeasonlzy/ .setCac