NoHttp的学习使用

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" />
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值