备案控制台
探索云世界
开发者社区 开发与运维 文章 正文

Http标准协议Android网络框架——NoHttp

2017-11-16 949
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介：

  1. NoHttp详细文档：http://doc.nohttp.net

  2. NoHttp公益测试接口：http://api.nohttp.net

支持与RxJava完美结合、支持一句话切换底层为OkHttp，支持缓存数据到数据库或SD卡和数据库，并对数据做了加密保护，支持请求Restful风格的接口，比Retrofit更简单易用。

欢迎加入QQ技术交流群：46523908

效果预览

1 2

3 4

框架特性

  • 动态配置底层框架为OkHttp、HttpURLConnection
  • 与RxJava完美结合，支持异步请求、支持同步请求
  • 多文件上传，支持大文件上传，表单提交数据
  • 文件下载、上传下载、上传和下载的进度回调、错误回调
  • 支持Json、xml、Map、List的提交
  • 完美的Http缓存模式，可指定缓存到数据库、SD卡，缓存数据已安全加密 
    • 在6.0以上手机缓存到SD卡时需要请求运行时权限：AndPermission
  • 自定义Request，直接请求JsonObject、JavaBean等
  • Cookie的自动维持，App重启、关开机后还持续维持
  • http 301 302 303 304 307重定向，支持多层嵌套重定向
  • Https、自签名网站Https的访问、支持双向验证
  • 失败重试机制，支持请求优先级
  • GET、POST、PUT、PATCH、HEAD、DELETE、OPTIONS、TRACE等请求协议
  • 用队列保存请求，平均分配多线程的资源，支持多个请求并发
  • 支持取消某个请求、取消指定多个请求、取消所有请求

使用方法

AndroidStudio使用方式

  • 如果使用HttpURLConnection作为网络层：
compile 'com.yolanda.nohttp:nohttp:1.1.0'
  • 1
  • 1
  • 如果要使用OkHttp作为网络层，请再依赖：
compile 'com.yanzhenjie.nohttp:okhttp:1.1.0'
  • 1
  • 1

Eclipse使用方式

初始化

NoHttp初始化需要一个Context，最好在Application的onCreate()中初始化，记得在manifest.xml中注册Application。

一般初始化

直接初始化后，一切采用默认设置。

NoHttp.initialize(this);
  • 1

高级自定义初始化

  • 超时配置，默认10s
