NoHttpConnecter

基于 NoHttp 的封装，主要包括字符串、Bitmap、JsonArray 等的 GET 和 POST 请求、文件上传下载方法的简单封装，以及五种缓存模式的使用。

首先对 NoHttp 网络框架做一个简介

Nohttp 是一个 Android Http 标准框架，底层可动态切换 OkHttp、URLConnection，与 RxJava 完美结合，支持缓存数据到数据库或 SD 卡（缓存数据自动加密），支持请求 Restful 风格的接口，比 Retrofit 更简单易用。

Nohttp 框架特性

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

这么多好用的功能，难道你不想试试？

NoHttp 开源框架地址：https://github.com/yanzhenjie/NoHttp

使用方法

1. Gradle添加依赖（推荐）

compile 'com.yanzhenjie.nohttp:okhttp:1.1.2' (可能非最新版)

2. 需要的权限

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

3. 初始化

初始化 NoHttp，并设置 NoHttp 底层采用那种网络框架去请求，建议把初始化方法放到 Application 中 onCreate 生命周期方法里面。还有别忘了在manifest.xml中注册Application。

//初始化 NoHttp
NoHttp.initialize(this, new NoHttp.Config()
        .setConnectTimeout(30 * 1000)  // 设置全局连接超时时间，单位毫秒，默认10s。
        .setReadTimeout(30 * 1000)  // 设置全局服务器响应超时时间，单位毫秒，默认10s。
        // 配置缓存，默认保存数据库DBCacheStore，保存到SD卡使用DiskCacheStore。
        .setCacheStore(
                new DBCacheStore(this).setEnable(true) // 如果不使用缓存，设置setEnable(false)禁用。
        )
        // 配置Cookie，默认保存数据库DBCookieStore，开发者可以自己实现。
        .setCookieStore(
                new DBCookieStore(this).setEnable(true) // 如果不维护cookie，设置false禁用。
        )
        // 配置网络层，默认使用URLConnection，如果想用OkHttp：OkHttpNetworkExecutor。
        .setNetworkExecutor(new OkHttpNetworkExecutor())
);

4.接下来，你就可以愉快的进行网络请求了：

• new 队列

RequestQueue requestQueue = NoHttp.newRequestQueue();

• new 请求

比如这样，

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

或者这样，

Request<JSONObject> objRequest = NoHttp.createJsonObjectRequest(url, RequestMethod.POST);

...等等（支持更多，如 JsonArray、Bitmap、byte[] 或自定义请求类型）。然后把需要的请求参数添加进来：

.add("name", "name") // String类型
...

• 把请求添加到队列，完成请求

requestQueue.add(what, request, responseListener);

• 回调对象，接受请求结果

处理成功、失败等方法的回调，实现当前界面的业务和逻辑。

• 添加请求到队列时有一个what，这个what会在responseLisetener响应时回调回来，所以可以用一个responseLisetener接受多个请求的响应，用 what 来区分结果。
• 强烈建议把生成队列写成懒汉单例模式，因为每新建队列就会 new 出相应个数的线程来，同时只有线程数固定了，队列的作用才会发挥到最大。

• 取消请求

在组件销毁的时候（onDestroy()）调用队列的按照 sign 取消的方法即可取消

这时我们发现有很多重复的操作，每个 Activity 和 Fragment 都这么写就显得有点麻烦了，再加上上面的两条重要提示，所以我们这里把队列进行单例模式封装，并把这些操作封装在 BaseActivity、BaseFragment 中。

对 NoHttp 的封装，请看源码：HttpResponseListener、HttpListener、CallServer、BaseActivity 等。

现已将此封装发布到 JitPack ，可以直接使用如下方式引入。

JitPack 引入方法

1. 在 Project 下的 build.gradle 添加

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

2. 在 Module 下的 build.gradle 添加

dependencies {
    compile 'com.github.lishide:NoHttpConnecter:v+latest version'
    //latest version 见上方 JitPack 图标所示，如：
    compile 'com.github.lishide:NoHttpConnecter:v1.0.2'
}

其它界面继承 BaseActivity 或 BaseFragment，请求网络的方式跟上面的类似，多了几个参数而已。更多使用详见 simple。

...
Request<String> request = NoHttp.createStringRequest(url, RequestMethod.GET);
request.add("name", "name")
request(0, request, httpListener, true, true);

---

五大缓存模式

• 1、Default 模式，实现 http304 重定向缓存

request.setCacheMode(CacheMode.DEFAULT);

• 2、请求网络失败返回缓存

request.setCacheMode(CacheMode.REQUEST_NETWORK_FAILED_READ_CACHE);

• 3、没有缓存才去请求网络

request.setCacheMode(CacheMode.NONE_CACHE_REQUEST_NETWORK);

• 4、仅仅请求网络

request.setCacheMode(CacheMode.ONLY_REQUEST_NETWORK);

• 5、仅仅读取缓存

request.setCacheMode(CacheMode.ONLY_READ_CACHE);

文件下载

• 1、单个文件下载
• 2、多个文件下载

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

• 发起下载请求

mDownloadRequest = NoHttp.createDownloadRequest(url, path, filename, true, true);
downloadQueue.add(0, mDownloadRequest, downloadListener);

• 暂停或者停止下载

mDownloadRequest.cancel();

• 监听下载过程

private DownloadListener downloadListener = new DownloadListener() {

  // 下载开始
  @Override
  public void onStart(int what, boolean isResume, long beforeLength, Headers headers, long allCount) {

  }

  // 下载发生错误
  @Override
  public void onDownloadError(int what, Exception exception) {

  }

  // 更新下载进度和下载网速
  @Override
  public void onProgress(int what, int progress, long fileCount, long speed) {

  }

  // 下载完成
  @Override
  public void onFinish(int what, String filePath) {

  }

  // 下载被取消或者暂停
  @Override
  public void onCancel(int what) {

  }
};

关于文件下载，具体的请参考 Demo。

文件上传

• 1、单个文件上传

Request<String> request = NoHttp.createStringRequest(url, RequestMethod.POST);
request.add("file", new FileBinary(file));

• 2、多个文件上传（这里可以添加各种形式的文件，File、Bitmap、InputStream、ByteArray。）

  • 多个Key多个文件形式

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

......

---

本人仅是简单地对 NoHttp 网络请求框架进行轻量级的封装，后期还会进行持续维护，更多关于 NoHttp 的使用可直接查看原作。

NoHttp —— 一个有情怀的网络框架 ，让你的网络请求更简单。

像上面说的一样，NoHttp 真的很强大、很好用，嗯，没错。