NoHttp一个有情怀的框架
我们日常生活中常用的App，包括我们开发者平常的开发中，有90%以上的App都用了Http来和服务器做交互。随着Android6.0开始AndroidSDK中删除了HttpClient的相关的API，我们有必要选择一个可以兼容高低版本系统的Http框架，Google的官方文档中推荐我们使用HttpURLConnection，但是鉴于HttpURLConnection的API过于简单，并且在高低版本系统中有不同的bug，因此开发者如果使用HttpURLConnection封装的话，复杂度和工作量都不少，这就是NoHttp产生的背景。
NoHttp之所以叫NoHttp，是因为我们使用NoHttp的时候不用管Http协议的东西，NoHttp底层都自动完成了判断，开发者只需要直接调用就好。NoHttp支持傻瓜式调用，支持高级扩展，是一个从小白到大牛都可以使用的Android Http框架。
NoHttp的底层使用了HttpURLConnection来封装，有人推荐用OkHttp来封装，其实OkHttp对HttpClient和HttpURLConnection都提供了接口，从Android4.4开始HttpURLConnection的底层就是用OkHttp来实现的，现在手机大多数都是4.4以上了吧，尤其国外的更新的更快，其次也没有必要再引进okhttp和okio（okhttp依赖okio）来增大apk的体积。
NoHttp相关链接
NoHttp文档： http://doc.nohttp.net
NoHttp官网： http://www.nohttp.net
NoHttp源码： https://github.com/yanzhenjie/NoHttp
NoHttp简介
NoHttp是一个Android开源网络框架，实现了RFC2616（Http1.1）协议，一个标准的Http框架。支持普通请求、文件的上传与下载、自动维持Cookie、支持RFC2616规定的所有请求方法（POST、GET、HEAD……）、支持Https（包括访问自签名网站）、支持请求优先级、支持请求与Activity联动、提供了五种缓存策略供开发者选择……
- 请求和下载都是队列，平均分配每个线程的资源，支持多个请求并发。
- 支持GET、POST、PUT、PATCH、HEAD、DELETE、OPTIONS、TRACE等请求协议。
- 支持基于POST、PUT、PATCH、DELETE的文件上传（Html表单原理）。
- 文件下载、上传下载、上传和下载的状态回调、错误回调。
- 提供了五种数据缓存策略供开发者选择使用。
- 支持自定义Request，利用NoHttp泛型可以解析成任何数据格式（String、Json、JavaBean等）。
- 支持Session、Cookie的自动维持，App重启、关开机后还持续维持。
- 支持Https、自签名网站Https的访问、支持Https双向验证。
- 支持取消某个请求、取消指定多个请求、取消所有请求。
- 支持重定向、多级别重定向。支持代理、支持Request的优先级。
使用方法
-
Eclipse使用Jar包，如果需要依赖源码，请自行下载。
-
AndroidStudio使用Gradle构建添加依赖（推荐）
compile'com.yolanda.nohttp:nohttp:1.0.2'
友好的调试模式
NoHttp提供了调试模式，打开后可以清晰的看到请求过程、怎么传递数据等，基本不用抓包。可以看到请求头、请求数据、响应头、Cookie等的过程。你也不用担心Log太多会让你眼花缭乱，想象不到的整洁。
请求
- 支持请求String、Json、FastJson、Gson、Bitmap、JavaBean、XML等扩展。
- 异步请求，拿到结果直接更新UI，支持同步请求。
多文件上传
所有下载均有进度回调、错误回调等友好的接口。
- 大文件上传，不会发生OOM。
- 多文件上传，多个key多个文件，一个key多个文件（
List<File>）。 - 支持File、InputStream、ByteArray、Bitmap，实现NoHttp的Binary接口，理论上任何东西都可以传。
- 支持取消上传。
文件下载
- 文件下载，支持多个文件同时下载，并且有进度回调、错误回调等。
- 支持暂停继续下载，支持取消下载，支持断点续传。
- 利用NoHttp的多文件下载可以做一个下载管理器。
缓存模式
- 仅仅请求网络。
- 仅仅读取缓存。
- 标准Http协议缓存(比如响应码是304的情况)，需要服务器支持，如果服务器不支持就和普通请求一样。
- 先请求网络，请求失败后返回缓存。
- 先读取缓存，缓存不存在再请求网络。
取消请求
所有取消都支持正在执行的请求。
- 支持取消某个请求。
- 支持取消用sign指定的几个请求。
- 支持取消所有的请求。
请求自动维持Cookie
- 支持Session、Cookie、临时Cookie的位置。
- 支持App重启、关机开机后继续持久化维持。
- 提供了接口，允许开发者监听Cookie的变化，也可以改变某个Cookie的值。
重定向
- 对于Http301、302、303、307等重定向的支持。
- 支持多级重定向嵌套。
- 支持禁用重定向、NoHttp提供了操作重定向的接口。
代理
- 标准的Java的Api，ProXy：指定代理的IP和Port。
- 比如调试时代理到自己电脑进行抓包，比如用代理访问Google。
一. 请求
String请求
// String 请求对象
Request<String>request= NoHttp.createStringRequest(url,requestMethod);
Json请求
// JsonObject
Request<JSONObject>request= NoHttp.createJsonObjectRequest(url,reqeustMethod); ... // JsonArray Request<JSONArray>request= NoHttp.createJsonArrayRequest(url,reqeustMethod);
Bitmap请求
Request<Bitmap>request= NoHttp.createImageRequest(url,requestMethod);
添加参数
Request<JSONObject>request= ...
request.add("name", "yoldada");// String类型 request.add("age", 18);// int类型 request.add("sex", '0')// char类型 request.add("time", 16346468473154); // long类型 ...
添加到队列
RequestQueuerequestQueue= NoHttp.newRequestQueue();
// 或者传一个并发值，允许三个请求同时并发
// RequestQueue requestQueue = NoHttp.newRequestQueue(3); // 发起请求 requestQueue.add(what,request,responseListener);
上面添加到队列时有一个what，这个what会在 responseLisetener 响应时回调给开发者，所以我们可以用一个 responseLisetener 接受多个请求的响应，用what来区分结果。而不用像有的框架一样，每一个请求都要new一个回调。
同步请求
在当前线程发起请求，在线程这么使用。
Request<String>request= ... Response<String>response= NoHttp.startRequestSync(request); if (response.isSucceed()) { // 请求成功 } else { // 请求失败 }
二. 文件上传
支持多文件上传，多个key多个文件，一个key多个文件（ List<File> ）。支持File、InputStream、ByteArray、Bitmap，实现NoHttp的Binary接口，理论上任何东西都可以传。
单个文件
Request<String>request= ... request.add("file", new FileBinary(file));
上传多个文件、多个Key多个文件形式
这里可以添加各种形式的文件，File、Bitmap、InputStream、ByteArray：
Request<String>request= ...
request.add("file1", new FileBinary(File)); request.add("file2", new FileBinary(File)); request.add("file3", new InputStreamBinary(InputStream)); request.add("file4", new ByteArrayBinary(byte[])); request.add("file5", new BitmapStreamBinary(Bitmap));
上传多个文件、一个Key多个文件形式
用同一个key添加，如果请求方法是POST、PUT、PATCH、DELETE，同一个key不会被覆盖。
Request<String>request= ...
fileList.add("image", new FileBinary(File)); fileList.add("image", new InputStreamBinary(InputStream)); fileList.add("image", new ByteArrayBinary(byte[])); fileList.add("image", new BitmapStreamBinary(Bitmap));
或者：
Request<String>request= ... List<Binary>fileList= ... fileList.add(new FileBinary(File)); fileList.add(new InputStreamBinary(InputStream)); fileList.add(new ByteArrayBinary(byte[])); fileList.add(new BitmapStreamBinary(Bitmap)); request.add("file_list",fileList);
三. 下载文件
因为下载文件代码比较多，这里贴关键部分，具体的请参考sample。
发起下载请求
//下载文件
downloadRequest= NoHttp.createDownloadRequest...
// what 区分下载 // downloadRequest 下载请求对象 // downloadListener 下载监听 downloadQueue.add(0,downloadRequest,downloadListener);
暂停或者停止下载
downloadRequest.cancel();
监听下载过程
private DownloadListenerdownloadListener= new DownloadListener() { @Override public voidonStart(intwhat, booleanresume, longpreLenght, Headersheader, longcount) { // 下载开始 } @Override public voidonProgress(intwhat, intprogress, longdownCount) { // 更新下载进度 } @Override public voidonFinish(intwhat, StringfilePath) { // 下载完成 } @Override public voidonDownloadError(intwhat, StatusCodecode, CharSequencemessage) { // 下载发生错误 } @Override public voidonCancel(intwhat) { // 下载被取消或者暂停 } };
四. 缓存模式
1. Http标准协议的缓存，比如响应码是304时
NoHttp本身是实现了RFC2616，所以这里不用设置或者设置为DEFAULT。
Request<JSONObject>request= NoHttp.createJsonObjectRequest(url); request.setCacheMode(CacheMode.DEFAULT);
2. 当请求服务器失败的时候，读取缓存
请求服务器成功则返回服务器数据，如果请求服务器失败，读取缓存数据返回。
Request<JSONObject>request= NoHttp.createJsonObjectRequest(url); request.setCacheMode(CacheMode.REQUEST_NETWORK_FAILED_READ_CACHE);
3. 如果发现有缓存直接成功，没有缓存才请求服务器
我们知道ImageLoader的核心除了内存优化外，剩下一个就是发现把内地有图片则直接使用，没有则请求服务器，所以NoHttp这一点非常使用做一个ImageLoader。如果没有缓存才去请求服务器，否则使用缓存：
Request<JSONObject>request= NoHttp.createJsonObjectRequest(url); // 非标准Http协议，改变缓存模式为IF_NONE_CACHE_REQUEST_NETWORK request.setCacheMode(CacheMode.IF_NONE_CACHE_REQUEST_NETWORK);
请求图片，缓存图片：
Request<Bitmap>request= NoHttp.createImageRequest(imageUrl); request.setCacheMode(CacheMode.IF_NONE_CACHE_REQUEST_NETWORK);
4. 仅仅请求网络
这里不会读取缓存，也不会使用Http304：
Request<Bitmap>request= NoHttp.createImageRequest(imageUrl); request.setCacheMode(CacheMode.ONLY_REQUEST_NETWORK); ...
5. 仅仅读取缓存
如果没有缓存才去请求服务器，否则使用缓存，缓存图片演示：
Request<Bitmap>request= NoHttp.createImageRequest(imageUrl); request.setCacheMode(CacheMode.ONLY_READ_CACHE);
五. 取消请求
取消单个请求
直接调用请求对象的cancel方法。
request.cancel();
从队列中取消指定的请求
给请求set一个sign，取消的时候调用队列的cancelBySign就可以取消掉所有指定这个sign的请求。
request.setCancelSign(sign);
...
queue.cancelBySign(sign);
取消队列中所有请求
queue.cancelAll();
停止队列
队列停止后再添加请求到队列后，请求不会被执行。
RequestQueuequeue= NoHttp.newRequestQueue();
...
queue.stop();
六. 自定义请求类型: FastJsonRequest
定义请求对象
public class FastJsonRequest extends RestRequestor<JSONObject> { public FastJsonRequest(Stringurl) { super(url); } public FastJsonRequest(Stringurl, RequestMethodrequestMethod) { super(url,requestMethod); } @Override public JSONObjectparseResponse(Stringurl, Headersheaders, byte[]responseBody) { Stringresult= StringRequest.parseResponseString(url,headers,responseBody); JSONObjectjsonObject= null; if (!TextUtils.isEmpty(result)) { jsonObject=JSON.parseObject(result); } else { // 这里默认的错误可以定义为你们自己的数据格式 jsonObject=JSON.toJSON("{}"); } returnjsonObject; } @Override public StringgetAccept() { // 告诉服务器你接受什么类型的数据 return "application/json"; } }
b. 使用自定义请求-和NoHttp默认请求没有区别的哦
Request<JSONObject>mRequest= new FastJsonRequest(url,requestMethod); queue.add(what,mRequest,responseListener);
七. 混淆
需要知道的
NoHttp全部的类都可以混淆。
NoHttp1.0.0使用了leve23的api，所以打包的时候要用leve23才行。
NoHttp1.0.1使用了反射调用了高级或者低级的api，所以只要是leve9以上的sdk都可以编译。
NoHttp1.0.2同NoHttp1.0.1一样，在NoHttp1.0.1的基础上进行了优化和bug修复。是目前功能最全，最稳定的一个版本，暂时未发现bug。
如果你非要keep
-dontwarn com.yolanda.nohttp.**
-keep class com.yolanda.nohttp.**{*;}
权限
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />