2018 年高薪帮内推：&&&+&&&okhttp-OkGo Project Url:
Introduction: OkHttpUtils-2.0.0 升级后改名 OkGo，全新完美支持 RxJava，比 Retrofit 更简单易用。该库是封装了 okhttp 的网络框架，支持大文件上传下载，上传进度回调，下载进度回调，表单上传（多文件和多参数一起上传），链式调用，可以自定义返回对象，支持 Https 和自签名证书，支持 cookie 的持久化和自动管理，支持四种缓存模式缓存网络数据，支持 301 和 302 重定向，扩展了统一的上传管理和下载管理功能 More: &&&&&& Tags:
工程结构全新优化支持 RxJava支持 RxJava2支持自定义缓存策略支持下载管理支持上传管理
该库部分思想借鉴了以下项目：
在此特别感谢上述作者，喜欢原作的可以去使用原项目。同时欢迎大家下载体验本项目，如果使用过程中遇到什么问题，欢迎反馈。
本项目中使用的图片选择是我的另一个开源项目
完全仿微信的图片选择库，自带矩形图片裁剪和圆形图片裁剪功能，有需要的可以去下载使用。附上地址：
本项目中的九宫格控件也是我的开源项目
类似 QQ 空间，微信朋友圈，微博主页等，展示图片的九宫格控件，自动根据图片的数量确定图片大小和控件大小，使用 Adapter 模式设置图片，对外提供接口回调，使用接口加载图片，支持任意的图片加载框架如：Glide、ImageLoader、xUtils3、Picasso 等，支持点击图片全屏预览大图。附上地址：
（点击图标，可以直接加入，建议使用 QQ 群，邮箱使用较少，可能看的不及时）
如果遇到问题欢迎在群里提问，个人能力也有限，希望一起学习一起进步。
[v3.1.x]版本
计划分离 params 参数的具体作用，分为 paramsPath，paramsQuery 和 params，支持 url 路径动态替换
计划支持请求优先级，方便有些重要请求优先进行
计划支持自定义线程池，使用自己的线程池管理网络请求
[v3.2.x]版本
计划增加扩展库 OkAnno，作用是让 okgo 支持注解方式请求，具体写法与 Retrofit 相似，但是更简单方便，也更强大，方便 Retrofit 用户平滑过渡到 OkGo
其他功能暂时还没想出来，大家有想法的可以积极加群讨论，或者直接在 issue 里面提出你的想法，我会第一时间回复。
Android Studio 用户
一般来说，只需要添加第一个 okgo 的核心包即可，其余的三个库根据自己的需要选择添加！！！
//必须使用
compile 'com.lzy.net:okgo:3.0.4'
//以下三个选择添加，okrx 和 okrx2 不能同时使用
compile 'com.lzy.net:okrx:1.0.2'
compile 'com.lzy.net:okrx2:2.0.2'
compile 'com.lzy.net:okserver:2.0.5'
Eclipse 的用户(赶紧换 AS 吧)，可以选择添加本项目根目录中 /jar 目录下的 jar 包:
一般来说，至少需要 okhttp、okio、okgo 三个 jar 包，其余的三个扩展 jar 包根据自己的需要选择添加！！！
以下三个选择添加，okrx 和 okrx2 不能同时使用
该项目的文档全部以 Wiki 的形式展示，wiki 文档永远与最新版本的库保持同步，如果你发现文档的说明与你的写法不一样，那么请升级到最新版本，重要的事情说三遍
如果你实在不愿意升级到 3.x 版本，，注意：老版本库的问题将不在维护，所有 bug 会在最新版本修复，所以建议跟随最新版本的库。
如果遇到使用问题，解决办法如下：
看上述文档中是否有相关描述
看别人提的 issues 是否有你的问题，这里面有很多人的提问，。
如果你感觉是 bug，或者有疑问，也欢迎在 issues 里面提问，我每天都会认真解答，。
还有疑问，加入联系方式中的 QQ 群，大家一起讨论。
如果你不想编译项目，提供了 apk 供直接运行，方便查看效果，点击图标下载：
本项目 Demo 使用的是我自己的服务器，有时候可能不稳定，网速比较慢时请耐心等待，尴尬呀。。
如果你想查看历史版本信息，请点击图标：
如果你使用遇到了问题，首先请看控制台 log，如果 log 无法看出问题，无法确定是该库的 bug 还是服务端的问题，建议抓包查看网络数据，
如果你觉得好，对你有过帮助，请给我一点打赏鼓励吧，一分也是爱呀！
okgo, okrx, okrx2, okserver 所有代码均可以混淆,但是由于底层使用的是 okhttp,它不能混淆,所以只需要添加以下混淆代码就可以了
-dontwarn okhttp3.**
-keep class okhttp3.**{*;}
-dontwarn okio.**
-keep class okio.**{*;}
当然如果你确实不需要混淆 okgo 的代码,可以继续添加以下代码
-dontwarn com.lzy.okgo.**
-keep class com.lzy.okgo.**{*;}
-dontwarn com.lzy.okrx.**
-keep class com.lzy.okrx.**{*;}
-dontwarn com.lzy.okrx2.**
-keep class com.lzy.okrx2.**{*;}
-dontwarn com.lzy.okserver.**
-keep class com.lzy.okserver.**{*;}
Copyright 2016 jeasonlzy(廖子尧)
Licensed under the Apache License, Version 2.0 (the &License&);
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an &AS IS& BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
loading Support MePaypal:
About MeGoogle+: GitHub: Blog:接口的使用—对OKGO最简单的在封装
项目常常用的第三方的网络请求框架，很多时候都想把人家的框架进行简单的再封装，这个时候就涉及到了接口的使用。对一些不会用接口的童鞋来说，这是非常痛苦的，那些会用的就不用看了。实现只需要三步（没错，干什么都只需要三步）。
第一步，定义自己的接口，相信百分之百的人都会。
public interface MyHttpUtilsInterface {
void onStart(BaseRequest request);
void onSuccess(String s, Call call, Response response);
void onError(Call call, Response response, Exception e);
void onAfter(String s, Exception e);
会用okgo的童鞋相信都知道这些方法的作用。onSuccess()方法请求成功的时候调用，onError()请求失败的时候调用，onStart()在请求失败或者请求成功之前调用，onAfter()在请求失败或者请求成功之后调用。我们与用户交互的diaolog就可以在onStart()方法里面show，在onAfter()方法里面dismiss。这里需要传的参数，我是根据okgo回调方法里面能获取到的参数定义的，你可以自己需要什么参数，自己定义。也可以不传。
第二步，网络请求类。
package com.example.wz.myapplication.
import android.app.ProgressD
import android.content.C
import com.example.wz.myapplication.Interface.MyHttpUtilsI
import com.lzy.okgo.OkGo;
import com.lzy.okgo.callback.StringC
import com.lzy.okgo.request.BaseR
import okhttp3.C
import okhttp3.R
* 这里我只写了一个获取ip请求的方法.还有其他一系列的请求都在这个类里面
* 写对应的方法调用
public class MyHttpUtils {
private MyHttpUtilsInterface httpUtilsI
private ProgressDialog progressD
public MyHttpUtils(Context context) {
this.context =
public void ipUtils(final MyHttpUtilsInterface httpUtilsInterface){
this.httpUtilsInterface = httpUtilsI
String url = "http://ip.taobao.com/service/getIpInfo2.php";
OkGo.post(url).params("ip", "myip").execute(new StringCallback() {
public void onBefore(BaseRequest request) {
super.onBefore(request);
progressDialog = new ProgressDialog(context);
progressDialog.show();
httpUtilsInterface.onStart(request);
public void onSuccess(String s, Call call, Response response) {
httpUtilsInterface.onSuccess(s,call,response);
public void onAfter(String s, Exception e) {
super.onAfter(s, e);
httpUtilsInterface.onAfter(s,e);
progressDialog.dismiss();
public void onError(Call call, Response response, Exception e) {
super.onError(call, response, e);
httpUtilsInterface.onError(call, response, e);
第三步，在类中使用。
MyHttpUtils myHttpUtils = new MyHttpUtils(this);
myHttpUtils.ipUtils(new MyHttpUtilsInterface() {
public void onStart(BaseRequest request) {
Toast.makeText(MainActivity.this, request.toString(), Toast.LENGTH_SHORT).show();
public void onSuccess(String s, Call call, Response response) {
Toast.makeText(MainActivity.this, s, Toast.LENGTH_SHORT).show();
public void onAfter(String s, Exception e) {
Toast.makeText(MainActivity.this, s, Toast.LENGTH_SHORT).show();
public void onError(Call call, Response response, Exception e) {
Toast.makeText(MainActivity.this, response.toString(), Toast.LENGTH_SHORT).show();
没有更多推荐了，
加入CSDN，享受更精准的内容推荐，与500万程序员共同成长！OkGo，一个专注于让网络请求更简单的框架，与RxJava完美结合，比Retrofit更简单易用。 - 简书
OkGo，一个专注于让网络请求更简单的框架，与RxJava完美结合，比Retrofit更简单易用。
OkGo - OkHttpUtils-2.0.0升级后改名 OkGo,全新完美支持RxJava
项目地址：，欢迎star，欢迎issue
该库是封装了okhttp的网络框架，可以与RxJava完美结合，比Retrofit更简单易用。支持大文件上传下载，上传进度回调，下载进度回调，表单上传（多文件和多参数一起上传），链式调用，可以自定义返回对象，支持Https和自签名证书，支持cookie自动管理，支持四种缓存模式缓存网络数据，支持301、302重定向，扩展了统一的上传管理和下载管理功能
其中Demo中用到的图片选择是我的另一个开源项目，完全仿微信的图片选择库，自带 矩形图片裁剪 和 圆形图片裁剪 功能，有需要的可以去下载使用，附上地址：
其中的九宫格控件也是我的开源项目,类似QQ空间，微信朋友圈，微博主页等，展示图片的九宫格控件，自动根据图片的数量确定图片大小和控件大小，使用Adapter模式设置图片，对外提供接口回调，使用接口加载图片,支持任意的图片加载框架,如 Glide,ImageLoader,Fresco,xUtils3,Picasso 等，支持点击图片全屏预览大图。附上地址：
项目Github开源地址：
联系方式：QQ群（）
如果你想直接运行apk看效果，点击这里下载：
以下是该项目相关文章的传送门：
OkGo结合RxJava使用的扩展项目：
OkGo2.0版本以前的前身OkHttpUtils介绍：
如何选择网络框架
说了这么多功能，我们来看看为什么要使用OkGo这个框架。
首先目前主流的几个网络框架
android-async-http
在此引用知乎上Stay Zhang的回答：
我们来先说一个常识性的错误：volley, retrofit, android-async-http 帮你封装了具体的请求，线程切换以及数据转换。而OkHttp 是基于http协议封装的一套请求客户端，虽然它也可以开线程，但根本上它更偏向真正的请求，跟HttpClient, HttpUrlConnection的职责是一样的。
所以不要混淆。
-----以下纯个人主观见解
首先，我想即使你单纯使用OkHttp，还是会再包一层的，这样就等价于Volley之流的框架，只是封装的好与坏而已。
android-async-http内部实现是基于HttpClient, 想必你肯定知道6.0之后HttpClient是不是系统自带的了，不过它在最近的更新中将HttpClient的所有代码copy了一份进来，所以还能使用。
Volley是官方出的，volley在设计的时候是将具体的请求客户端做了下封装：HurlStack，也就是说可以支持HttpUrlConnection, HttpClient, OkHttp，相当于模版模式吧，这样解耦还是非常方便的，可以随意切换，如果你之前使用过Volley，并习惯使用，那直接写个OkHttp扩展就行了。
Retrofit因为也是square出的，所以大家可能对它更崇拜些。Retrofit的跟Volley是一个套路，但解耦的更彻底:比方说通过注解来配置请求参数，通过工厂来生成CallAdapter，Converter，你可以使用不同的请求适配器(CallAdapter), 比方说RxJava，Java8, Guava。你可以使用不同的反序列化工具(Converter)，比方说json, protobuff, xml, moshi等等。然而目前OkGo已经完全可以替代Retrofit，同样支持RxJava，但具有更强的灵活性和易用性。
OkGo的优势
优势一：性能高，专注于简单易用的网络请求，使用主流的okhttp进行封装，对于okhttp大家都知道，在Android4.4的源码中可以看到HttpURLConnection已经替换成OkHttp实现了，并且支持HTTP2/SPDY黑科技，支持socket自动选择最好路线，并支持自动重连，拥有自动维护的socket连接池，减少握手次数，拥有队列线程池，轻松写并发。
优势二：特有的网络缓存模式，是大多数网络框架所不具备的，说一个应用场景，老板说我们的app不仅需要在有网的情况下展示最新的网络数据，还要在没网的情况下使用缓存数据，这时候是不是项目中出现了大量的代码判断当前网络状况，根据不同的状态保存不同的数据，然后决定是否使用缓存。细想一下，这是个通用的写法，于是OkGo提供了五种缓存模式，让你不用关心缓存的实现，而专注于数据的处理。（具体缓存的使用方法请看最后第四章节）。
优势三：方便易用的扩展接口，可以添加全局的公共参数，全局拦截器，全局超时时间，更可以对单个请求定制拦截器，超时时间，请求参数修改等等，在使用上更是方便，原生支持的链式调用让你的请求更加清晰。
优势四：强大的Cookie保持策略，我们知道在客户端对cookie的获取是个不太简单的事情，特别是还要处理cookie的过期时间，持久化策略等等，OkGo帮你彻底解决Cookie的难题，默认拥有内存存储和持久化存储两种实现，cookie全程自动管理，并且提供了额外的addCookie方式，允许介入到自动管理的过程中，添加你想创建的任何cookie。
所以就说这么多啦，选最适合项目的，选大多数人选择的，选简单易用的，选择使用流行技术的，就这么个标准，而OkGo正是在这种情况下诞生啦！！
为了方便大家使用，更加通俗的理解http的网络协议，建议做网络请求的时候，对每个请求抓包后查看请求信息和响应信息。
如果是 Windows 操作系统，可以使用 Fiddler 对手机的请求进行抓包查看。
如果是 Mac OS
操作系统，可以使用 Charles 对手机的请求进行抓包查看。
具体的下载地址和抓包配置方法，我这就不提供了，请自行百度或谷歌。
对于Eclipse不能运行项目的，提供了apk供直接运行
或者点击下载Demo
本项目Demo的网络请求是我自己的服务器，有时候可能不稳定，网速比较慢时请耐心等待。。
以下是最新版本的版本号，如果你想使用以前的版本，请点击这里，。
对于Android Studio的用户，可以选择添加:
compile 'com.lzy.net:okgo:2.0.0'
//可以单独使用，不需要依赖下方的扩展包
compile 'com.lzy.net:okrx:0.1.0'
//RxJava扩展支持，根据需要添加
compile 'com.lzy.net:okserver:1.1.0'
//下载管理和上传管理扩展，根据需要添加
compile 'com.lzy.net:okgo:+'
//版本号使用 + 可以自动引用最新版
compile 'com.lzy.net:okrx:+'
//版本号使用 + 可以自动引用最新版
compile 'com.lzy.net:okserver:+'
//版本号使用 + 可以自动引用最新版
对于Eclipse的用户，可以选择添加 /jar 目录下的:
okgo-2.0.0.jar
okrx-0.1.0.jar
okserver-1.1.0.jar
如果是以jar包的形式引入okserver,需要在清单文件中额外注册一个服务
&service android:name="com.lzy.okserver.download.DownloadService"/&
如果只是用了okgo的jar,没有使用okserver的jar,那么不需要注册上面的服务
2.使用注意事项
okgo使用的okhttp的版本是最新的 3.4.1 版本，和以前的 2.x 的版本可能会存在冲突。
okrx是基于RxJava和RxAndroid的扩展,如果不需要可以不必引入
okserver是对okgo的扩展，统一了下载管理和上传管理，对项目有需要做统一下载的可以考虑使用该扩展，不需要的可以直接使用okgo即可。
对于缓存模式使用，需要与返回对象相关的所有javaBean必须实现Serializable接口，否者会报NotSerializableException。
使用缓存时，如果不指定cacheKey，默认是用url带参数的全路径名为cacheKey。
使用该网络框架时，必须要在 Application 中做初始化 OkGo.init(this);。
3.OkGo 目前支持
一般的 get,post,put,delete,head,options请求
基于Post的大文本数据上传
多文件和多参数统一的表单上传
支持一个key上传一个文件，也可以一个Key上传多个文件
大文件下载和下载进度回调
大文件上传和上传进度回调
支持cookie的内存存储和持久化存储，支持传递自定义cookie
支持304缓存协议，扩展四种本地缓存模式,并且支持缓存时间控制
支持301、302重定向
支持链式调用
支持可信证书和自签名证书的https的访问,支持双向认证
支持根据Tag取消请求
支持自定义泛型Callback，自动根据泛型返回对象
4.OkRx 扩展功能
详细使用方法点击这里:
完美结合RxJava
比Retrofit更简单方便
网络请求和RxJava调用,一条链点到底
支持Json数据的自动解析转换
OkGo包含的所有请求功能,OkRx全部支持
5.OkServer 扩展功能
5.1 统一的文件下载管理(DownloadManager)：
结合OkGo的request进行网络请求,支持与OkGo保持相同的全局公共参数,同时支持请求传递参数
支持断点下载，支持突然断网,强杀进程后,断点依然有效
支持 下载 暂停 等待 停止 出错 完成 六种下载状态
所有下载任务按照taskKey区分,切记不同的任务必须使用不一样的key,否者断点会发生覆盖
相同的下载url地址如果使用不一样的taskKey,也会认为是两个下载任务
默认同时下载数量为3个，默认下载路径/storage/emulated/0/download，下载路径和下载数量都可以在代码中配置
下载文件名可以自己定义,也可以不传,框架自动解析响应头或者url地址获得文件名,如果都没获取到,使用default作为文件名
下载管理使用了服务提高线程优先级，避免后台下载时被系统回收
5.2 统一的文件上传管理(UploadManager)
结合OkGo的request进行网络请求,支持与OkGo保持相同的全局公共参数,同时支持请求传递参数
上传只能使用Post, Put, Delete, Options 这四种请求,不支持Get, Head
该上传管理为简单管理，不支持断点续传或分片上传，只是简单的将所有上传任务使用线程池进行了统一管理
默认同时上传数量为1个,该数列可以在代码中配置修改
一、全局配置
一般在 Aplication，或者基类中，只需要调用一次即可，可以配置调试开关，全局的超时时间，公共的请求头和请求参数等信息
public void onCreate() {
super.onCreate();
//---------这里给出的是示例代码,告诉你可以这么传,实际使用的时候,根据需要传,不需要就不传-------------//
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);
//以下设置的所有参数是全局参数,同样的参数可以在请求的时候再设置一遍,那么对于该请求来讲,请求中的参数会覆盖全局参数
//好处是全局参数统一,特定请求可以特别定制参数
//以下都不是必须的，根据需要自行选择,一般来说只需要 debug,缓存相关,cookie相关的 就可以了
OkGo.getInstance()
//打开该调试开关,控制台会使用 红色error 级别打印log,并不是错误,是为了显眼,不需要就不要加入该行
.debug("OkGo")
//如果使用默认的 60秒,以下三行也不需要传
.setConnectTimeout(OkGo.DEFAULT_MILLISECONDS)
//全局的连接超时时间
.setReadTimeOut(OkGo.DEFAULT_MILLISECONDS)
//全局的读取超时时间
.setWriteTimeOut(OkGo.DEFAULT_MILLISECONDS)
//全局的写入超时时间
//可以全局统一设置缓存模式,默认是不使用缓存,可以不传,具体其他模式看 github 介绍 https://github.com/jeasonlzy/
.setCacheMode(CacheMode.NO_CACHE)
//可以全局统一设置缓存时间,默认永不过期,具体使用方法看 github 介绍
.setCacheTime(CacheEntity.CACHE_NEVER_EXPIRE)
//如果不想让框架管理cookie,以下不需要
.setCookieStore(new MemoryCookieStore())
//cookie使用内存缓存（app退出后，cookie消失）
.setCookieStore(new PersistentCookieStore())
//cookie持久化存储，如果cookie不过期，则一直有效
//可以设置https的证书,以下几种方案根据需要自己设置,不需要不用设置
.setCertificates()
//方法一：信任所有证书
.setCertificates(getAssets().open("srca.cer"))
//方法二：也可以自己设置https证书
.setCertificates(getAssets().open("aaaa.bks"), "123456", getAssets().open("srca.cer"))//方法三：传入bks证书,密码,和cer证书,支持双向加密
//可以添加全局拦截器,不会用的千万不要传,错误写法直接导致任何回调不执行
.addInterceptor(new Interceptor() {
public Response intercept(Chain chain) throws IOException {
return chain.proceed(chain.request());
//这两行同上,不需要就不要传
.addCommonHeaders(headers)
//设置全局公共头
.addCommonParams(params);
//设置全局公共参数
} catch (Exception e) {
e.printStackTrace();
二、普通请求
0.写在开始的话,callback回调默认只需要复写onSuccess,并不代表所有的回调都只走这一个,实际开发中,错误回调并没有成功回调使用频繁,所以callback的失败回调onError并没有声明为抽象的,如果有需要,请自行复写,不要再问我为什么回调没有执行啊,既然onSuccess没有执行,那么一定是出错了回调了onError
callback一共有以下 10 个回调,除onSuccess必须实现以外,其余均可以按需实现,每个方法参数详细说明,请看下面第6点:
convertSuccess():解析网络返回的数据回调
parseError():解析网络失败的数据回调
onBefore():网络请求真正执行前回调
onSuccess():网络请求成功的回调
onCacheSuccess():缓存读取成功的回调
onError():网络请求失败的回调
onCacheError():网络缓存读取失败的回调
onAfter():网络请求结束的回调,无论成功失败一定会执行
upProgress():上传进度的回调
downloadProgress():下载进度的回调
Callback回调具有如下顺序,虽然顺序写的很复杂,但是理解后,是很简单,并且合情合理的
1).无缓存模式 CacheMode.NO_CACHE
网络请求成功
onBefore -& convertSuccess -& onSuccess -& onAfter
网络请求失败
onBefore -& parseError
-& onError
-& onAfter
2).默认缓存模式,遵循304头 CacheMode.DEFAULT
网络请求成功,服务端返回非304
onBefore -& convertSuccess -& onSuccess -& onAfter
网络请求成功服务端返回304
onBefore -& onCacheSuccess
-& onAfter
网络请求失败
onBefore -& parseError
-& onError
-& onAfter
3).请求网络失败后读取缓存 CacheMode.REQUEST_FAILED_READ_CACHE
网络请求成功,不读取缓存
onBefore -& convertSuccess -& onSuccess -& onAfter
网络请求失败,读取缓存成功
onBefore -& parseError -& onError -& onCacheSuccess -& onAfter
网络请求失败,读取缓存失败
onBefore -& parseError -& onError -& onCacheError
-& onAfter
4).如果缓存不存在才请求网络，否则使用缓存 CacheMode.IF_NONE_CACHE_REQUEST
已经有缓存,不请求网络
onBefore -& onCacheSuccess -& onAfter
没有缓存请求网络成功
onBefore -& onCacheError
-& convertSuccess -& onSuccess -& onAfter
没有缓存请求网络失败
onBefore -& onCacheError
-& parseError
-& onError
-& onAfter
5).先使用缓存，不管是否存在，仍然请求网络 CacheMode.FIRST_CACHE_THEN_REQUEST
无缓存时,网络请求成功
onBefore -& onCacheError
-& convertSuccess -& onSuccess -& onAfter
无缓存时,网络请求失败
onBefore -& onCacheError
-& parseError
-& onError
-& onAfter
有缓存时,网络请求成功
onBefore -& onCacheSuccess -& convertSuccess -& onSuccess -& onAfter
有缓存时,网络请求失败
onBefore -& onCacheSuccess -& parseError
-& onError
-& onAfter
1.基本的网络请求
OkGo.get(Urls.URL_METHOD)
// 请求方式和请求url
.tag(this)
// 请求的 tag, 主要用于取消对应的请求
.cacheKey("cacheKey")
// 设置当前请求的缓存key,建议每个不同功能的请求设置一个
.cacheMode(CacheMode.DEFAULT)
// 缓存模式，详细请看缓存介绍
.execute(new StringCallback() {
public void onSuccess(String s, Call call, Response response) {
// s 即为所需要的结果
2.请求 Bitmap 对象
OkGo.get(Urls.URL_IMAGE)//
.tag(this)//
.execute(new BitmapCallback() {
public void onSuccess(Bitmap bitmap, Call call, Response response) {
// bitmap 即为返回的图片数据
3.请求 文件下载
OkGo.get(Urls.URL_DOWNLOAD)//
.tag(this)//
.execute(new FileCallback("file.jpg") {
//文件下载时，需要指定下载的文件目录和文件名
public void onSuccess(File file, Call call, Response response) {
// file 即为文件数据，文件保存在指定目录
public void downloadProgress(long currentSize, long totalSize, float progress, long networkSpeed) {
//这里回调下载进度(该回调在主线程,可以直接更新ui)
4.普通Post，直接上传String类型的文本
一般此种用法用于与服务器约定的数据格式，当使用该方法时，params中的参数设置是无效的，所有参数均需要通过需要上传的文本中指定，此外，额外指定的header参数仍然保持有效。
OkGo.post(Urls.URL_TEXT_UPLOAD)//
.tag(this)//
.upString("这是要上传的长文本数据！")//
.execute(new StringCallback() {
public void onSuccess(String s, Call call, Response response) {
//上传成功
public void upProgress(long currentSize, long totalSize, float progress, long networkSpeed) {
//这里回调上传进度(该回调在主线程,可以直接更新ui)
5.普通Post，直接上传Json类型的文本
该方法与postString没有本质区别，只是数据格式是json,一般来说，需要自己创建一个实体bean或者一个map，把需要的参数设置进去，然后通过三方的Gson或者fastjson转换成json字符串，最后直接使用该方法提交到服务器。
HashMap&String, String& params = new HashMap&&();
params.put("key1", "value1");
params.put("key2", "这里是需要提交的json格式数据");
params.put("key3", "也可以使用三方工具将对象转成json字符串");
params.put("key4", "其实你怎么高兴怎么写都行");
JSONObject jsonObject = new JSONObject(params);
OkGo.post(Urls.URL_TEXT_UPLOAD)//
.tag(this)//
.upJson(jsonObject.toString())//
.execute(new StringCallback() {
public void onSuccess(String s, Call call, Response response) {
//上传成功
public void upProgress(long currentSize, long totalSize, float progress, long networkSpeed) {
//这里回调上传进度(该回调在主线程,可以直接更新ui)
6.https请求(证书可以在全局初始化的时候设置,不用每次请求设置一遍)
OkGo.get("https://kyfw.12306.cn/otn")//
.tag(this)//
.headers("Connection", "close")
//如果对于部分自签名的https访问不成功，需要加上该控制头
.headers("header1", "headerValue1")//
.params("param1", "paramValue1")//
.setCertificates()
//方法一：信任所有证书
.setCertificates(getAssets().open("srca.cer")) //方法二：也可以设置https证书
//方法三：传入bks证书,密码,和cer证书,支持双向加密
.setCertificates(getAssets().open("aaaa.bks"), "123456", getAssets().open("srca.cer"))
.execute(new HttpsCallBack(this));
7.请求功能的所有配置讲解
以下代码包含了以下内容：
一次普通请求所有能配置的参数，真实使用时不需要配置这么多，按自己的需要选择性的使用即可
params添加参数的时候,最后一个isReplace为可选参数,默认为true,即代表相同key的时候,后添加的会覆盖先前添加的
多文件和多参数的表单上传，同时支持进度监听
自签名网站https的访问，调用setCertificates方法即可
为单个请求设置超时，比如涉及到文件的需要设置读写等待时间多一点。
Cookie一般情况下只需要在初始化的时候调用setCookieStore即可实现cookie的自动管理，如果特殊业务需要，需要手动额外向服务器传递自定义的cookie，可以在每次请求的时候调用addCookie方法，该方法提供了3个重载形式，可以根据自己的需要选择使用。
OkGo.get(Urls.URL_METHOD) // 请求方式和请求url, get请求不需要拼接参数，支持get，post，put，delete，head，options请求
.tag(this)
// 请求的 tag, 主要用于取消对应的请求
.connTimeOut(10000)
// 设置当前请求的连接超时时间
.readTimeOut(10000)
// 设置当前请求的读取超时时间
.writeTimeOut(10000)
// 设置当前请求的写入超时时间
.cacheKey("cacheKey")
// 设置当前请求的缓存key,建议每个不同功能的请求设置一个
.cacheTime(5000)
// 缓存的过期时间,单位毫秒
.cacheMode(CacheMode.FIRST_CACHE_THEN_REQUEST) // 缓存模式，详细请看第四部分，缓存介绍
.setCertificates(getAssets().open("srca.cer")) // 自签名https的证书，可变参数，可以设置多个
.addInterceptor(interceptor)
// 添加自定义拦截器
.headers("header1", "headerValue1")
// 添加请求头参数
.headers("header2", "headerValue2")
// 支持多请求头参数同时添加
.params("param1", "paramValue1")
// 添加请求参数
.params("param2", "paramValue2")
// 支持多请求参数同时添加
.params("file1", new File("filepath1")) // 可以添加文件上传
.params("file2", new File("filepath2")) // 支持多文件同时添加上传
.addUrlParams("key", List&String& values) //这里支持一个key传多个参数
.addFileParams("key", List&File& files) //这里支持一个key传多个文件
.addFileWrapperParams("key", List&HttpParams.FileWrapper& fileWrappers)//这里支持一个key传多个文件
.addCookie("aaa", "bbb")
// 这里可以传递自己想传的Cookie
.addCookie(cookie)
// 可以自己构建cookie
.addCookies(cookies)
// 可以一次传递批量的cookie
//这里给出的泛型为 ServerModel，同时传递一个泛型的 class对象，即可自动将数据结果转成对象返回
.execute(new DialogCallback&ServerModel&(this) {
public void onBefore(BaseRequest request) {
// UI线程 请求网络之前调用
// 可以显示对话框，添加/修改/移除 请求参数
public ServerModel convertSuccess(Response response) throws Exception{
// 子线程，可以做耗时操作
// 根据传递进来的 response 对象，把数据解析成需要的 ServerModel 类型并返回
// 可以根据自己的需要，抛出异常，在onError中处理
public void parseError(Call call, IOException e) {
// 子线程，可以做耗时操作
// 用于网络错误时在子线程中执行数据耗时操作,子类可以根据自己的需要重写此方法
public void onSuccess(ServerModel serverModel, Call call, Response response) {
// UI 线程，请求成功后回调
// ServerModel 返回泛型约定的实体类型参数
本次网络的请求信息，如果需要查看请求头或请求参数可以从此对象获取
// response
本次网络访问的结果对象，包含了响应头，响应码等
public void onCacheSuccess(ServerModel serverModel, Call call) {
// UI 线程，缓存读取成功后回调
// serverModel 返回泛型约定的实体类型参数
本次网络的请求信息
public void onError(Call call, Response response, Exception e) {
// UI 线程，请求失败后回调
本次网络的请求对象，可以根据该对象拿到 request
// response
本次网络访问的结果对象，包含了响应头，响应码等
本次网络访问的异常信息，如果服务器内部发生了错误，响应码为 404,或大于等于500
public void onCacheError(Call call, Exception e) {
// UI 线程，读取缓存失败后回调
本次网络的请求对象，可以根据该对象拿到 request
本次网络访问的异常信息，如果服务器内部发生了错误，响应码为 404,或大于等于500
public void onAfter(ServerModel serverModel, Exception e) {
// UI 线程，请求结束后回调，无论网络请求成功还是失败，都会调用，可以用于关闭显示对话框
// ServerModel 返回泛型约定的实体类型参数，如果网络请求失败，该对象为　null
本次网络访问的异常信息，如果服务器内部发生了错误，响应码为 404,或大于等于500
public void upProgress(long currentSize, long totalSize, float progress, long networkSpeed) {
// UI 线程，文件上传过程中回调，只有请求方式包含请求体才回调（GET,HEAD不会回调）
// currentSize
当前上传的大小（单位字节）
// totalSize 　 需要上传的总大小（单位字节）
// progress
当前上传的进度，范围　0.0f ~ 1.0f
// networkSpeed 当前上传的网速（单位秒）
public void downloadProgress(long currentSize, long totalSize, float progress, long networkSpeed) {
// UI 线程，文件下载过程中回调
//参数含义同　上传相同
8.取消请求
每个请求前都设置了一个参数tag，取消则通过OkGo.cancel(tag)执行。
例如：在Activity中，当Activity销毁取消请求，可以在onDestory里面统一取消。
protected void onDestroy() {
super.onDestroy();
//根据 Tag 取消请求
OkGo.getInstance().cancelTag(this);
9.同步的请求
execute方法不传入callback即为同步的请求，返回Response对象，需要自己解析
Response response = OkGo.get("http://www.baidu.com")//
.tag(this)//
.headers("aaa", "111")//
.params("bbb", "222")
.execute();
10.参数的顺序
添加header和param的方法各有三个地方,在提交的时候,他们是有顺序的,如果对提交顺序有需要的话,请注意这里
第一个地方,全局初始化时,使用OkGo.getInstance().addCommonHeaders(),OkGo.getInstance().addCommonParams() 添加
HttpHeaders headers = new HttpHeaders();
headers.put("HKAAA", "HVAAA");
headers.put("HKBBB", "HVBBB");
HttpParams params = new HttpParams();
params.put("PKAAA", "PVAAA");
params.put("PKBBB", "PVBBB");
OkGo.getInstance()
.addCommonHeaders(headers) //设置全局公共头
.addCommonParams(params);
//设置全局公共参数
第二个地方,callback的onBefore方法中添加
public abstract class CommonCallback&T& extends AbsCallback&T& {
public void onBefore(BaseRequest request) {
super.onBefore(request);
request.headers("HKCCC", "HVCCC")//
.headers("HKDDD", "HVDDD")//
.params("PKCCC", "PVCCC")//
.params("PKDDD", "PVDDD")//
第三个地方,执行网络请求的时候添加
OkGo.get(Urls.URL_METHOD)//
.tag(this)//
.headers("HKEEE", "HVEEE")//
.headers("HKFFF", "HVFFF")//
.params("PKEEE", "PVEEE")//
.params("PKFFF", "PVFFF")//
.execute(new MethodCallBack&&(this, ServerModel.class));
那么,最终执行请求的参数的添加顺序为
Header顺序: HKAAA -& HKBBB -& HKEEE -& HKFFF -& HKCCC -& HKDDD
Params顺序: PKAAA -& PKBBB -& PKEEE -& PKFFF -& PKCCC -& PKDDD
总结一句话就是,全局添加的在最开始,callback添加的在最后,请求添加的在中间
三、自定义CallBack使用
目前内部提供的包含AbsCallback, StringCallBack ,BitmapCallback ,FileCallBack ,可以根据自己的需求去自定义Callback
AbsCallback: 所有回调的父类，抽象类
StringCallBack：如果返回值类型是纯文本数据，即可使用该回调
BitmapCallback：如果请求的是图片数据，则可以使用该回调
FileCallBack：如果要做文件下载，则必须使用该回调，内部封装了关于文件下载进度回调的方法
该网络框架的核心使用方法即为Callback的继承使用，详细请看 Demo 源码中callback包下的代码。
因为不同的项目需求，可能对数据格式进行了不同的封装，于是在 Demo 中的进行了详细的代码示例，以下是详细介绍：
JsonCallback：继承自AbsCallback,一般来说，服务器返回的响应码都包含 code，msg，data 三部分，在此根据自己的业务需要完成相应的逻辑判断，并对数据进行解析，可以使用 Gson 或者 fastjson，将解析的对象返回。
DialogCallback：继承自JsonCallback,对需要在网络请求的时候显示对话框，使用该回调。
StringDialogCallback：继承自EncryptCallback,如果网络返回的数据只是纯文本，使用该回调
BitmapDialogCallback ：继承自BitmapCallback,如果网络返回的是Bitmap对象，使用该回调
DownloadFileCallBack ：继承自FileCallback,如果需要做文件下载，使用该回调
以上基本是包含了大部分的业务逻辑，具体情况请参照demo示例，根据业务需求修改！
四、缓存的使用
使用缓存前，必须让缓存的数据javaBean对象实现Serializable接口，否者会报NotSerializableException。
因为缓存的原理是将对象序列化后直接写入 数据库中，如果不实现Serializable接口，会导致对象无法序列化，进而无法写入到数据库中，也就达不到缓存的效果。
对于DEFAULT缓存模式,超时时间是无效的,因为该模式是完全遵循标准的http协议的,缓存时间是依靠服务端响应头来控制,所以客户端的cacheTime参数无效
目前提供了五种CacheMode缓存模式,每种缓存模式都可以指定对应的CacheTime,不同的模式会有不同的方法回调顺序,详细请看上面第二部分的callback执行顺序
NO_CACHE: 不使用缓存,该模式下,cacheKey,cacheTime 参数均无效
DEFAULT: 按照HTTP协议的默认缓存规则，例如有304响应头时缓存。
REQUEST_FAILED_READ_CACHE：先请求网络，如果请求网络失败，则读取缓存，如果读取缓存失败，本次请求失败。
IF_NONE_CACHE_REQUEST：如果缓存不存在才请求网络，否则使用缓存。
FIRST_CACHE_THEN_REQUEST：先使用缓存，不管是否存在，仍然请求网络。
无论对于哪种缓存模式，都可以指定一个cacheKey，建议针对不同需要缓存的页面设置不同的cacheKey，如果相同，会导致数据覆盖。
-dontwarn com.lzy.okgo.**
-keep class com.lzy.okgo.**{*;}
-dontwarn com.lzy.okrx.**
-keep class com.lzy.okrx.**{*;}
-dontwarn com.lzy.okserver.**
-keep class com.lzy.okserver.**{*;}
-dontwarn okhttp3.**
-keep class okhttp3.**{*;}
-dontwarn okio.**
-keep class okio.**{*;}
如果你觉得好或者给你带来了方便，请打赏一下给作者买杯咖啡喝吧。
欢迎访问我的github地址：https://github.com/jeasonlzy?tab=repositories
github源码地址：https://github.com/zhou-you/RxEasyHttp RxEasyHttp 本库是一款基于RxJava2+Retrofit2实现简单易用的网络请求框架，结合android平台特性的网络封装库,采用api链式调用一点到底,集成co...
一句话概括，OkHttpUtils一个专注于让网络请求更简单的网络请求框架，对于任何形式的网络请求只需要一行代码。 项目地址：https://github.com/jeasonlzy/okhttp-OkGo 联系方式：QQ群（） 如果你想直接运行apk看效...
OkGo - Rx扩展，可以方便的和RxJava联用,如果你熟悉Retrofit,那么这个框架和Retrofit使用方式很像。 以下是该项目相关文章的传送门： OkGo主项目详细使用方法：OkGo，一个专注于让网络请求更简单的框架，与RxJava完美结合，比Retrofit...
Xutils3.0技术分享1.这个技术分享的目的1.首先要让大家了解Xutil3.0是什么Xtuils3.0的前身是Xutils,是两年前就很火的一个开源框架，包含了很多实用的Android开发工具，支持大文件的上传以及下载，更加全面的Http请求协议支持（Get,Post...
X399平台点睛之笔ZENITHEXTREME引爆性能狂潮 近期，X399平台的顶级性能浮出水面，各家媒体的全方位测试犹如一支强心剂，让PC玩家大呼过瘾。我们惊喜地发现，国内外各大科技媒体一致选用了ROGZENITH EXTREME这款主板。它是华硕目前最顶级的X399芯片...
天色以晚，暮色降临，灯光下昏黄的夜色拉长了他的身影，他独步向前，不曾停留的向前走，忽然，他回头说了句：“别再跟着我。”短短的几个字，说出了他的决绝，自此，再无踪迹。
夜里，辗转反侧，夜不能寐。
他们手拉手走在一起，路过那座桥，她带他回了家，家里面所有人都很...
凛冽的微风中，女人踩着红色的高跟鞋，绕过 百货的转角，朝着一家“转角”咖啡店走去。女人依旧走向那个昏暗却一览无余的位置，打开椅子，女人整理好裙子坐下来，精致的脸上泛着迷离，女人的鼻子和嘴唇极其精致，女人慢悠悠点了一杯卡布基诺，女人的眼睛看着离题她不远处的13桌，桌边坐着一位...
我会永远痴笑着注视着你，即使你的枪口抵在我眉心。