标签:
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文档: http://doc.nohttp.net
NoHttp官网: http://www.nohttp.net
NoHttp源码: https://github.com/yanzhenjie/NoHttp
NoHttp是一个Android开源网络框架,实现了RFC2616(Http1.1)协议,一个标准的Http框架。支持普通请求、文件的上传与下载、自动维持Cookie、支持RFC2616规定的所有请求方法(POST、GET、HEAD……)、支持Https(包括访问自签名网站)、支持请求优先级、支持请求与Activity联动、提供了五种缓存策略供开发者选择……
Eclipse使用Jar包,如果需要依赖源码,请自行下载。
AndroidStudio使用Gradle构建添加依赖(推荐)
compile‘com.yolanda.nohttp:nohttp:1.0.2‘
NoHttp提供了调试模式,打开后可以清晰的看到请求过程、怎么传递数据等,基本不用抓包。可以看到请求头、请求数据、响应头、Cookie等的过程。你也不用担心Log太多会让你眼花缭乱,想象不到的整洁。
所有下载均有进度回调、错误回调等友好的接口。
List<File>
)。所有取消都支持正在执行的请求。
// String 请求对象
Request<String>request= NoHttp.createStringRequest(url,requestMethod);
// JsonObject
Request<JSONObject>request= NoHttp.createJsonObjectRequest(url,reqeustMethod);
...
// JsonArray
Request<JSONArray>request= NoHttp.createJsonArrayRequest(url,reqeustMethod);
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));
这里可以添加各种形式的文件,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添加,如果请求方法是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) {
// 下载被取消或者暂停
}
};
NoHttp本身是实现了RFC2616,所以这里不用设置或者设置为DEFAULT。
Request<JSONObject>request= NoHttp.createJsonObjectRequest(url);
request.setCacheMode(CacheMode.DEFAULT);
请求服务器成功则返回服务器数据,如果请求服务器失败,读取缓存数据返回。
Request<JSONObject>request= NoHttp.createJsonObjectRequest(url);
request.setCacheMode(CacheMode.REQUEST_NETWORK_FAILED_READ_CACHE);
我们知道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);
这里不会读取缓存,也不会使用Http304:
Request<Bitmap>request= NoHttp.createImageRequest(imageUrl);
request.setCacheMode(CacheMode.ONLY_REQUEST_NETWORK);
...
如果没有缓存才去请求服务器,否则使用缓存,缓存图片演示:
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();
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";
}
}
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。
-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" />
标签:
原文地址:http://www.cnblogs.com/stwyy/p/5664033.html