NoHttp.initialize(this, new NoHttp.Config()
    // 设置全局连接超时时间，单位毫秒
    .setConnectTimeout(30 * 1000) // 设置全局服务器响应超时时间，单位毫秒 .setReadTimeout(30 * 1000) );
  • 1
  • 配置缓存，默认保存在数据库
NoHttp.initialize(this, new NoHttp.Config()
    ...
    // 保存到数据库
    .setCacheStore(
        new DBCacheStore(this).setEnable(true) // 如果不使用缓存，设置false禁用。 ) // 或者保存到SD卡 .setCacheStore( new DiskCacheStore(this) ) );

  • 配置Cookie保存的位置，默认保存在数据库
NoHttp.initialize(this, new NoHttp.Config()
    ...
    // 默认保存数据库DBCookieStore，开发者可以自己实现。
    .setCookieStore(
        new DBCookieStore(this).setEnable(false) // 如果不维护cookie，设置false禁用。 ) );
  • 1
  • 配置网络层
NoHttp.initialize(this, new NoHttp.Config()
    ...
    // 使用HttpURLConnection
    .setNetworkExecutor(new URLConnectionNetworkExecutor())
    // 使用OkHttp .setNetworkExecutor(new OkHttpNetworkExecutor()) );

需要的权限

<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" />
  • 1

友好的调试模式

Logger.setDebug(true);// 开启NoHttp的调试模式, 配置后可看到请求过程、日志和错误信息。
Logger.setTag("NoHttpSample");// 设置NoHttp打印Log的tag。
  • 1

开启NoHttp的调试模式后可看到请求过程、日志和错误信息，基本不用抓包。可以看到请求头、请求数据、响应头、Cookie等，而且打印出的Log非常整齐。

所以说，如果你使用过程中遇到什么问题了，开启调试模式，一切妖魔鬼怪都会现形的。

第三方异步框架

RxJava 
可以与RxJava、RxAndroid、RxBus、EventBus等第三方异步任务框架完美结合使用，这里在demo中给出了和RxJava一起使用的代码。具体的封装请参考Demo的RxNoHttp。

Request<UserInfo> request = new JavaBeanRequest<>(url, UserInfo.class);
RxNoHttp.request(this, request, new SimpleSubscriber<Response<UserInfo>>() {
    @Override
    public void onNext(Response<YanZhenjie> entityResponse) { // 直接拿到实体对象 UserInfo userInfo = entiryResponse.get(); } });

请求队列

RequestQueue requestQueue = NoHttp.newRequestQueue();
// 如果要指定并发值，传入数字即可：NoHttp.newRequestQueue(3);

// 发起请求
requestQueue.add(what, request, responseListener);
  • 添加请求到队列时有一个what，这个what会在responseLisetener响应时回调给开发者，所以开发者可以用一个responseLisetener接受多个请求的响应，用what来区分结果。而不用像有的框架一样，每一个请求都要new一个callback。
  • 强烈建议把生成队列写成懒汉单例模式，因为每新建队列就会new出相应个数的线程来，同时只有线程数固定了，队列的作用才会发挥到最大。

请求类型

String请求

Request<String> request = NoHttp.createStringRequest(url, RequestMethod.GET);
requestQueue.add(0, request, listener);

Json请求

// JsonObject
Request<JSONObject> objRequest = NoHttp.createJsonObjectRequest(url, RequestMethod.POST);
requestQueue.add(0, objRequest, listener);

// JsonArray
Request<JSONArray> arrayRequest = NoHttp.createJsonArrayRequest(url, RequestMethod.PUT);
requestQueue.add(0, arrayRequest, listener);

Bitmap请求

Request<Bitmap> request = NoHttp.createImageRequest(url, RequestMethod.DELETE);
requestQueue.add(0, request, listener);

请求FastJson与Gson

// FastJson
Request<JSONObject> request = new FastJsonRequest(url, RequestMethod.POST);
requestQueue.add(0, request, listener);

直接请求JavaBean

// 内部使用Gson、FastJson解析成JavaBean
Request<UserInfo> request = new JavaBeanRequest(url, RequestMethod.GET);
requestQueue.add(0, request, listener);
  • 1

添加参数

Request<JSONObject> request = new JavaBeanRequest(url, RequestMethod.POST);
   .add("name", "yoldada") // String类型
   .add("age", 18) // int类型 .add("sex", '0') // char类型 .add("time", 16346468473154) // long类型 // 添加Bitmap .add("head", new BitmapBinary(bitmap)) // 添加File .add("head", new FileBinary(file)) // 添加ByteArray .add("head", new ByteArrayBinary(byte[])) // 添加InputStream .add("head", new InputStreamBinary(inputStream))

文件上传实现了http表单的标准协议，满足了广大开发者的需求，有以下几种形式：

  • 单个文件
Request<String> request = ...
request.add("file", new FileBinary(file));
  • 1
  • 上传多个文件、多个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 BitmapBinary(Bitmap));

  • 上传多个文件、一个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 BitmapBinary(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);

提交请求包体

提交Body分为提交Json、提交String、提交Xml、提交流等，具体用法如下：

// 提交普通String
request.setDefineRequestBody(String, ContentType);

// 提交json字符串
request.setDefineRequestBodyForJson(JsonString)

// 提交jsonObject对象，其实还是json字符串
request.setDefineRequestBodyForJson(JSONObject)

// 提交xml字符串
request.setDefineRequestBodyForXML(XmlString)

// 提交字体Body，比如File（这跟表单上传不一样的），可以转为InputStream来提交 request.setDefineRequestBody(InputStream, ContentType)

同步请求

在当前线程发起请求，在线程这么使用。

Request<String> request = NoHttp.createStringRequest(url, RequestMethod.DELETE);
Response<String> response = NoHttp.startRequestSync(request);
if (response.isSucceed()) {
    // 请求成功
} else {
    // 请求失败


}

五大缓存模式

NoHttp的缓存非常强大，支持缓存到数据库、换到SD卡等，并且不论缓存在数据库或者SD，NoHttp都把数据进行了加密，需要在初始化的时候配置缓存的位置。

需要注意的是，在6.0以上的手机中如果要缓存在SD卡，需要在请求之前，需要请求运行时权限，如果你不懂运行时权限，可以看这个项目：AndPermission。

NoHttp.initialize(this, new NoHttp.Config()
    ...
    // 保存到数据库
    .setCacheStore(
        new DBCacheStore(this).setEnable(true) // 如果不使用缓存，设置false禁用。 ) // 或者保存到SD卡 .setCacheStore( new DiskCacheStore(this) ) );

  • 1、Default模式，实现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。

请求String，缓存String：

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);

文件下载

因为下载文件代码比较多，这里贴关键部分，具体的请参考demo。

文件下载也是队列，队列和开头所说的请求的队列是一样的。

  • 发起下载请求
//下载文件
downloadRequest = NoHttp.createDownloadRequest...
// what 区分下载
// downloadRequest 下载请求对象
// downloadListener 下载监听
downloadQueue.add(0, downloadRequest, downloadListener);

  • 暂停或者停止下载
downloadRequest.cancel();

  • 监听下载过程
private DownloadListener downloadListener = new DownloadListener() {
    @Override
    public void onStart(int what, boolean resume, long preLenght, Headers header, long count) { // 下载开始 } @Override public void onProgress(int what, int progress, long downCount) { // 更新下载进度 } @Override public void onFinish(int what, String filePath) { // 下载完成 } @Override public void onDownloadError(int what, StatusCode code, CharSequence message) { // 下载发生错误 } @Override public void onCancel(int what) { // 下载被取消或者暂停 } };

取消请求

NoHttp支持取消某个请求、取消指定多个请求、取消所有请求。

  • 取消单个请求 
    直接调用请求对象的cancel方法。
request.cancel();
  • 1
  • 从队列中取消指定的请求 
    在请求之前给请求set一个sign，取消的时候调用队列的cancelBySign就可以取消掉所有指定这个sign的请求。
request1.setCancelSign(sign);
request2.setCancelSign(sign);
...

// 取消队列中多个用sign标志的请求
queue.cancelBySign(sign);
  • 取消队列中所有请求
queue.cancelAll();
  • 1

 

停止队列

队列停止后再添加请求到队列后，请求不会被执行。

RequestQueue queue = NoHttp.newRequestQueue();
...

queue.stop();

自定义请求

NoHttp的所有自带请求都是继承RestRequest类，所以我们自定义请求也需要继承RestRequest，泛型写自己想要请求的数据类型，最后在parseResponse()方法中解析服务器数据成自己自己想要的数据类型即可。 
* FastJsonRequest

public class FastJsonRequest extends RestRequestor<JSONObject> { public FastJsonRequest(String url) { this(url, RequestMethod.GET); } public FastJsonRequest(String url, RequestMethod requestMethod) { super(url, requestMethod); } @Override public JSONObject parseResponse(Headers header, byte[] body) throws Throwable { String result = StringRequest.parseResponseString(headers, body); return JSON.parseObject(result); } }

  • JavaBeanRequest，利用FastJson、Gson等把数据直接转为JavaBean
public class JavaBeanRequest<T> extends RestRequest<T> { private Class<T> clazz; public JavaBeanRequest(String url, Class<T> clazz) { this(url, RequestMethod.GET, clazz); } public JavaBeanRequest(String url, RequestMethod requestMethod, Class<T> clazz) { super(url, requestMethod); this.clazz = clazz; } @Override public T parseResponse(Headers header, byte[] body) throws Throwable { String response = StringRequest.parseResponseString(header, body); // 这里如果数据格式错误，或者解析失败，会在失败的回调方法中返回 ParseError 异常。 return JSON.parseObject(response, clazz); } }
  • 使用自定义请求
// 使用FastJson自定义请求
Request<JSONObject> request = new FastJsonRequest(url, requestMethod);
queue.add(what, mRequest, listener);

...

// 直击请求JavaBean
Request<UserInfo> request = new JavaBeanRequest(url, UserInfo.class);
queue.add(what, request, listener);

代码混淆

NoHttp设计到兼容高版本系统的api采用反射调用，所以所有类都可以被混淆，如果你非要keep的话，如下配置即可。

  • 原生NoHttp混淆
-dontwarn com.yolanda.nohttp.**
-keep class com.yolanda.nohttp.**{*;}

  • 如果使用okhttp的版本
// nohttp
-dontwarn com.yolanda.nohttp.**
-keep class com.yolanda.nohttp.**{*;}  // nohttp-okhttp -dontwarn com.yanzhenjie.nohttp.** -keep class com.yanzhenjie.nohttp.**{*;}  // okhttp -dontwarn okhttp3.** -keep class okhttp3.** { *;} -dontwarn okio.**

-keep class okio.** { *;}




本文转自 一点点征服 博客园博客，原文链接：http://www.cnblogs.com/ldq2016/p/NoHttp.html，如需转载请自行联系原作者



文章标签：
Android开发
数据库
缓存
Java
数据格式
关键词：
Android网络
HTTP协议
HTTPS网络
Android HTTP
HTTPS Android
技术小胖子
目录
相关文章
历年考试不作弊
|
1天前
|
移动开发 Java Android开发
构建高效Android应用：采用Kotlin协程优化网络请求
【4月更文挑战第24天】 在移动开发领域，尤其是对于Android平台而言，网络请求是一个不可或缺的功能。然而，随着用户对应用响应速度和稳定性要求的不断提高，传统的异步处理方式如回调地狱和RxJava已逐渐显示出局限性。本文将探讨如何利用Kotlin协程来简化异步代码，提升网络请求的效率和可读性。我们将深入分析协程的原理，并通过一个实际案例展示如何在Android应用中集成和优化网络请求。
历年考试不作弊
4 0
阿文没烦恼
|
7天前
|
缓存 网络协议
【计算机协议】第一章——HTTP协议详解
【计算机协议】第一章——HTTP协议详解
阿文没烦恼
21 0
桃李春风一杯酒
|
8天前
|
网络协议 Java API
深度剖析：Java网络编程中的TCP/IP与HTTP协议实践
【4月更文挑战第17天】Java网络编程重在TCP/IP和HTTP协议的应用。TCP提供可靠数据传输，通过Socket和ServerSocket实现；HTTP用于Web服务，常借助HttpURLConnection或Apache HttpClient。两者结合，构成网络服务基础。Java有多种高级API和框架（如Netty、Spring Boot）简化开发，助力高效、高并发的网络通信。
桃李春风一杯酒
8 0
Safenetworkaccess
|
9天前
|
存储 网络协议 安全
15.网络协议-Radius协议
15.网络协议-Radius协议
Safenetworkaccess
9 1
Safenetworkaccess
|
9天前
|
存储 网络协议 网络安全
14.网络协议-邮件协议
14.网络协议-邮件协议
Safenetworkaccess
13 0
东方睿赢
|
9天前
|
Android开发 开发者
Android网络和数据交互： 请解释Android中的AsyncTask的作用。
Android&#39;s AsyncTask simplifies asynchronous tasks for brief background work, bridging UI and worker threads. It involves execute() for starting tasks, doInBackground() for background execution, publishProgress() for progress updates, and onPostExecute() for returning results to the main thread.
东方睿赢
10 0
龙大吉
|
9天前
|
网络协议 安全 API
Android网络和数据交互： 什么是HTTP和HTTPS？在Android中如何进行网络请求？
HTTP和HTTPS是网络数据传输协议，HTTP基于TCP/IP，简单快速，HTTPS则是加密的HTTP，确保数据安全。在Android中，过去常用HttpURLConnection和HttpClient，但HttpClient自Android 6.0起被移除。现在推荐使用支持TLS、流式上传下载、超时配置等特性的HttpsURLConnection进行网络请求。
龙大吉
9 0
小周sir
|
10天前
|
缓存 安全 网络协议
Http协议是什么
【4月更文挑战第12天】HTTP是用于从WWW服务器传输超文本到浏览器的协议，基于TCP/IP，特点包括无连接、无状态、面向对象、无阻塞和可缓存。它的工作原理是客户端发送请求，服务器处理后返回响应。自1989年创建以来，HTTP已发展支持多媒体内容传输，并通过HTTPS提供安全保护。学习更多可参考计算机网络技术文献。
小周sir
18 6
Mylvzi
|
13天前
|
存储 JSON 前端开发
网络原理(4)HTTP协议（下）
网络原理(4)HTTP协议
Mylvzi
25 0
wljslmz
|
16天前
|
存储 网络协议 Linux
计算机网络基础教程：数据链路层的功能、协议和实现细节
【4月更文挑战第4天】
wljslmz
38 8
计算机网络基础教程：数据链路层的功能、协议和实现细节

热门文章

最新文章

  • 1
    SpringBoot项目调用HTTP接口5种方式你了解多少？
  • 2
    推荐：实现RTSP/RTMP/HLS/HTTP协议的轻量级流媒体框架，支持大并发连接请求
  • 3
    推荐一个比较好用的c++版本http协议库-cpp-httplib
  • 4
    TCP/IP、Http、Socket之间的区别
  • 5
    slb监听协议http
  • 6
    网络原理(4)HTTP协议（下）
  • 7
    HTTP-FLV详解及分析（二）
  • 8
    对象存储oss使用问题之flutter使用http库进行post请求文件上传返回400如何解决
  • 9
    【计算机协议】第一章——HTTP协议详解
  • 10
    Servlet 教程 之 Servlet 客户端 HTTP 请求 2
  • 1
    Python用RNN神经网络：LSTM、GRU、回归和ARIMA对COVID19新冠疫情人数时间序列预测
    42
  • 2
    【linux网络(一)】初识网络, 理解四层网络模型
    14
  • 3
    记录一次网络安全应急响应溯源过程
    5
  • 4
    Linux 网络操作命令Telnet
    14
  • 5
    第十六届山东省职业院校技能大赛中职组 “网络安全”赛项竞赛试题—B模块安全事件响应/网络安全数据取证/应用安全
    4
  • 6
    2024年山东省职业院校技能大赛中职组 “网络安全”赛项竞赛试题-C安全事件响应/网络安全数据取证/应用安全
    6
  • 7
    2024年山东省职业院校技能大赛中职组 “网络安全”赛项竞赛试题-B
    2
  • 8
    2024年山东省职业院校技能大赛中职组 “网络安全”赛项竞赛试题-A-CTF攻击与防御
    3
  • 9
    2024年山东省职业院校技能大赛中职组 “网络安全”赛项竞赛试题-A模块安全事件响应/网络安全数据取证/应用安全
    2
  • 10
    2024年甘肃省职业院校技能大赛中职组 “网络安全”赛项竞赛样题-C模块安全事件响应/网络安全数据取证/应用安全
    3

    • 相关课程

    更多
  • Java Web开发-Web应用、Tomcat、HTTP请求与响应
  • 企业上云攻略-阿里云网络产品应用系列教程
  • Linux网络进阶 - TCP/IP协议及OSI七层模型
  • 云安全基础课- HTTP协议基础
  • 网络管理者必知-2分钟了解新出台的《网络安全法》
  • 开源Android容器化框架Atlas开发者指南

    • 相关电子书

    更多
  • 可编程网络视角的网络创新研究
  • 可编程网络和SDN3.0
  • CDN助力企业网站进入HTTPS时代

    • 相关实验场景

    更多
  • 通过HTTPS加速网关快速部署网站加密
  • 容器的网络入门
  • 容器的自定义网络
    • 下一篇
    部署LAMP环境（Alibaba Cloud Linux 3）