Novate 网络库:Retrofit2.0和RxJava的又一次完美改进加强(Tamic博客 -CSDN)
作者/Tamic
http://blog.csdn.net/sk719887916/article/details/52195428
前言
用过RxJava和Retrofit的朋友,用久了就会发现Retrofit说难不难,说简不简,对于实际项目中,单纯的用Retrofit做请求库,开发起来还是很多不便,必须请求头和参数处理,API接口数目众多时的处理, Https证书验签,cookie持久,错误结果处理,统一操作加载过渡UI等,因此我对Retrofit再次进行了封装,一直关注我的朋友以前看我封装的《 基于Retrofit2.0 封装的超好用的RetrofitClient工具类》的一文,已对Retrofit结合RxJava时遇到上面的问题进行了完整封装,但是不是Builder模式,因此感觉还是有点土,特此我进行了长达两个月Novate 框架的开发,
为何起名为Novate?
Novate的英文原意是用新事物代替 ,我开发目的是用新的东西来代替Retrofit的有些不易操作的地方,因此起名新奇的东西,所以结合了原来的Http用法习惯,又加入了Retrofit和RxJava的特性,因此起名 :Novate
进行下文前请先了解Retrofit和Rxjava,不懂请移步:
系列导读:
介绍
Novate的改进
- 加入基础API,减少Api冗余
- 支持离线缓存
- 支持多种方式访问网络(get,put,post ,delete)
- 支持文件下载和上传
- 支持请求头参数统一添加
- 支持对返回结果的统一处理
- 支持自定义的扩展API
- 支持统一请求访问网络的流程控制
用法
基本构建:
Novate novate = new Novate.Builder(this)
.baseUrl(baseUrl)
.build();
除了基本的构建还提供更了其他API
构建你的header头和参数
Map<String, String> headers = new HashMap<>();
headers.put("apikey", "4545sdsddfd7sds");
Map<String, String> parameters = new HashMap<>();
parameters.put("uid", "878787878sdsd");
实例化:
Novate novate = new Novate.Builder(this)
.addParameters(parameters)
.connectTimeout(8)
.baseUrl("you api url")
.addHeader(headers)
.addLog(true)
.build();
如果你需要接入证书:
novate.addSSL(hosts, certificates)
怎么用?
int[] certificates = {R.raw.myssl1, R.raw.myssl2,......}
int[] hosts = {"https:// you hosturl2", "https:// you hosturl2",......}
还要说明?
certificates是你的ssl证书文件的id,项目中请放到raw资源文件下,myssl.cer怎么生成,这个就不是我这边讲的内容,请用pc浏览器自动导出证书,保存, 还不清楚的话,我会醉醉。
同样很多人想问 我想对novate进行扩展,咋办,别担心,Novate也提供了以下方法
novate.addInterceptor()
.addCallAdapterFactory()
.callFactory()
.client()
不知道啥意思?
请对 Retrofit去入门,Retrofit中怎么用,Novate就怎么用。
RxJava怎么处理?
observable.subscribeOn(Schedulers.io())
.unsubscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread());
内部统一已进行线程控制,所有请求都采用以上线程形式,无语你手动添加。
Get
提供了novate.get()
和novate.get()
API
区别如下:
executeGet 来执行get请求,此方法会解析返回你需要的bean实体
novate.get()不会帮你解析实体,需要你自己对返回数据解析进行序列化。
novate.executeGet("you url", parameters, new Novate.ResponseCallBack<NovateResponse<ResultModel>>() {
@Override
public void onError(Throwable e) {
}
@Override
public void onSuccee(NovateResponse<ResultModel> response) {
// 这里novate已对ResponseBody进行解析返回,
}
});
如果你不需要Novate帮你解析返回的数据 则调用novate.get()
novate.get("you Url", parameters, new BaseSubscriber<ResponseBody>(ExempleActivity.this) {
@Override
public void onNext(ResponseBody responseBody) {
try {
String jstr = new String(responseBody.bytes());
Type type = new TypeToken<MovieModel>() {
}.getType();
// 这里需要对ResponseBody进行解析,novate并不会帮你解析
MovieModel response = new Gson().fromJson(jstr, type);
Toast.makeText(ExempleActivity.this, response.toString(), Toast.LENGTH_SHORT).show();
} catch (IOException e) {
e.printStackTrace();
}
}
});
Post
提供了`novate.post()`和`novate.executePost()`两个API
区别如下:
executePost 来执行Post方式请求,此方法对结果解析返回你需要的bean实体
novate.post()不会帮你解析实体,需要你自己对返回数据解析进行序列化。
Get和Post代码用法很相似,
novate.post()
/**
*
*
* 调用post需要你自己解析数据
*
* 如果需要解析后返回 则调用novate.executeGet()
* 参考 performGet()中的方式
*/
novate.post("service/getIpInfo.php", parameters, new BaseSubscriber<ResponseBody>(ExempleActivity.this) {
@Override
public void onError(Throwable e) {
}
@Override
public void onNext(ResponseBody responseBody) {
try {
String jstr = new String(responseBody.bytes());
Type type = new TypeToken<NovateResponse<ResultModel>>() {
}.getType();
NovateResponse<ResultModel> response = new Gson().fromJson(jstr, type);
Toast.makeText(ExempleActivity.this, response.getData().toString(), Toast.LENGTH_SHORT).show();
} catch (IOException e) {
e.printStackTrace();
}
}
});
novate.executePost()
novate.executePost("pathUrl", parameters, new Novate.ResponseCallBack<NovateResponse<MyModel>>() {
@Override
public void onError(Throwable e) {
// todo
}
@Override
public void onSuccee(NovateResponse<ResultModel> response) {
// todo
}
});
Put
put方式则提供了novate.put()
和novate.executePut()
两个API
区别和用法参考 上面Get和Put
Delete
同样对Delete 提供了novate.delete()
和novate.executeDelete()
两个API
区别和用法参考 上面Get和Put
BODY
假设你需要提交body, Novate也提供了novate.body(),需要直接将你bean对象加入即可,因此可以:
ovate.body(url, uesrBean, new BaseSubscriber<ResponseBody>() {
@Override
public void onError(Throwable e) {
}
@Override
public void onNext(ResponseBody responseBody) {
}
});
FORM
假设你以提交表单,请使用novate.form(),你可以:
novate.form(url, new HashMap<String, Object>(), new BaseSubscriber<ResponseBody>() {
@Override
public void onError(Throwable e) {
}
@Override
public void onNext(ResponseBody responseBody) {
}
});
JSON
假设你需要直接push json 字符串,你可以:
novate.json(url, jsonString, new BaseSubscriber<ResponseBody>() {
@Override
public void onError(Throwable e) {
}
@Override
public void onNext(ResponseBody responseBody) {
}
});
UpLoad
当然novate 特提供了可供上传图片的API novate.upload()
RequestBody requestFile =Utils.createFile(file);
novate.upload(url, requestFile, new BaseSubscriber<ResponseBody>{
@Override
public void onNext(ResponseBody responseBody) {
}
});
如果是单文件
novate.uploadFlie(url, requestFile, new BaseSubscriber<ResponseBody>{
@Override
public void onNext(ResponseBody responseBody) {
}
});
upLoadFiles
Map<String, RequestBody> map = new HashMap<>();
maps.put("file1", requestFile);
novate.uploadFlies(url, map, new BaseSubscriber<ResponseBody>(ExempleActivity.this) {
......
} );
图文一起
同时提交图文:适合用户注册等场景 novate.uploadupload
body模式
//构建body 链式语法高逼格哦
RequestBody requestBody = new MultipartBody.Builder().setType(MultipartBody.FORM)
.addFormDataPart("name", "tamic")
.addFormDataPart("password", "12345")
.addFormDataPart("atavr", file.getName(), Utils.createImage(mfile))
.build();
novate.upload(url, requestBody, new BaseSubscriber<ResponseBody>(ExempleActivity.this) {
.....
});
利用part模式
// MultipartBody.Part is used to send also the actual file name
MultipartBody.Part body = Utils.createPart("hello 这是和后端约定好的key", file);
// add 描述
String descriptionString = "hello, 这是文件描述";
RequestBody description = Utils.createPartFromString(descriptionString);
// 执行
novate.uploadFlie(url, description, body, new BaseSubscriber<ResponseBody>(ExempleActivity.this) {
。。。。。
});
DownLoad
如果说有上传文件的接口,必定有下载文件的接口,同样novate也提供了下载文件API novate.download()
novate.download(downUrl, new DownLoadCallBack() {
@Override
public void onStart() {
super.onStart();
}
@Override
public void onError(Throwable e) {
}
@Override
public void onCancel() {
super.onCancel();
}
@Override
public void onProgress(long fileSizeDownloaded) {
super.onProgress(fileSizeDownloaded);
}
@Override
public void onSucess(String path, String name, long fileSize) {
}
});
通常还有同学要定制下载路径和文件名,当然也有API提供:
public void download(String url, String savePath, String name, DownLoadCallBack callBack) {
.......
}
downLoad 大文件
novate.download(downUrl, new DownLoadCallBack() {
''''''''''''
});
downLoad 小文件
novate.downloadMin(downUrl, new DownLoadCallBack() {
''''''''''''
});
Custom Api
以上方法默认会处理Novate自带的BaseApiService
,如果默认的BaseApiService
无法满足你的需求时,Novate同样支持你自己的ApiService。
定义一个你自己的APi
MyAPI
public interface MyAPI {
@GET("url")
Observable<MyBean> getdata(@QueryMap Map<String, String> maps);
}
Execute Call
通过novate提供create()
实例化你的API
MyAPI myAPI = novate.create(MyAPI.class);
通过novate.call()来执行你的接口,你也不用关心,novate内部同样已进行RxJava线程控制。
novate.call(myAPI.getdata(parameters),
new BaseSubscriber<MyBean>(ExempleActivity.this) {
@Override
public void onError(Throwable e) {
}
@Override
public void onNext(MyBean MyBean) {
}
});
}
取消
每执行novate.xxx() 给上层返回了一个Subscription,上层可以调用unsubscribe()来进行取消!
感谢
感谢一直以来提供思路,和测试的朋友,不断提供建议和思路,让我不断完善novate,。 有的人看过或者读过后觉得此框架定制化严重,也有的人觉得挺好,所以提供了可配置方案:
如果你觉得此框架的业务码和错误码定的太死,其实框架已提供定制化方案,比如可以在你的项目中Assets中修改config文件:
如果想用自带的成功状态码0,不成功为非零的情况,可忽略一下配置。
{
"isFormat": "false",
"sucessCode": [
"1",
"0",
"1001"
],
"error": {
"1001": "网络异常"
}
}
如果不想对结果格式化检查,请将isFormat设置为:false
将修改sucessCode的成功业务吗,请将你的成功的业务码加入到sucessCode节点中。
错误码
需要对错误码进行自定义翻译,请配置相关error信息,具体可配置成:
`{
"isFormat": "false",
"sucessCode": [
"1",
"0",
"1001"
],
"error": {
"1001": "网络异常",
"1002": "加入你的异常信息"
}
}
缺陷
目前1.X并没有完全运用RxJava2.0的新特性,笔者以开始联合@一叶扁舟 做兼容RxJava2.x的APi的工作, 目前Novate很遗憾无法为你提供压栈,背压式服务!
在连续异步多个api时,诸如指定序列请求网络的场景,大白话就是你要根据上一个api的返回值再执行下一个api的情况,Novate1.x只能是靠开发者在上层的成功回调中执行,如果是1.x是对retrofit的强化,那么novate2.x将是对RxJava的运用强化。
结束
如果你对本框架有无法满足你的需求或有何更好的想法,请及时联系我进行交流,谢谢您的支持!欢迎您的star.
源码
GitHub:https://github.com/Tamicer/Novate/
作者/Tamic
http://blog.csdn.net/sk719887916/article/details/52195428
Novate 网络库:Retrofit2.0和RxJava的又一次完美改进加强(Tamic博客 -CSDN)的更多相关文章
- 从壹开始前后端分离 [ Vue2.0+.NET Core2.1] 二十二║Vue实战:个人博客第一版(axios+router)
前言 今天正式开始写代码了,之前铺垫了很多了,包括 6 篇基础文章,一篇正式环境搭建,就是为了今天做准备,想温习的小伙伴可以再看看<Vue 基础入门+详细的环境搭建>,内容很多,这里就暂时 ...
- iOS中 蓝牙2.0详解/ios蓝牙设备详解 韩俊强的博客
每日更新关注:http://weibo.com/hanjunqiang 新浪微博 整体布局如下: 程序结构如右图: 每日更新关注:http://weibo.com/hanjunqiang ...
- Android基于Retrofit2.0 +RxJava 封装的超好用的RetrofitClient工具类(六)
csdn :码小白 原文地址: http://blog.csdn.net/sk719887916/article/details/51958010 RetrofitClient 基于Retrofit2 ...
- Python 每日提醒写博客小程序,使用pywin32、bs4库
死循环延迟调用方法,使用bs4库检索博客首页文章的日期是否与今天日期匹配,不匹配则说明今天没写文章,调用pywin32库进行弹窗提醒我写博客.
- Retrofit2.0+RxJava+Dragger2实现不一样的Android网络架构搭建
Tamic :csdn http://blog.csdn.net/sk719887916 众所周知,手机APP的核心就在于调用后台接口,展示相关信息,方便我们在手机上就能和外界交互.所以APP中网络框 ...
- 基于Retrofit2.0+RxJava+Dragger2实现不一样的Android网络构架搭建(转载)
转载请注明出处:http://blog.csdn.net/finddreams/article/details/50849385#0-qzone-1-61707-d020d2d2a4e8d1a374a ...
- 一个App带你学会Retrofit2.0,麻麻再也不用担心我的网络请求了!
Retrofit.Retrofit.Retrofit,越来越多的人在玩这个网络请求框架,这个由squareup公司开源的网络请求框架确实挺好用,今天我们就来看一下这个东东怎么玩! Retrofit作为 ...
- Android 使用Retrofit2.0+OkHttp3.0实现缓存处理+Cookie持久化第三方库
1.Retrofit+OkHttp的缓存机制 1.1.第一点 在响应请求之后在 data/data/<包名>/cache 下建立一个response 文件夹,保存缓存数据. 1.2.第二点 ...
- Android 基于ijkplayer+Rxjava+Rxandroid+Retrofit2.0+MVP+Material Design的android万能播放器aaa
MDPlayer万能播放器 MDPlayer,基于ijkplayer+Rxjava+Rxandroid+Retrofit2.0+MVP+Material Design的android万能播放器,可以播 ...
随机推荐
- [LeetCode] Equal Tree Partition 划分等价树
Given a binary tree with n nodes, your task is to check if it's possible to partition the tree to tw ...
- MySQL之存储过程和函数
存储过程和函数: 1.创建存储过程和函数: 存储过程: delimiter $$ create procedure proc_name() BEGIN 查询语句; // 记得加分号 END $$ de ...
- PHPCMS v9.6.0 任意文件上传漏洞分析
引用源:http://paper.seebug.org/273/ 配置了php debug的环境,并且根据这篇文章把流程走了一遍,对phpstorm的debug熟练度+1(跟pycharm一样) 用户 ...
- Java爬虫原理分析
当我们需要从网络上获取资源的时候,我们一般的做法就是通过浏览器打开某个网站,然后将我们需要的东西下载或者保存下来. 但是,当我们需要大量下载的时候,这个时候通过人工一个个的去点击下载,就显得太没有效率 ...
- [HNOI2016]大数
题目描述 小 B 有一个很大的数 S,长度达到了 N 位:这个数可以看成是一个串,它可能有前导 0,例如00009312345.小B还有一个素数P.现在,小 B 提出了 M 个询问,每个询问求 S 的 ...
- ●Joyoi 绿豆蛙的归宿
题链: http://www.joyoi.cn/problem/tyvj-1933题解: 期望dp,拓扑序 定义dp[i]表示从i点到N点的期望距离. 令cnt[u]表示u的出度. 显然$$dp[u] ...
- 【BZOJ1012】【JSOI2008】最大数maxnumber
Description 现在请求你维护一个数列,要求提供以下两种操作:1. 查询操作.语法:Q L 功能:查询当前数列中末尾L个数中的最大的数,并输出这个数的值.限制:L不超过当前数列的长度.2. 插 ...
- hdu 3436 splay树+离散化*
Queue-jumpers Time Limit: 2000/1000 MS (Java/Others) Memory Limit: 32768/32768 K (Java/Others) To ...
- H3C系列之三层交换机系统版本升级
本文涉及到的硬件与软件交换机:H3C S3600-28TP-SItftp软件:tftpd32小软件升级的文件:S36SI_E-CMW310-R1702P44.zip 关于升级的文件说明如下: S36S ...
- spring基本原理
作者:王奕然链接:https://www.zhihu.com/question/21346206/answer/101789659来源:知乎著作权归作者所有.商业转载请联系作者获得授权,非商业转载请注 ...