OkHttpUtils - 封装了okhttp的网络框架,目前Get,Post的请求已经完成,支持大文件上传下载,上传进度回调,下载进度回调,表单上传(多文件和多参数一起上传),链式调用,整合Gson,自动解析返回对象,支持Https和自签名证书,支持cookie自动管理,后期将要实现的功能,统一的上传管理和下载管理。该项目是根据:https://github.com/hongyangAndroid/okhttp-utils 和https://github.com/pengjianbo/OkHttpFinal 修改而成,喜欢原作的可以去使用。同时欢迎大家下载体验本项目,如果使用过程中遇到什么问题,欢迎反馈。
使用前,对于Android Studio的用户,可以选择添加:
compile project(':okhttputils') Eclipse自行copy源码。
注意
使用的okhttp的版本是最新的3.0版本,和以前的2.x的版本可能会存在冲突,整合了Gson,提供了自定Callback,可以按照泛型,自行解析返回结果:
compile 'com.android.support:support-annotations:23.1.1' compile 'com.squareup.okhttp3:okhttp:3.0.0-RC1' compile 'com.google.code.gson:gson:2.5'不建议这么用,该方法上传字符串会清空实体中其他所有的参数,但头信息不清除,例如本例中的 params 参数不会上传
private void postString() { OkHttpUtils.post("http://192.168.1.111:8080/UploadServer/UploadString")// .tag(this)// .params("ppppppp", "ppp")// .headers("hhhhhhh", "hhh")// .content("asdfasdfad这是文本这是文本aasfesr")// .mediaType(PostRequest.MEDIA_TYPE_PLAIN)// .execute(new MyBeanCallBack<String>() { @Override public void onResponse(String s) { System.out.println("onResponse:" + s); } }); }如果要上传Json,把上面的 mediaType 改为 .mediaType(PostRequest.MEDIA_TYPE_JSON)
其中文件的key,相当于表单中<input type="file" name="File1"/>的name属性。
具体FileCallBack内部实现的下载进度监听,自行看代码
目前对于支持的方法都添加了最后一个参数Object tag,取消则通过OkHttpUtils.cancel(tag)执行。
例如:在Activity中,当Activity销毁取消请求,可以在onDestory里面统一取消。
@Override protected void onDestroy() { super.onDestroy(); OkHttpUtils.getInstance().cancelTag(this); }目前内部提供的包含BeanCallBack, StringCallBack, FileCallBack, BitmapCallback,可以根据自己的需求去自定义Callback
以下是实现代码
public abstract class BeanCallBack<T> extends AbsCallback<T> { @Override public T parseNetworkResponse(Response response) throws Exception { Type type = this.getClass().getGenericSuperclass(); if (type instanceof ParameterizedType) { //如果用户写了泛型,就会进入这里,否者不会执行 ParameterizedType parameterizedType = (ParameterizedType) type; Type beanType = parameterizedType.getActualTypeArguments()[0]; if (beanType == String.class) { //如果是String类型,直接返回字符串 return (T) response.body().string(); } else { //如果是 Bean List Map ,则解析完后返回 return new Gson().fromJson(response.body().string(), beanType); } } else { //如果没有写泛型,直接返回Response对象 return (T) response; } } }通过parseNetworkResponse回调的response进行解析,该方法运行在子线程,所以可以进行任何耗时操作
callback回调中有upProgress 和 downloadProgress 方法,直接复写即可,在 get 请求中,upProgress 方法不会执行。
execute方法不传入callback即为同步的请求,返回Response对象,需要自己解析
可以在Application中,通过:
try { OkHttpUtils.debug(true, "MyOkHttp"); OkHttpUtils.getInstance()// .setConnectTimeout(OkHttpUtils.DEFAULT_MILLISECONDS)// .setReadTimeOut(OkHttpUtils.DEFAULT_MILLISECONDS)// .setCertificates(new Buffer().writeUtf8(CER_12306).inputStream())// .setWriteTimeOut(OkHttpUtils.DEFAULT_MILLISECONDS); } catch (Exception e) { e.printStackTrace(); }然后调用 OkHttpUtils 的各种set方法。
比如涉及到文件的需要设置读写等待时间多一点。
private void responseJsonArray() { OkHttpUtils.post("http://192.168.1.111:8080/UploadServer/ResponseJsonArray")// .tag(this)// .connTimeOut(2000) .writeTimeOut(3000) .readTimeOut(4000) .params("ppppppp", "ppp")// .headers("hhhhhhh", "hhh")// .execute(new MyBeanCallBack<List<Bean>>() { @Override public void onResponse(List<Bean> beans) { System.out.println("onResponse:" + beans); } }); }非常简单,拿到xxx.cert的证书,然后调用
OkHttpUtils.getInstance().setCertificates(inputstream);建议使用方式,例如我的证书放在assets目录:
try { OkHttpUtils.getInstance() .setCertificates(getAssets().open("srca.cer"), getAssets().open("aaa.cer"))// } catch (Exception e) { e.printStackTrace(); }项目地址: https://github.com/jeasonlzy0216/OkHttpUtils