NoHttp的使用方式, 附加--NoHttp PK Volley对比分析!
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的优先级。
友好的调试模式
NoHttp提供了调试模式，打开后可以清晰的看到请求过程、怎么传递数据等，基本不用抓包。可以看到请求头、请求数据、响应头、Cookie等的过程。你也不用担心Log太多会让你眼花缭乱，想象不到的整洁。
请求
支持请求String、Json、FastJson、Gson、Bitmap、JavaBean、XML等扩展。
异步请求，拿到结果直接更新UI，支持同步请求。
多文件上传
所有下载均有进度回调、错误回调等友好的接口。
大文件上传，不会发生OOM。
多文件上传，多个key多个文件，一个key多个文件（ List ）。
支持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。
在本文中只介绍在Android Studio里的使用方式：
一、AndroidStudio使用Gradle构建添加依赖(推荐)
compile 'com.yolanda.nohttp:nohttp:1.0.4'或引用最新依赖
compile 'com.yolanda.nohttp: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" />NoHttp实现Http1.1(RFC2616),一个标准的Http框架。
请求和下载队列,每个线程的平均分配资源,支持多个并发请求。
支持GET、POST、PUT、补丁、头、删除选项,例如跟踪请求协议。 支持POST、PUT补丁,删除文件上传(Html表单原则)。
文件下载、上传、下载、上传和下载的进度回调,纠错。
为开发者提供了五种数据缓存策略,选择使用详细(见下文)。
支持取消的请求,指定多个请求取消,取消所有请求。
支持自定义请求,使用NoHttp泛型可以解析成任何你想要的数据格式(字符串、Json对象等)。
自动维护会话的支持,饼干,重新启动应用程序,关闭启动后也继续保持。 支持Https,签名网站Https访问,
三、请求
首先，建议自定义类继承Application后做初始化NoHttp
NoHttp.initialize(getApplication());1.String请求
// String request object
Request<String> request = NoHttp.createStringRequest(url, requestMethod);2.Json请求
// JsonObject
Request request = NoHttp.createJsonObjectRequest(url, reqeustMethod);
...
// JsonArray
Request request = NoHttp.createJsonArrayRequest(url, reqeustMethod); 3.Bitmap请求
Request request = NoHttp.createImageRequest(url, requestMethod); 4.添加参数
Requestrequest= ...
request.add("name", "yoldada");// String类型
request.add("age", 18);// int类型
request.add("sex", '0')// char类型
request.add("time", 16346468473154); // long类型
... 5.添加到队列
RequestQueuerequestQueue= NoHttp.newRequestQueue();
// 或者传一个并发值，允许三个请求同时并发
// RequestQueue requestQueue = NoHttp.newRequestQueue(3);
// 发起请求
requestQueue.add(what,request,responseListener);上面添加到队列时有一个what，这个what会在 responseLisetener 响应时回调给开发者，所以我们可以用一个 responseLisetener 接受多个请求的响应，用what来区分结果。而不用像有的框架一样，每一个请求都要new一个回调。
6.同步请求
在当前线程发起请求，在线程这么使用。
Requestrequest= ...
Responseresponse= NoHttp.startRequestSync(request);
if (response.isSucceed()) {
// 请求成功
} else {
// 请求失败
} 四、文件上传
支持多文件上传，多个key多个文件，一个key多个文件（ List ）。支持File、InputStream、ByteArray、Bitmap，实现NoHttp的Binary接口，理论上任何东西都可以传。
1.单个文件
Requestrequest= ...
request.add("file", new FileBinary(file)); 2.上传多个文件、多个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));3.上传多个文件、一个Key多个文件形式
用同一个key添加，如果请求方法是POST、PUT、PATCH、DELETE，同一个key不会被覆盖。
Requestrequest= ...
fileList.add("image", new FileBinary(File));
fileList.add("image", new InputStreamBinary(InputStream));
fileList.add("image", new ByteArrayBinary(byte[]));
fileList.add("image", new BitmapStreamBinary(Bitmap)); 或者：
Requestrequest= ...
ListfileList= ...
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。
1.发起下载请求
//下载文件
downloadRequest= NoHttp.createDownloadRequest...
// what 区分下载
// downloadRequest 下载请求对象
// downloadListener 下载监听
downloadQueue.add(0,downloadRequest,downloadListener);2.暂停或者停止下载
downloadRequest.cancel();3.监听下载过程
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。
Requestrequest= NoHttp.createJsonObjectRequest(url);
request.setCacheMode(CacheMode.DEFAULT); 2.当请求服务器失败的时候，读取缓存
请求服务器成功则返回服务器数据，如果请求服务器失败，读取缓存数据返回。
Requestrequest= NoHttp.createJsonObjectRequest(url);
request.setCacheMode(CacheMode.REQUEST_NETWORK_FAILED_READ_CACHE); 3.如果发现有缓存直接成功，没有缓存才请求服务器
我们知道ImageLoader的核心除了内存优化外，剩下一个就是发现把内地有图片则直接使用，没有则请求服务器，所以NoHttp这一点非常使用做一个ImageLoader。如果没有缓存才去请求服务器，否则使用缓存：
Requestrequest= NoHttp.createJsonObjectRequest(url);
// 非标准Http协议，改变缓存模式为IF_NONE_CACHE_REQUEST_NETWORK
request.setCacheMode(CacheMode.IF_NONE_CACHE_REQUEST_NETWORK); 请求图片，缓存图片：
Requestrequest= NoHttp.createImageRequest(imageUrl);
request.setCacheMode(CacheMode.IF_NONE_CACHE_REQUEST_NETWORK); 4.仅仅请求网络
这里不会读取缓存，也不会使用Http304
Requestrequest= NoHttp.createImageRequest(imageUrl);
request.setCacheMode(CacheMode.ONLY_REQUEST_NETWORK);
... 5.仅仅读取缓存
如果没有缓存才去请求服务器，否则使用缓存，缓存图片演示：
Requestrequest= NoHttp.createImageRequest(imageUrl);
request.setCacheMode(CacheMode.ONLY_READ_CACHE); 七、取消请求
1.取消单个请求
直接调用请求对象的cancel方法。
request.cancel();2.从队列中取消指定的请求
给请求set一个sign，取消的时候调用队列的cancelBySign就可以取消掉所有指定这个sign的请求。
request.setCancelSign(sign);
...
queue.cancelBySign(sign);3.取消队列中所有请求
queue.cancelAll();4.停止队列
队列停止后再添加请求到队列后，请求不会被执行。
RequestQueuequeue= NoHttp.newRequestQueue();
...
queue.stop();八、自定义请求类型: FastJsonRequest
1.定义请求对象
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";
}
}2.使用自定义请求-和NoHttp默认请求没有区别的哦
RequestmRequest= 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.**{*;}NoHttp和Volley的比较
Volley没有下载模块，这里不再对比，说一下NoHttp的特点
请求模块的基本功能下载模块都有
