标签：neu 编码 多个参数 升级 多文件 type 抛出异常 这一 eclipse
该项目参考了以下项目：
在此特别感谢上述作者，喜欢原作的可以去使用原项目。同时欢迎大家下载体验本项目，如果使用过程中遇到什么问题，欢迎反馈。
- 为了方便大家使用，更加通俗的理解 http 的网络协议，建议做网络请求的时候，对每个请求抓包后查看请求信息和响应信息。
- 如果是 Windows 操作系统，可以使用
Fiddler对手机的请求进行抓包查看。- 如果是 Mac OS 操作系统，可以使用
Charles对手机的请求进行抓包查看。- 具体的下载地址和抓包配置方法，我这就不提供了，请自行百度或谷歌。
对于 Eclipse 不能运行项目的，提供了 apk 供直接运行
本项目 Demo 的网络请求是我自己的服务器，有时候可能不稳定，网速比较慢时请耐心等待。。
以下是最新版本的版本号，如果你想使用以前的版本，请点击这里，历史版本。
compile ‘com.lzy.net:okgo:2.1.4‘ //可以单独使用，不需要依赖下方的扩展包
compile ‘com.lzy.net:okrx:0.1.2‘ //RxJava 扩展支持，根据需要添加
compile ‘com.lzy.net:okserver:1.1.3‘ //下载管理和上传管理扩展，根据需要添加
或者
compile ‘com.lzy.net:okgo:+‘ //版本号使用 + 可以自动引用最新版
compile ‘com.lzy.net:okrx:+‘ //版本号使用 + 可以自动引用最新版
compile ‘com.lzy.net:okserver:+‘ //版本号使用 + 可以自动引用最新版
/jar 目录下的: ```java okhttp-3.4.1.jar //okhttp 官方包 （必须导） okio-1.9.0.jar //okio 官方包（必须导） okgo-2.1.4.jar //okgo 基本功能包（必须导）okrx-0.1.2.jar //okrx 扩展支持包，想用 rxjava 调用的必须要导（同时还需要 rxjava 的 jar，自行下载，不提供） okserver-1.1.3.jar //okserver 扩展支持包，使用下载管理必须要
* 如果是以 jar 包的形式引入`okserver`,需要在清单文件中额外注册一个服务
```java
<service android:name="com.lzy.okserver.download.DownloadService"/>
okgo的 jar,没有使用okserver的 jar,那么不需要注册上面的服务okgo使用的okhttp的版本是最新的 3.4.1 版本，和以前的 2.x 的版本可能会存在冲突。okrx是基于RxJava和RxAndroid的扩展,如果不需要可以不必引入okserver是对okgo的扩展，统一了下载管理和上传管理，对项目有需要做统一下载的可以考虑使用该扩展，不需要的可以直接使用okgo即可。javaBean必须实现Serializable接口，否者会报NotSerializableException。cacheKey，默认是用 url 带参数的全路径名为cacheKey。OkGo.init(this);。/storage/emulated/0/download，下载路径和下载数量都可以在代码中配置Post, Put, Delete, Options 这四种请求,不支持Get, Head一般在 Aplication，或者基类中，只需要调用一次即可，可以配置调试开关，全局的超时时间，公共的请求头和请求参数等信息
@Override
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);
//以下设置的所有参数是全局参数,同样的参数可以在请求的时候再设置一遍,那么对于该请求来讲,请求中的参数会覆盖全局参数
//好处是全局参数统一,特定请求可以特别定制参数
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/
.setCacheMode(CacheMode.NO_CACHE)
//可以全局统一设置缓存时间,默认永不过期,具体使用方法看 github 介绍
.setCacheTime(CacheEntity.CACHE_NEVER_EXPIRE)
//可以全局统一设置超时重连次数,默认为三次,那么最差的情况会请求 4 次(一次原始请求,三次重连请求),不需要可以设置为 0
.setRetryCount(3)
//如果不想让框架管理 cookie（或者叫 session 的保持）,以下不需要
// .setCookieStore(new MemoryCookieStore()) //cookie 使用内存缓存（app 退出后，cookie 消失）
.setCookieStore(new PersistentCookieStore()) //cookie 持久化存储，如果 cookie 不过期，则一直有效
//可以设置 https 的证书,以下几种方案根据需要自己设置
.setCertificates() //方法一：信任所有证书,不安全有风险
// .setCertificates(new SafeTrustManager()) //方法二：自定义信任规则，校验服务端证书
// .setCertificates(getAssets().open("srca.cer")) //方法三：使用预埋证书，校验服务端证书（自签名证书）
// //方法四：使用 bks 证书和密码管理客户端证书（双向认证），使用预埋证书，校验服务端证书（自签名证书）
// .setCertificates(getAssets().open("xxx.bks"), "123456", getAssets().open("yyy.cer"))//
//配置 https 的域名匹配规则，详细看 demo 的初始化介绍，不需要就不要加入，使用不当会导致 https 握手失败
// .setHostnameVerifier(new SafeHostnameVerifier())
//可以添加全局拦截器，不需要就不要加入，错误写法直接导致任何回调不执行
// .addInterceptor(new Interceptor() {
// @Override
// public Response intercept(Chain chain) throws IOException {
// return chain.proceed(chain.request());
// }
// })
//这两行同上，不需要就不要加入
.addCommonHeaders(headers) //设置全局公共头
.addCommonParams(params); //设置全局公共参数
} catch (Exception e) {
e.printStackTrace();
}
}
callback回调默认只需要复写onSuccess,并不代表所有的回调都只走这一个,实际开发中,错误回调并没有成功回调使用频繁,所以callback的失败回调onError并没有声明为抽象的,如果有需要,请自行复写,不要再问我为什么回调没有执行啊,既然onSuccess没有执行,那么一定是出错了回调了onErrorcallback 一共有以下 10 个回调,除onSuccess必须实现以外,其余均可以按需实现,每个方法参数详细说明,请看下面第 6 点:
网络请求成功 onBefore -> convertSuccess -> onSuccess -> onAfter
网络请求失败 onBefore -> parseError -> onError -> onAfter
网络请求成功,服务端返回非 304 onBefore -> convertSuccess -> onSuccess -> onAfter
网络请求成功服务端返回 304 onBefore -> onCacheSuccess -> onAfter
网络请求失败 onBefore -> parseError -> onError -> onAfter
网络请求成功,不读取缓存 onBefore -> convertSuccess -> onSuccess -> onAfter
网络请求失败,读取缓存成功 onBefore -> parseError -> onError -> onCacheSuccess -> onAfter
网络请求失败,读取缓存失败 onBefore -> parseError -> onError -> onCacheError -> onAfter
已经有缓存,不请求网络 onBefore -> onCacheSuccess -> onAfter
没有缓存请求网络成功 onBefore -> onCacheError -> convertSuccess -> onSuccess -> onAfter
没有缓存请求网络失败 onBefore -> onCacheError -> parseError -> onError -> onAfter
无缓存时,网络请求成功 onBefore -> onCacheError -> convertSuccess -> onSuccess -> onAfter
无缓存时,网络请求失败 onBefore -> onCacheError -> parseError -> onError -> onAfter
有缓存时,网络请求成功 onBefore -> onCacheSuccess -> convertSuccess -> onSuccess -> onAfter
有缓存时,网络请求失败 onBefore -> onCacheSuccess -> parseError -> onError -> onAfter
OkGo.get(Urls.URL_METHOD) // 请求方式和请求 url
.tag(this) // 请求的 tag, 主要用于取消对应的请求
.cacheKey("cacheKey") // 设置当前请求的缓存 key,建议每个不同功能的请求设置一个
.cacheMode(CacheMode.DEFAULT) // 缓存模式，详细请看缓存介绍
.execute(new StringCallback() {
@Override
public void onSuccess(String s, Call call, Response response) {
// s 即为所需要的结果
}
});
OkGo.get(Urls.URL_IMAGE)//
.tag(this)//
.execute(new BitmapCallback() {
@Override
public void onSuccess(Bitmap bitmap, Call call, Response response) {
// bitmap 即为返回的图片数据
}
});
FileCallback具有三个重载的构造方法,分别是
FileCallback():空参构造FileCallback(String destFileName):可以额外指定文件下载完成后的文件名FileCallback(String destFileDir, String destFileName):可以额外指定文件的下载目录和下载完成后的文件名
文件目录如果不指定,默认下载的目录为 sdcard/download/,文件名如果不指定,则按照以下规则命名:
1.首先检查用户是否传入了文件名,如果传入,将以用户传入的文件名命名
2.如果没有传入,那么将会检查服务端返回的响应头是否含有Content-Disposition=attachment;filename=FileName.txt该种形式的响应头,如果有,则按照该响应头中指定的文件名命名文件,如FileName.txt
3.如果上述响应头不存在,则检查下载的文件 url,例如:http://image.baidu.com/abc.jpg,那么将会自动以abc.jpg命名文件
4.如果 url 也把文件名解析不出来,那么最终将以nofilename命名文件
OkGo.get(Urls.URL_DOWNLOAD)//
.tag(this)//
.execute(new FileCallback() { //文件下载时，可以指定下载的文件目录和文件名
@Override
public void onSuccess(File file, Call call, Response response) {
// file 即为文件数据，文件保存在指定目录
}
@Override
public void downloadProgress(long currentSize, long totalSize, float progress, long networkSpeed) {
//这里回调下载进度(该回调在主线程,可以直接更新 ui)
}
});
一般此种用法用于与服务器约定的数据格式，当使用该方法时，params 中的参数设置是无效的，所有参数均需要通过需要上传的文本中指定，此外，额外指定的 header 参数仍然保持有效。
默认会携带以下请求头
Content-Type: text/plain;charset=utf-8
如果你对请求头有自己的要求，可以使用这个重载的形式，传入自定义的content-type
upString("这是要上传的长文本数据！", MediaType.parse("application/xml")) // 比如上传 xml 数据，这里就可以自己指定请求头
OkGo.post(Urls.URL_TEXT_UPLOAD)//
.tag(this)//
// .params("param1", "paramValue1")// 这里不要使用 params，upString 与 params 是互斥的，只有 upString 的???据会被上传
.upString("这是要上传的长文本数据！")//
// .upString("这是要上传的长文本数据！", MediaType.parse("application/xml")) // 比如上传 xml 数据，这里就可以自己指定请求头
.execute(new StringCallback() {
@Override
public void onSuccess(String s, Call call, Response response) {
//上传成功
}
@Override
public void upProgress(long currentSize, long totalSize, float progress, long networkSpeed) {
//这里回调上传进度(该回调在主线程,可以直接更新 ui)
}
});
该方法与 postString 没有本质区别，只是数据格式是 json,一般来说，需要自己创建一个实体 bean 或者一个 map，把需要的参数设置进去，然后通过三方的 Gson 或者 fastjson 转换成 json 字符串，最后直接使用该方法提交到服务器。
默认会携带以下请求头，请不要手动修改，okgo 也不支持自己修改
Content-Type: application/json;charset=utf-8
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)//
// .params("param1", "paramValue1")// 这里不要使用 params，upJson 与 params 是互斥的，只有 upJson 的数据会被上传
.upJson(jsonObject.toString())//
.execute(new StringCallback() {
@Override
public void onSuccess(String s, Call call, Response response) {
//上传成功
}
@Override
public void upProgress(long currentSize, long totalSize, float progress, long networkSpeed) {
//这里回调上传进度(该回调在主线程,可以直接更新 ui)
}
});
上传文件支持文件与参数一起同时上传，也支持一个 key 上传多个文件，以下方式可以任选
特别要注意的是
Content-Type修改掉，变成multipart/form-data，就像下面这样的。其实在使用 OkGo 的时候，只要你添加了文件，这里的的Content-Type不需要你手动设置，OkGo 自动添加该请求头，同时，OkGo 也不允许你修改该请求头。Content-Type: multipart/form-data; boundary=f6b76bad-0345-4337-b7d8-b362cb1f9949
Content-Type: application/x-www-form-urlencoded
multipart/form-data请求，那么可以使用.isMultipart(true)这个方法强制修改，一般来说是不需要强制的。OkGo.post(URL_FORM_UPLOAD)//
.tag(this)//
.isMultipart(true) // 强制使用 multipart/form-data 表单上传（只是演示，不需要的话不要设置。默认就是 false）
.params("param1", "paramValue1") // 这里可以上传参数
.params("file1", new File("filepath1")) // 可以添加文件上传
.params("file2", new File("filepath2")) // 支持多文件同时添加上传
.addFileParams("key", List<File> files) // 这里支持一个 key 传多个文件
.execute(new StringCallback() {
@Override
public void onSuccess(String s, Call call, Response response) {
//上传成功
}
@Override
public void upProgress(long currentSize, long totalSize, float progress, long networkSpeed) {
//这里回调上传进度(该回调在主线程,可以直接更新 ui)
}
});
OkGo.getInstance()
...
//可以设置 https 的证书,以下几种方案根据需要自己设置
.setCertificates() //方法一：信任所有证书,不安全有风险
// .setCertificates(new SafeTrustManager()) //方法二：自定义信任规则，校验服务端证书
// .setCertificates(getAssets().open("srca.cer")) //方法三：使用预埋证书，校验服务端证书（自签名证书）
//方法四：使用 bks 证书和密码管理客户端证书（双向认证），使用预埋证书，校验服务端证书（自签名证书）
// .setCertificates(getAssets().open("xxx.bks"), "123456", getAssets().open("yyy.cer"))//
//配置 https 的域名匹配规则，详细看 demo 的初始化介绍，不需要就不要加入，使用不当会导致 https 握手失败
// .setHostnameVerifier(new SafeHostnameVerifier())
...
以下代码包含了以下内容：
params添加参数的时候,最后一个isReplace为可选参数,默认为true,即代表相同key的时候,后添加的会覆盖先前添加的OkGo.post(Urls.URL_METHOD) // 请求方式和请求 url, get 请求不需要拼接参数，支持 get，post，put，delete，head，options 请求
.tag(this) // 请求的 tag, 主要用于取消对应的请求
.isMultipart(true) // 强制使用 multipart/form-data 表单上传（只是演示，不需要的话不要设置。默认就是 false）
.connTimeOut(10000) // 设置当前请求的连接超时时间
.readTimeOut(10000) // 设置当前请求的读取超时时间
.writeTimeOut(10000) // 设置当前请求的写入超时时间
.cacheKey("cacheKey") // 设置当前请求的缓存 key,建议每个不同功能的请求设置一个
.cacheTime(5000) // 缓存的过期时间,单位毫秒
.cacheMode(CacheMode.FIRST_CACHE_THEN_REQUEST) // 缓存模式，详细请看第四部分，缓存介绍
.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 传多个文件
//这里给出的泛型为 ServerModel，同时传递一个泛型的 class 对象，即可自动将数据结果转成对象返回
.execute(new DialogCallback<ServerModel>(this) {
@Override
public void onBefore(BaseRequest request) {
// UI 线程 请求网络之前调用
// 可以显示对话框，添加/修改/移除 请求参数
}
@Override
public ServerModel convertSuccess(Response response) throws Exception{
// 子线程，可以做耗时操作
// 根据传递进来的 response 对象，把数据解析成需要的 ServerModel 类型并返回
// 可以根据自己的需要，抛出异常，在 onError 中处理
return null;
}
@Override
public void parseError(Call call, IOException e) {
// 子线程，可以做耗时操作
// 用于网络错误时在子线程中执行数据耗时操作,子类可以根据自己的需要重写此方法
}
@Override
public void onSuccess(ServerModel serverModel, Call call, Response response) {
// UI 线程，请求成功后回调
// ServerModel 返回泛型约定的实体类型参数
// call 本次网络的请求信息，如果需要查看请求头或请求参数可以从此对象获取
// response 本次网络访问的结果对象，包含了响应头，响应码等
}
@Override
public void onCacheSuccess(ServerModel serverModel, Call call) {
// UI 线程，缓存读取成功后回调
// serverModel 返回泛型约定的实体类型参数
// call 本次网络的请求信息
}
@Override
public void onError(Call call, Response response, Exception e) {
// UI 线程，请求失败后回调
// call 本次网络的请求对象，可以根据该对象拿到 request
// response 本次网络访问的结果对象，包含了响应头，响应码等
// e 本次网络访问的异常信息，如果服务器内部发生了错误，响应码为 404,或大于等于 500
}
@Override
public void onCacheError(Call call, Exception e) {
// UI 线程，读取缓存失败后回调
// call 本次网络的请求对象，可以根据该对象拿到 request
// e 本次网络访问的异常信息，如果服务器内部发生了错误，响应码为 404,或大于等于 500
}
@Override
public void onAfter(ServerModel serverModel, Exception e) {
// UI 线程，请求结束后回调，无论网络请求成功还是失败，都会调用，可以用于关闭显示对话框
// ServerModel 返回泛型约定的实体类型参数，如果网络请求失败，该对象为 null
// e 本次网络访问的异常信息，如果服务器内部发生了错误，响应码为 404,或大于等于 500
}
@Override
public void upProgress(long currentSize, long totalSize, float progress, long networkSpeed) {
// UI 线程，文件上传过程中回调，只有请求方式包含请求体才回调（GET,HEAD 不会回调）
// currentSize 当前上传的大小（单位字节）
// totalSize 需要上传的总大小（单位字节）
// progress 当前上传的进度，范围 0.0f ~ 1.0f
// networkSpeed 当前上传的网速（单位秒）
}
@Override
public void downloadProgress(long currentSize, long totalSize, float progress, long networkSpeed) {
// UI 线程，文件下载过程中回调
//参数含义同 上传相同
}
});
每个请求前都设置了一个参数tag，取消则通过OkGo.cancel(tag)执行。 例如：在 Activity 中，当 Activity 销毁取消请求，可以在 onDestory 里面统一取消。
@Override
protected void onDestroy() {
super.onDestroy();
//根据 Tag 取消请求
OkGo.getInstance().cancelTag(this);
//取消所有请求
OkGo.getInstance().cancelAll();
}
execute 方法不传入 callback 即为同步的请求，返回Response对象，需要自己解析
Response response = OkGo.get("http://www.baidu.com")//
.tag(this)//
.headers("aaa", "111")//
.params("bbb", "222")
.execute();
添加 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> {
@Override
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
目前内部提供的包含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，如果相同，会导致数据覆盖。首先科普概念，具体来说 cookie 机制采用的是在客户端保持状态的方案，而 session 机制采用的是在服务器端保持状态的方案。同时我们也看到，由于采用服务器端保持状态的方案在客户端也需要保存一个标识，所以 session 机制是需要借助于 cookie 机制来达到保存标识的目的，所谓 session 保持会话，对于客户端来说，就是 cookie 的自动管理。
cookie 的内容主要包括：名字，值，过期时间，路径和域。路径与域一起构成 cookie 的作用范围。若不设置过期时间，则表示这个 cookie 的生命期为浏览器会话期间，关闭浏览器窗口，cookie 就消失。这种生命期为浏览器会话期的 cookie 被称为会话 cookie。会话 cookie 一般不存储在硬盘上而是保存在内存里，若设置了过期时间，浏览器就会把 cookie 保存到硬盘上，关闭后再次打开浏览器，这些 cookie 仍然有效直到超过设定的过期时间。存储在硬盘上的 cookie 可以在不同的浏览器进程间共享，比如两个 IE 窗口。而对于保存在内存里的 cookie，不同的浏览器有不同的处理方式。
session 机制。session 机制是一种服务器端的机制，服务器使用一种类似于散列表的结构（也可能就是使用散列表）来保存信息。当程序需要为某个客户端的请求创建一个 session 时，服务器首先检查这个客户端的请求里是否已包含了一个 session 标识（称为 sessionId，也就是请求头是否有 cookie），如果已包含则说明以前已经为此客户端创建过 session，服务器就按照 sessionId 把这个 session 检索出来使用（检索不到，会新建一个），如果客户端请求不包含 sessionId（也就是不携带 cookie 的请求头），则为此客户端创建一个 session 并且生成一个与此 session 相关联的 sessionId，sessionId 的值应该是一个既不会重复，又不容易被找到规律以仿造的字符串，这个 sessionId 将被在本次响应中通过 set-cookie 响应头返回给客户端保存。客户端检查到这个响应头后，根据需要就会保存这个 sessionId，下次在请求交互过程中便可以自动的按照规则把这个标识发送给服务器。这样就完成了 session 的保持。
对于 okgo 来说，okgo 完全遵循了 http 协议，所以，如果你的服务端的 session 是按照 set-cookie 头返回给客户端，并且希望在下次请求的时候自动带上这个 cookie 值，那么你只需要在 okgo 初始化的时候添加这么一行代码：
OkGo.getInstance()
...
//如果不想让框架管理 cookie（或者叫 session 的保持）,以下不需要
.setCookieStore(new MemoryCookieStore()) //cookie 使用内存缓存（app 退出后，cookie 消失）
.setCookieStore(new PersistentCookieStore()) //cookie 持久化存储，如果 cookie 不过期，则一直有效
...
以上方式任选其一就可以了。
如果你需要与 webview 交互，okgo 需要向 webview 传递 cookie，或者 webview 需要向 okgo 传递 cookie，那么这时候就需要手动介入到 okgo 的 cookie 管理中，使用方法依然极其简单。
查看 url 所对应的 cookie
//一般手动取出 cookie 的目的只是交给 webview 等等，非必要情况不要自己操作
CookieStore cookieStore = OkGo.getInstance().getCookieJar().getCookieStore();
HttpUrl httpUrl = HttpUrl.parse("http://server.jeasonlzy.com/OkHttpUtils/method/");
List<Cookie> cookies = cookieStore.getCookie(httpUrl);
showToast(httpUrl.host() + "对应的 cookie 如下：" + cookies.toString());
查看 okgo 管理的所有 cookie
//一般手动取出 cookie 的目的只是交给 webview 等等，非必要情况不要自己操作
CookieStore cookieStore = OkGo.getInstance().getCookieJar().getCookieStore();
List<Cookie> allCookie = cookieStore.getAllCookie();
showToast("所有 cookie 如下：" + allCookie.toString());
手动添加 cookie
HttpUrl httpUrl = HttpUrl.parse("http://server.jeasonlzy.com/OkHttpUtils/method/");
Cookie.Builder builder = new Cookie.Builder();
Cookie cookie = builder.name("myCookieKey1").value("myCookieValue1").domain(httpUrl.host()).build();
CookieStore cookieStore = OkGo.getInstance().getCookieJar().getCookieStore();
cookieStore.saveCookie(httpUrl, cookie);
手动移除 cookie
HttpUrl httpUrl = HttpUrl.parse("http://server.jeasonlzy.com/OkHttpUtils/method/");
CookieStore cookieStore = OkGo.getInstance().getCookieJar().getCookieStore();
cookieStore.removeCookie(httpUrl);
okgo, okrx, okserver 所有代码均可以混淆,但是由于底层使用的是 okhttp,它不能混淆,所以只需要添加以下混淆代码就可以了
#okhttp
-dontwarn okhttp3.**
-keep class okhttp3.**{*;}
#okio
-dontwarn okio.**
-keep class okio.**{*;}
当然如果你确实不需要混淆 okgo 的代码,可以继续添加以下代码
#okgo
-dontwarn com.lzy.okgo.**
-keep class com.lzy.okgo.**{*;}
#okrx
-dontwarn com.lzy.okrx.**
-keep class com.lzy.okrx.**{*;}
#okserver
-dontwarn com.lzy.okserver.**
-keep class com.lzy.okserver.**{*;}OkHttpUtils-2.0.0 升级后改名 OkGo，全新完美支持 RxJava，比 Retrofit 更简单易用。
标签：neu 编码 多个参数 升级 多文件 type 抛出异常 这一 eclipse
原文地址：http://blog.csdn.net/u014608640/article/details/68487395
