一、简介
该库是封装了okhttp的标准RESTful风格的网络框架，可以与RxJava完美结合，比Retrofit更简单易用。支持大文件上传下载，上传进度回调，下载进度回调，表单上传（多文件和多参数一起上传），链式调用，可以自定义返回对象，支持Https和自签名证书，支持超时自动重连，支持cookie与session的自动管理，支持四种缓存模式缓存网络数据，支持301、302重定向，扩展了统一的上传管理和下载管理功能。
OkGo - 3.0 震撼来袭，该库是基于 Http 协议，封装了 OkHttp 的网络请求框架，比 Retrofit 更简单易用，支持 RxJava，RxJava2，支持自定义缓存，支持批量断点下载管理和批量上传管理功能
github地址：https://github.com/jeasonlzy/okhttp-OkGo
什么是304？
二、添加依赖
//默认添加okhttp3.4.1、okio1.9.0
compile 'com.lzy.net:okgo:2.1.4'
1
2
3
三、解锁技能
进行全局配置，一般在 Aplication，或者基类的onCreate方法中，只需要调用一次即可，可以配置调试开关，全局的超时时间，公共的请求头和请求参数等信息。如果在Aplication中初始化，需要在清单文件中注册 Aplication。
//---------这里给出的是示例代码,告诉你可以这么传,实际使用的时候,根据需要传,不需要就不传-------------//HttpHeaders headers =newHttpHeaders(); headers.put("commonHeaderKey1","commonHeaderValue1");//header不支持中文headers.put("commonHeaderKey2","commonHeaderValue2"); HttpParams params =newHttpParams(); 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(newPersistentCookieStore())//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(); }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
使用get请求获取数据；
/** * get请求获取数据 * @paramurl */privatevoidgetByOkGo(String url){ OkGo.get(url)// 请求方式和请求url.tag(this)// 请求的 tag, 主要用于取消对应的请求.cacheKey("cacheKey")// 设置当前请求的缓存key,建议每个不同功能的请求设置一个.cacheMode(CacheMode.DEFAULT)// 缓存模式，详细请看缓存介绍.execute(newStringCallback() {@OverridepublicvoidonSuccess(String s, Call call, Response response) { mTextView2.setText(s); } }); }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
post请求获取数据，其中params方法用来添加请求参数，params添加参数的时候,最后一个isReplace为可选参数,默认为true,即代表相同key的时候,后添加的会覆盖先前添加的；
/** * post请求 * @paramurl */privatevoidpostByOkGo(String url){ OkGo.post(url) .tag(this) .cacheKey("cachePostKey") .cacheMode(CacheMode.DEFAULT) .params("method","album.item.get") .params("appKey","myKey") .params("format","json") .params("albumId","Lqfme5hSolM") .params("pageNo","1") .params("pageSize","2") .execute(newStringCallback() {@OverridepublicvoidonSuccess(String s, Call call, Response response) { mTextView2.setText(s); }@OverridepublicvoidonError(Call call, Response response, Exception e) {super.onError(call, response, e); mTextView2.setText(e.getMessage()); } }); }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
文件下载，FileCallback具有三个重载的构造方法，文件目录如果不指定,默认下载的目录为 sdcard/download/，文件名如果不指定,则按照以下规则命名:
首先检查用户是否传入了文件名,如果传入,将以用户传入的文件名命名
如果没有传入,那么将会检查服务端返回的响应头是否含有Content-Disposition=attachment;filename=FileName.txt该种形式的响应头,如果有,则按照该响应头中指定的文件名命名文件,如FileName.txt
如果上述响应头不存在,则检查下载的文件url,例如:http://image.baidu.com/abc.jpg,那么将会自动以abc.jpg命名文件
如果url也把文件名解析不出来,那么最终将以nofilename命名文件；
/** * 下载文件 * @paramurl 下载地址 * @paramdestFileDir 保存文件路径 * @paramdestFileName 保存文件名 */privatevoiddownLoad(String url, String destFileDir, String destFileName){ OkGo.get(url)//.tag(this)//.execute(newFileCallback(destFileDir, destFileName) {//文件下载时，可以指定下载的文件目录和文件名@OverridepublicvoidonSuccess(File file, Call call, Response response) {// file 即为文件数据，文件保存在指定目录}@OverridepublicvoiddownloadProgress(longcurrentSize,longtotalSize,floatprogress,longnetworkSpeed) {//这里回调下载进度(该回调在主线程,可以直接更新ui)//currentSize totalSize以字节byte为单位} });}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
大文件上传；
/*** 多文件上传* @paramurl* @paramkeyName* @paramfiles 文件集合*/privatevoiduploadFiles(String url, String keyName, List files){ OkGo.post(url)//.tag(this)////.isMultipart(true) // 强制使用 multipart/form-data 表单上传（只是演示，不需要的话不要设置。默认就是false）//.params("param1", "paramValue1") // 这里可以上传参数//.params("file1", new File("filepath1")) // 可以添加文件上传//.params("file2", new File("filepath2")) // 支持多文件同时添加上传.addFileParams(keyName, files)// 这里支持一个key传多个文件.execute(newStringCallback() {@OverridepublicvoidonSuccess(String s, Call call, Response response) {//上传成功Toast.makeText(getApplicationContext(),"上传成功", Toast.LENGTH_SHORT).show(); }@OverridepublicvoidupProgress(longcurrentSize,longtotalSize,floatprogress,longnetworkSpeed) {//这里回调上传进度(该回调在主线程,可以直接更新ui)mProgressBar.setProgress((int) (100* progress)); mTextView2.setText("已上传"+ currentSize/1024/1024+"MB, 共"+ totalSize/1024/1024+"MB;"); } });}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
请求加载图片；
/** * 请求网络图片 * @paramurl */privatevoidgetBitmap(String url) { OkGo.get(url)//.tag(this)//.execute(newBitmapCallback() {@OverridepublicvoidonSuccess(Bitmap bitmap, Call call, Response response) {// bitmap 即为返回的图片数据mImageView.setImageBitmap(bitmap); } });}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
取消请求。每个请求前都设置了一个参数tag，取消则通过OkGo.cancel(tag)执行。 例如：在Activity中，当Activity销毁取消请求，可以在onDestory里面统一取消；
@OverrideprotectedvoidonDestroy() {super.onDestroy();//根据 Tag 取消请求OkGo.getInstance().cancelTag(this);//取消所有请求OkGo.getInstance().cancelAll();}