Novate 一款Android RxStyle的网络框架

1,767 阅读3分钟
去年我写了一个Android网络框架Novate, 基于Retrofit和RxJava封装的链式网络框架, 支持okhttp的调用分格,又兼容Retrofit注入方式,并支持RxJava调用的链式操作, 不仅支持开发者自己扩展,还沿用Okhttp的高效的网络加载!最重要的novate自带的异常驱动机制,帮开发者解决了绝大部分的异常 错误处理,减少API或者业务代码出错的导致崩溃概率。


功能

  • 优化设计:加入基础API,减少Api冗余

  • 强大的缓存模式: 支持离线缓存, 无网络智能加载缓存,可配置是否需要缓存

  • cookie管理:自带cookie管理机制

  • 全方位请求模式:支持多种方式访问网络(get,put, post ,delete)

  • 轻送调用:支持表单,图文一起,json上传。

  • 文件传输:支持文件下载和上传,支持进度

  • 动态添加:支持请求头和参数统一添加,分别添加。

  • 结果处理:支持对返回结果的统一处理,自动帮你序列化复杂的数据。

  • 扩展性强:支持自定义的Retrofit的API,默认Api无法满足时可自定义自己的Service

  • 悠雅方便:支持统一请求访问网络的流程控制,以方便帮你完美加入Processbar进度。

  • RxJava结合: 结合RxJava,线程智能控制

集成

Gradle:

  • root:

    repositories { maven { url "https://jitpack.io" } jcenter() }

  • app:

       dependencies {
          compile 'com.tamic.novate:novate:1.5.4.3'
       }

RxAPi

主要处理请求的API,包含RxGet, RxPost, RxDelete,RxPut, RxBody,RxFrom, RxUpLoad,RxDownLoad.使用基本APi之前 请阅读对RxCallBack的介绍。

RxGet

进行get方式的请求调用,多种返回结果的方式供你选择,返回不同的数据类型参考请看原文链接RxCallBack的介绍。

基础使用:

返回String

  new Novate.Builder(this)
           .baseUrl(“www.xxx.com/”)
           .build()
           .rxGet("service/path", parameters, new RxStringCallback() {

        });

返回Bean

 novate.rxGet("path or url", parameters, new RxResultCallback<JavaBean>() {
       
    });

返回List

    new Novate.Builder(this)
            .baseUrl("http://xxx.com/")
            .build()
            .rxGet("service/getList", parameters, new RxListCallback<List<JavaBean>>() {
              ...
            });

返回File

novate.rxGet("path or url", null, new RxFileCallBack(filePath, "name.jpg") {
    .....

    });

RxPost:

进行Post方式的请求调用

返回String

   novate.rxPost("path or url", parameters, new RxStringCallback() {
    .....
      
    });

返回Bean

 novate.rxPost("path or url", parameters, new RxResultCallback<ResultModel>() {
  
 
 });

返回List

 novate.rxPost("path or url", parameters, new RxListCallback<List<ResultModel>>() {

       ....

    });

返回File

 novate.rxPost("path or url", null, new RxFileCallBack(filePath, "name.jpg") {

       ....
    });

上传文件


这里主要介绍怎么使用Novate上传文件:

Novate提供了2种方式上传文件。body和part模式,Body不包含key值,part包含key值。

RxUploadWithBody

以Body方式post数据,可以上报文件,图片等。

   String mPath = uploadPath; //"you File path ";
    String url = "http:/xxx.com";

    novate.rxUploadWithBody(url, new File(mPath), new RxStringCallback() {

      ....
    });

}

RxUploadWithPart

上传文件,默认的key是 image

   String mPath = uploadPath; //"you File path ";
   String url = "http:/xxx.com";
   File file = new File(mPath);
   novate.rxUploadWithPart(url, file, new RxStringCallback() {

      ....
    });

上传多文件:

RxUploadWithPartListByFile:

   List<File> fileList = new ArrayList<>();
    fileList.add(file);
    fileList.add(file);
    fileList.add(file);
    novate.rxUploadWithPartListByFile(url, fileList, new RxStringCallback() {

            
     });

图文一起

   
   RequestBody requestBody = new MultipartBody.Builder().setType(MultipartBody.FORM)
      .addFormDataPart("key1", V1)
      .addFormDataPart("key2", v2)
      .addFormDataPart("file", file.getName(), RequestBody.create(MediaType.parse("image/*"), file))
      .build();
   novate.rxBody(url , requestBody, callback);

RxBody

 
   RequestBody requestBody = new MultipartBody.Builder().setType(MultipartBody.FORM)
      .addFormDataPart("key1", V1)
      .addFormDataPart("key2", v2)
      .addFormDataPart("file", file.getName(), RequestBody.create(MediaType.parse("image/*"), file))
      .build();
   
  novate.rxBody(url , requestBody, callback);

下载文件

使用rxGet()实现下载:

  String downUrl = "http://wap.dl.pinyin.sogou.com/wapdl/hole/201512/03/SogouInput_android_v7.11_sweb.apk";

  novate.rxGet(downUrl, parameters, new RxFileCallBack(FileUtil.getBasePath(this), "test.apk") {

       
    });

RxDown()下载

    String downUrl = "http://wap.dl.pinyin.sogou.com/wapdl/hole/201512/03/SogouInput_android_v7.11_sweb.apk";
    new Novate.Builder(this)
            .rxDownload(downUrl, new RxFileCallBack(FileUtil.getBasePath(this), "test.apk") {
                
            });

OkHTTP 姿势

喜欢okhtp姿势的朋友可以继续使用姿势:

  Request request =
            new Request.Builder()
                    .get()
                    .url("you url")
                    .build();

    novate.execute(request, new RxStringCallback() {

        
    });


Retrofit Api 姿势

Novate默认的API让你不爽时,Novate同样支持你自己Retrofit的ApiService

定义APi 同Retrofit的Api

新建MyApi


 public interface MyApi {

  @GET("url")
  Observable<MyBean> getdata(@QueryMap Map<String, String> maps);

 }

Execute

调用Call()

 MyApi myApi = novate.create(MyApi.class);

 novate.call(myApi.getdata(parameters),
            new BaseSubscriber<MyBean>{
            '''''''
            });

}


更多API,可以去github(github.com/Tamicer/Nov…)阅读 欢迎star!有疑问可以直接留言或者提issues, 或者加QQ群45854294咨询。