基于Retrofit网络框架的封装
实现功能
- get请求封装
- 请求头和参数统一配置，分开配置
- 异步统一回调接口
- 单个请求、单个界面请求、所有请求取消
- 缓存策略：在线缓存、离线缓存
- 下载
- 上传
使用
引用
compile 'com.excellence.retrofit:retrofit2:_latestVersion'
权限
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
网络请求
- 初始化 可以在Application中初始化
// 默认支持：ScalarsConverterFactory、RxJava2CallAdapterFactory
// addLog : 是否开启Log打印
// cacheEnable : 是否开启缓存，默认不开启：开启后，默认每个请求都缓存
// 单个请求的缓存控制，可设置HttpRequest.Builder#cacheEnable
// cache : 自定义缓存目录，设置缓存目录后，缓存自动开启，无需设置cacheEnable
···
new RetrofitUtils.Builder(this).baseUrl(BASE_URL).addLog(true).cacheEnable(true).build();- 创建请求
- GET
new HttpRequest.Builder().tag(this).url(REQUEST_URL).build().get();- POST
new HttpRequest.Builder().tag(this).url(REQUEST_URL).build().postForm();- 下载
new HttpRequest.Builder().tag(this).url(REQUEST_URL).build().download();- 上传
new HttpRequest.Builder().tag(this).url(REQUEST_URL).build().uploadFile();
使用注意
-
缓存默认位置
/sdcard/Android/data/YourPackageName/cache/，可以初始化时自定义 -
如果想针对单个请求，不使用缓存，可以考虑添加头信息
mHeaders.put(DOWNLOAD, DOWNLOAD)，当做下载请求，则不会使用缓存机制
混淆
###-----------保持 retrofit client 不被混淆------------
-keep class com.excellence.retrofit.RetrofitHttpService { *; }
###-----------保持 retrofit 不被混淆------------
-dontwarn retrofit2.**
-keep class retrofit2.** { *; }
-dontwarn javax.annotation.**
###-----------保持 okhttp 不被混淆------------
-dontwarn com.squareup.okhttp3.**
-keep class com.squareup.okhttp3.** { *;}
-dontwarn okio.**
版本更新
| 版本 | 描述 |
|---|---|
| 2.0.1 | 新增post-upload文件接口 2021-01-30 |
| 2.0.0 | 升级rxjava -> rxjava2 2018-12-29 |