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万能播放器,可以播 ...
随机推荐
- requests之一:HTTP OAUTH认证(1)图形解释流程
- 用PHP如何实现这种乘法口诀表?
用PHP如何实现这种乘法口诀表? 1x1=1 ,1x2=2 ,1x3=3 ,.....,1x9=9 2x2=4 ,2x3=6 ,......,2x9=18 ........ ...... 8x8=64 ...
- 查看 Secret - 每天5分钟玩转 Docker 容器技术(156)
可以通过 kubectl get secret 查看存在的 secret. 显示有两个数据条目,kubectl describe secret 查看条目的 Key: 如果还想查看 Value,可以用 ...
- ubuntu安装 tar.gz格式程序
tar.gz(bz或bz2等) 一.安装1.打开一个SHELL,即终端2.用cd 命令进入源代码压缩包所在的目录3.根据压缩包类型解压缩文件(*代表压缩包名称)tar -zxvf ****.tar.g ...
- jenkins实战(一):war安装及插件安装
一:整体介绍 以下摘自维基百科: Jenkins是一个用Java编写的开源的持续集成工具.在与Oracle发生争执后,项目从Hudson项目复刻. Jenkins提供了软件开发的持续集成服务.它运行在 ...
- 原生http请求封装
满血复活,今天开始开始更新博客.随着es6的普遍应用,promise属性也随之用之普遍,我们在一些项目中,为了避免引入一些http库,节省空间,就简单将原生http请求做了封装处理,封装代码如下:(其 ...
- XMLHTTPRequestObject获取服务器数据
http://www.educity.cn/develop/526316.html 在Web客户端使用xmlhttp对象,可以十分方便的和服务器交换数据,我们可以获取和发送任何类型的数据,甚至二进制数 ...
- Mac 下升级 vim 并自己配置 vim 的过程
1.升级 vim 我自己 MacBook Pro 的系统还是 10.11 ,其自带的 vim 版本为 7.3 ,我们将其升至最新版: 使用 homebrew : brew install vim -- ...
- [POJ 3487]The Stable Marriage Problem
Description The stable marriage problem consists of matching members of two different sets according ...
- [APIO2016]划艇
题目描述 在首尔城中,汉江横贯东西.在汉江的北岸,从西向东星星点点地分布着 NNN 个划艇学校,编号依次为 111 到 NNN.每个学校都拥有若干艘划艇.同一所学校的所有划艇颜色相同,不同的学校的划艇 ...