基于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