a safety client by Https for Android, (Android线程安全http请求库)
- Join based API, reduce API redundancy
- Offline caching
- Support a variety of ways to access the network (a get, put, post, delete)
- Support file download and upload
- Unified support request header to join
- The unity of the support to return the result
- Support custom extensions API
- Support the unified request access to the network flow control
#dependencies
Eclipse:
Download the laster JAR:( com.tamic.novate:novate:-1.1.0.aar)
compile(name: 'com.tamic.novate:novate-1.1.0', ext: 'aar')
or Gradle:
-
root：
repositories { maven { url "https://jitpack.io" } jcenter() } -
app:
dependencies { .....
compile 'com.tamic.novate:novate:1.2.0'
}
Snapshots of the development version are available in Sonatype's snapshots repository.
Retrofit requires at minimum Java 7 or Android 2.3.
基于Retrofit和RxJava封装的链式请求库，为何起名 Novate？
Novate的英文原意是用新事物代替 我的目的是用新的东西来代替Retrofit的有些不易操作的地方，因此起名新奇的东西，所以结合了原来的Http用法习惯，又加入了Retrofit的特性，因此起名 ：Novate
- 加入基础API，减少Api冗余
- 支持离线缓存
- 支持多种方式访问网络（get,put,post ,delete）
- 支持Json字符串，表单提交
- 支持文件下载和上传
- 支持请求头统一加入
- 支持对返回结果的统一处理
- 支持自定义的扩展API
- 支持统一请求访问网络的流程控制
请求网络无需关心是否在主线程和非UI线程，操作UI直接可在回调处理, 保留了HttpClient的编码习惯，又加入了Builder模式编程！
Novate novate = new Novate.Builder(this)
.baseUrl(baseUrl)
.build();
novate.executeGet("pathUrl", parameters, new Novate.ResponseCallBack<NovateResponse<MyModel>>() {
.....
});
novate.executePost("pathUrl", parameters, new Novate.ResponseCallBack<NovateResponse<MyModel>>() {
.............
});
ovate.body(url, uesrBean, new BaseSubscriber<ResponseBody>() {
@Override
public void onError(Throwable e) {
}
@Override
public void onNext(ResponseBody responseBody) {
}
});
#FORM#
novate.Form(url, new HashMap<String, Object>(), new BaseSubscriber<ResponseBody>() {
@Override
public void onError(Throwable e) {
}
@Override
public void onNext(ResponseBody responseBody) {
}
});
novate.json(url, jsonString, new BaseSubscriber<ResponseBody>() {
@Override
public void onError(Throwable e) {
}
@Override
public void onNext(ResponseBody responseBody) {
}
});
upLoadImage
RequestBody requestFile =
RequestBody.create(MediaType.parse("image/jpg"), new File(you file path));
novate.upload(url, requestFile, new BaseSubscriber<ResponseBody>{
'''''''''''''''
});
upLoadFile
String mPath = "you File path ";
String url = "";
File file = new File(mPath);
// 创建 RequestBody，用于封装 请求RequestBody
RequestBody requestFile =
RequestBody.create(MediaType.parse("multipart/form-data"), file);
// MultipartBody.Part is used to send also the actual file name
MultipartBody.Part body =
MultipartBody.Part.createFormData("image", file.getName(), requestFile);
// 添加描述
String descriptionString = "hello, 这是文件描述";
RequestBody description =
RequestBody.create(
MediaType.parse("multipart/form-data"), descriptionString);
// 执行
novate.uploadFlie(url, description, body,new BaseSubscriber<ResponseBody>(ExempleActivity.this) {.......
});
upLoadFiles
Map<String, RequestBody> maps = new HashMap<>();
maps.put("file1", requestFile);
novate.uploadFlies(url, maps, new BaseSubscriber<ResponseBody>(ExempleActivity.this) {
......
} );
downLoad for MaxFile
novate.download(downUrl, new DownLoadCallBack() {
''''''''''''
});
downLoad for minFile
novate.downloadMin(downUrl, new DownLoadCallBack() {
''''''''''''
});
如果默认的BaseApiService无法满足你的需求时，novate同样支持你自己的ApiService。
MyApi
public interface MyApi {
@GET("url")
Observable<MyBean> getdata(@QueryMap Map<String, String> maps);
}
Execute
MyApi myApi = novate.create(MyApi.class);
novate.call(myAPI.getdata(parameters),
new BaseSubscriber<MyBean>{
'''''''
});
}
- V1.2.0: 增加对Response数据格式，业务码，错误码的配置功能。提供自定义功能。
2016.11 - V 1.1.1 :更新对结果异常的判断分发出处理
2016.10 - V1.1.0: 增加Response异常处理和容错处理。
2016.10 - V 1.0.2 : 增加body方式，增加小文件下载，增加表单方式提交，并新增是否同步cookie接口 .
2016.9 - V1.0.1: 扩展下载接口，可以制定下载路径和文件名，包括修复下载抛异常问题。
2016.8 - V 1.0 : 完成基础的get, put, Post delete, upLoad, DownLoad功能
2016.6
Copyright 2013 Square, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.