该项目是根据：https://github.com/hongyangAndroid/okhttp-utils 和 https://github.com/pengjianbo/OkHttpFinal 和 https://github.com/wyouflf/xUtils 修改而成，喜欢原作的可以去使用。同时欢迎大家下载体验本项目，如果使用过程中遇到什么问题，欢迎反馈。
使用前，对于Android Studio的用户，可以选择添加:
compile 'com.lzy.net:okhttputils:0.1.1' //可以单独使用，不需要依赖下方的扩展包
compile 'com.lzy.net:okhttpserver:0.1.0' //扩展了下载管理和上传管理，根据需要添加或者使用
compile project(':okhttputils')
compile project(':okhttpserver')其中的图片选择是我的另一个开源项目，完全仿微信的图片选择库，自带 矩形图片裁剪 和 圆形图片裁剪 功能，有需要的可以去下载使用，附上地址：https://github.com/jeasonlzy0216/ImagePicker
okhttputils使用的okhttp的版本是最新的3.2版本，和以前的2.x的版本可能会存在冲突，并且整合了Gson，提供了自定Callback，可以按照泛型，自行解析返回结果，以下是该库的依赖项目：
compile 'com.android.support:support-annotations:23.1.1'
compile 'com.squareup.okhttp3:okhttp:3.2.0'
compile 'com.google.code.gson:gson:2.5'okhttpserver是对okhttputils的扩展，统一了下载管理和上传管理，对项目有需要做统一下载的可以考虑使用该项目，不需要的可以直接使用okhttputils，不用导入扩展，以下是okhttpserver的依赖关系：
compile 'com.lzy.net:okhttputils:0.1.1'
compile 'com.j256.ormlite:ormlite-android:4.48'- 一般的get,post,put,delete,head,patch请求
- 基于post,put,patch的文件上传
- 多文件和多参数的表单上传
- 大文件下载和下载进度回调
- 大文件上传和上传进度回调
- 支持session的保持
- 支持链式调用
- 支持自签名网站https的访问，提供方法设置下证书就行
- 支持根据Tag取消请求
- 支持自定义泛型Callback，自动根据泛型返回对象
默认使用的是 get 请求，同时下载数量为3个，支持断点下载，断点信息使用ORMLite数据库框架保存，默认下载路径/storage/emulated/0/download，下载路径和下载数量都可以在代码中配置，下载管理使用了服务提高线程优先级，避免后台下载时被系统回收
默认使用的是 post 请求，对于需要修改为 put 请求的，只需要修改library_okhttpserver中的UploadTask第67行代码：
PostRequest postRequest = OkHttpUtils.post(mUploadInfo.getUrl());修改为
PostRequest postRequest = OkHttpUtils.put(mUploadInfo.getUrl());该上传管理为简单管理，不支持断点续传和分片上传，只是简单的将所有上传任务使用线程池进行了统一管理，默认同时上传数量为1个
- 该演示Demo中，一般请求Tab演示中，没有做任何UI上的变化，需要看详细的请求过程或是否请求成功的返回数据，自行看打印的log
- 该演示Demo中，一般请求和上传管理的服务器地址是我自己的服务器，公网不可访问，自己测试的时候，自行将请求地址改为自己的服务器接口测试，否者会报请求超时的异常
一般在 Aplication，或者基类中，只需要调用一次即可，可以配置调试开关，全局的超时时间，公共的请求头和请求参数等信息
public void onCreate() {
super.onCreate();
System.setProperty("http.proxyHost", "192.168.1.108");
System.setProperty("http.proxyPort", "8888");
OkHttpUtils.debug(true, "MyOkHttp"); //是否打开调试
try {
OkHttpUtils.getInstance()//
.setConnectTimeout(OkHttpUtils.DEFAULT_MILLISECONDS)//全局的连接超时时间
.setReadTimeOut(OkHttpUtils.DEFAULT_MILLISECONDS)//全局的读取超时时间
.setWriteTimeOut(OkHttpUtils.DEFAULT_MILLISECONDS)//全局的写入超时时间
//.setCertificates(getAssets().open("srca.cer"), getAssets().open("zhy_server.cer"))//
.setCertificates(new Buffer().writeUtf8(CER_12306).inputStream());//设置自签名网站的证书
RequestHeaders headers = new RequestHeaders();
headers.put("aaa", "111");
headers.put("bbb", "222");
OkHttpUtils.getInstance().addCommonHeader(headers); //全局公共头
RequestParams params = new RequestParams();
params.put("ccc", "333");
params.put("ddd", "444");
OkHttpUtils.getInstance().addCommonParams(params); //全局公共参数
} catch (Exception e) {
e.printStackTrace();
}
} private void getJson() {
OkHttpUtils.get("http://192.168.1.111:8080/UploadServer/ResponseJson")//
.tag(this)//
.params("ppppppp", "ppp")//
.headers("hhhhhhh", "hhh")//
.execute(new MyBeanCallBack<Bean>() {
@Override
public void onResponse(Bean bean) {
System.out.println("onResponse:" + bean);
}
});
} private void responseJson() {
OkHttpUtils.post("http://192.168.1.111:8080/UploadServer/ResponseJson")//
.tag(this)//
.params("ppppppp", "ppp")//
.headers("hhhhhhh", "hhh")//
.execute(new MyBeanCallBack<Bean>() {
@Override
public void onResponse(Bean bean) {
System.out.println("onResponse:" + bean);
}
});
}不建议这么用，该方法上传字符串会清空实体中其他所有的参数，但头信息不清除，例如本例中的 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)
private void uploadFile() {
OkHttpUtils.post("http://192.168.1.111:8080/UploadServer/UploadFile")//
.tag(this)//
.headers("aaa", "111")
.headers("bbb", "222")
.params("ccc", "333")
.params("ddd", "444")
.params("file1", new File(Environment.getExternalStorageDirectory() + "/DCIM/Camera/IMG_20151225_155549.jpg"))//
.params("file2", new File(Environment.getExternalStorageDirectory() + "/DCIM/Camera/IMG_20160109_010308.jpg"))//
.params("file3", new File(Environment.getExternalStorageDirectory() + "/video/splash.avi"))//
.execute(new MyBeanCallBack<String>() {
@Override
public void onResponse(String s) {
System.out.println("onResponse:" + s);
}
});
}其中文件的key，相当于表单中<input type="file" name="File1"/>的name属性。
OkHttpUtils.get("http://192.168.1.111:8080/UploadServer/DownloadFile")//
.tag(this)//
.params("ppppppp", "ppp")//
.headers("hhhhhhh", "hhh")//
.execute(new MyFileCallBack(Environment.getExternalStorageDirectory() + "/video", "bbb.avi") {
@Override
public void onResponse(File response) {
System.out.println("onResponse:" + response);
}
});具体FileCallBack内部实现的下载进度监听，自行看代码
目前对于支持的方法都添加了最后一个参数Object tag，取消则通过 OkHttpUtils.cancel(tag)执行。
例如：在Activity中，当Activity销毁取消请求，可以在onDestory里面统一取消。
@Override
protected void onDestroy() {
super.onDestroy();
OkHttpUtils.getInstance().cancelTag(this);
}目前内部提供的包含JsonCallBack, StringCallBack, FileCallBack, BitmapCallback，可以根据自己的需求去自定义Callback
- 一般的 JavaBean
- 字符串 String
- 集合泛型
List<Bean> - 集合泛型
Map<Bean>
以下是实现代码
public abstract class JsonCallBack<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进行解析，该方法运行在子线程，所以可以进行任何耗时操作
public abstract class AbsCallback<T> {
/** Post执行上传过程中的进度回调，get请求不回调，UI线程 */
public void upProgress(long currentSize, long totalSize, float progress) {
}
/** 执行下载过程中的进度回调，UI线程 */
public void downloadProgress(long currentSize, long totalSize, float progress) {
}
}callback回调中有upProgress 和 downloadProgress 方法，直接复写即可，在 get 请求中， upProgress 方法不会执行。
Response response = OkHttpUtils.get("http://www.baidu.com")//
.tag(this)//
.headers("aaa", "111")//
.params("bbb", "222").execute();execute方法不传入callback即为同步的请求，返回Response对象，需要自己解析
比如涉及到文件的需要设置读写等待时间多一点。
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();
}