RxHttp

Project Url: liujingxing/RxHttp
Introduction: OkHttp+RxJava 一条链发送请求,自动关闭未完成的请求,新一代 Http 请求神器
More: Author   ReportBugs   
Tags:

Download

1. 30 秒即可上手,学习成本极低

2. 史上最优雅的支持 Kotlin 协程

3. 史上最优雅的处理多个 BaseUrl 及动态 BaseUrl

4. 史上最优雅的对错误统一处理,且不打破 Lambda 表达式

5. 史上最优雅的实现文件上传/下载及进度的监听,且支持断点下载

6. 支持 Gson、Xml、ProtoBuf、FastJson 等第三方数据解析工具

7. 支持 Get、Post、Put、Delete 等任意请求方式,可自定义请求方式

8. 支持在 Activity/Fragment/View/ViewModel/任意类中,自动关闭请求

9. 支持全局加解密、添加公共参数及头部、网络缓存,均支持对某个请求单独设置

请求三部曲

image

上手准备

RxHttp&RxLife 交流群:378530627

遇到问题,点击这里,99%的问题都能自己解决

必须

//使用 kapt 依赖 rxhttp-compiler,需要导入 kapt 插件
apply plugin: 'kotlin-kapt'

android {
    defaultConfig {
        javaCompileOptions {
            //告知 RxHttp 你依赖的 okhttp 版本
            annotationProcessorOptions {
                arguments = [rxhttp_okhttp: '4.7.2']
            }
        }
    }
    //java 8 或更高
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}
dependencies {
    implementation 'com.ljx.rxhttp:rxhttp:2.2.6'
    implementation 'com.squareup.okhttp3:okhttp:4.7.2' //rxhttp v2.2.2 版本起,需要手动依赖 okhttp
    kapt 'com.ljx.rxhttp:rxhttp-compiler:2.2.6' //生成 RxHttp 类,非 kotlin 项目,请使用 annotationProcessor 代替 kapt
}

注:OkHttp 3.14.x以上版本, 最低要求为 API 21,如你想要兼容 21 以下,请依赖OkHttp 3.12.x,该版本最低要求 API 9

最后,rebuild 一下(此步骤是必须的) ,就会自动生成 RxHttp 类,更多配置,请继续往下看

非必须

android {
    defaultConfig {
        javaCompileOptions {
            annotationProcessorOptions {
                arguments = [
                        rxhttp_rxjava: 'rxjava3', //告知 RxHttp 你依赖的 rxjava 版本,可传入 rxjava2、rxjava3
                        rxhttp_package: 'rxhttp'   //指定 RxHttp 相关类的生成路径,即包名
                ]
            }
        }
    }
}
// RxJava2/Rxjava3 二选一
dependencies {
    implementation 'com.ljx.rxlife:rxlife-coroutine:2.0.0' //管理协程生命周期,页面销毁,关闭请求

    //rxjava2
    implementation 'io.reactivex.rxjava2:rxjava:2.2.8'
    implementation 'io.reactivex.rxjava2:rxandroid:2.1.1'
    implementation 'com.ljx.rxlife2:rxlife-rxjava:2.0.0' //管理 RxJava2 生命周期,页面销毁,关闭请求

    //rxjava3
    implementation 'io.reactivex.rxjava3:rxjava:3.0.2'
    implementation 'io.reactivex.rxjava3:rxandroid:3.0.0'
    implementation 'com.ljx.rxlife3:rxlife-rxjava:3.0.0' //管理 RxJava3 生命周期,页面销毁,关闭请求

    //Converter 根据自己需求选择 RxHttp 默认内置了 GsonConverter
    implementation 'com.ljx.rxhttp:converter-jackson:2.2.6'
    implementation 'com.ljx.rxhttp:converter-fastjson:2.2.6'
    implementation 'com.ljx.rxhttp:converter-protobuf:2.2.6'
    implementation 'com.ljx.rxhttp:converter-simplexml:2.2.6'
}

上手教程

30 秒上手教程:https://juejin.im/post/5cfcbbcbe51d455a694f94df

掘金详细文档:https://juejin.im/post/5ded221a518825125d14a1d4

wiki 详细文档:https://github.com/liujingxing/okhttp-RxHttp/wiki (此文档会持续更新)

协程文档:RxHttp ,比 Retrofit 更优雅的协程体验

自动关闭请求用到的 RxLife 类,详情请查看RxLife 库

更新日志      已知问题      Java 工程依赖注意事项

混淆

如开启混淆,请在 proguard-rules.pro 文件添加以下代码

# RxHttp
-keep class rxhttp.**{*;}
# OkHttp
-keep class okhttp3.**{*;}
-keep class okio.**{*;}

小技巧

在这教大家一个小技巧,由于使用 RxHttp 发送请求都遵循请求三部曲,故我们可以在 android studio 设置代码模版,如下

image

如图设置好后,写代码时,输入 rp,就会自动生成模版,如下:

image

Demo 演示

更多功能,请下载 Demo 体验

Donations

如果它对你帮助很大,并且你很想支持库的后续开发和维护,那么你可以扫下方二维码随意打赏我,就当是请我喝杯咖啡或是啤酒,开源不易,感激不尽

image

Licenses

Copyright 2019 liujingxing

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.
Apps
About Me
GitHub: Trinea
Facebook: Dev Tools