RxHttp 全网Http缓存最优解

9,981 阅读9分钟

1、前言

距离上一文RxHttp 让你眼前一亮的Http请求框架的发表,已过去两周,文章一经发表,RxHttp就收获了众多的好评,Github上Star数,也正式突破了1000,这对于我来说,是非常有动力的事情,感谢大家的支持,我再接再厉。

也有很多人跟说我,希望RxHttp能支持协程和缓存这两大功能,这不,非常好用的缓存功能就来了,看完本文,相信你会再一次爱上RxHttp。另外,协程也已经在路上了,这个需要多一点的时间,大家耐心等待。

如果你喜欢RxHttp,欢迎进QQ群交流:378530627 (RxHttp&RxLife交流群)

gradle依赖

1、必选

jitpack添加到项目的build.gradle文件中,如下:

allprojects {
    repositories {
        maven { url "https://jitpack.io" }
    }
}

注:RxHttp 2.6.0版本起,已全面从JCenter迁移至jitpack

//使用kapt依赖rxhttp-compiler时必须
apply plugin: 'kotlin-kapt'

android {
    //必须,java 8或更高
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

dependencies {
    def rxhttp_version = '3.2.6'
    implementation 'com.squareup.okhttp3:okhttp:4.11.0' 
    implementation "com.github.liujingxing.rxhttp:rxhttp:$rxhttp_version"
    kapt "com.github.liujingxing.rxhttp:rxhttp-compiler:$rxhttp_version" //生成RxHttp类,纯Java项目,请使用annotationProcessor代替kapt
 }

2、可选

android {
    kapt {
        arguments {
            //依赖了RxJava时,rxhttp_rxjava参数为必须,传入RxJava版本号
            arg("rxhttp_rxjava", "3.1.6")  
            arg("rxhttp_package", "rxhttp")  //指定RxHttp类包名,非必须
        }
    }
    //如果项目未集成kotlin,通过javaCompileOptions方法传参,在defaultConfig标签下
    annotationProcessorOptions {
        arguments = [
            rxhttp_rxjava: '3.1.6',
            rxhttp_package: 'rxhttp'
        ]
    }
}
dependencies {    
    //rxjava2   (RxJava2/Rxjava3二选一,使用asXxx方法时必须)
    implementation 'io.reactivex.rxjava2:rxjava:2.2.8'
    implementation 'io.reactivex.rxjava2:rxandroid:2.1.1'
    implementation 'com.github.liujingxing.rxlife:rxlife-rxjava2:2.2.2' //管理RxJava2生命周期,页面销毁,关闭请求

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

    //非必须,根据自己需求选择 RxHttp默认内置了GsonConverter
    implementation "com.github.liujingxing.rxhttp:converter-serialization:$rxhttp_version"
    implementation "com.github.liujingxing.rxhttp:converter-fastjson:$rxhttp_version"
    implementation "com.github.liujingxing.rxhttp:converter-jackson:$rxhttp_version"
    implementation "com.github.liujingxing.rxhttp:converter-moshi:$rxhttp_version"
    implementation "com.github.liujingxing.rxhttp:converter-protobuf:$rxhttp_version"
    implementation "com.github.liujingxing.rxhttp:converter-simplexml:$rxhttp_version"
}

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

2、设置全局缓存策略

通过RxHttpPlugins.setCache(File, long, CacheMode, long)静态方法,设置全局缓存策略,如下:

public void initRxHttpCahce(Concent contet) {     
    //设置缓存目录为:Android/data/{app包名目录}/cache/RxHttpCache    
    File cacheDir = new File(context.getExternalCacheDir(), "RxHttpCache"); 
    //设置最大缓存为10M,缓存有效时长为60秒 
    RxHttpPlugins.setCache(cacheDir, 10 * 1024 * 1024, CacheMode.REQUEST_NETWORK_FAILED_READ_CACHE, 60 * 1000); 
}

以上代码,通过setCache方法,配置了以下4个参数:

cacheDir:缓存存储目录,路径为:Android/data/{app包名目录}/cache/RxHttpCache

maxSize:缓存最大Size,最大为10M,超过这个size,内部会根据LRU算法,将最少使用的缓存自动清除

CacheMode:全局缓存模式,这里为,先请求网络,失败后,再读取缓存

cacheVaildTime:全局缓存有效时长,为60秒

其中第三个参数,就是设置全局缓存模式。

RxHttp内部共提供了5种缓存模式,如下:

  1. ONLY_NETWORK

    该模式下,仅请求网络,不处理缓存;这是RxHttp默认的缓存模式

  2. ONLY_CACHE

    该模式下,仅读取缓存,读取成功,直接返回;否则直接抛出异常

  3. NETWORK_SUCCESS_WRITE_CACHE

    该模式下,直接请求网络,若请求成功,则写入缓存并返回;否则直接返回

  4. READ_CACHE_FAILED_REQUEST_NETWORK

    该模式下,先读取缓存,读取成功,直接返回;否则将请求网络(请求成功,写入缓存)

  5. REQUEST_NETWORK_FAILED_READ_CACHE

    该模式下,先请求网络,请求成功,写入缓存并返回;否则读取缓存

3、设置单个请求的缓存策略

通过Rxhttp#setCache(CacheMode)为单个请求设置单独的缓存策略,如下:

RxHttp.get("/service/...")
    .setCacheValidTime(10 * 1000) //当前请求缓存有效期为10秒
    .setCache(CacheMode.READ_CACHE_FAILED_REQUEST_NETWORK) //当前请求先读取缓存,失败后,再请求网络
    .toObservableString()
    .subscribe(s -> {
        //成功回调            
    }, throwable -> {
        //失败回调          
    });              

以上代码,为单个请求设置了单独的缓存策略,其中有效时长为10秒,缓存模式为先读取缓存,失败后,再请求网络。如果不设置,将使用全局的缓存策略。

注:设置单独的缓存模式/缓存有效时长前,一定要设置缓存存储目录和缓存最大Size,否则无效

4、关于CacheKey

CacheKey在RxHttp的缓存模块中,是一个很重要的角色,内部缓存的读写、删除都是通过CacheKey来操作的。对于不相同的请求,要保证CacheKey的唯一性;对于相同的请求,要保证CacheKey的静态性,这两个特性非常重要,一定要保证,否则缓存将变得毫无意义。

为啥这么说,请往下看。

4.1、内部CacheKey的生成规则

RxHttp内部会根据一定规则,为每个请求,都生成一个具有唯一性的CacheKey,规则如下:

NoBodyParam

将添加的参数拼接在url后面,如:CacheKey = url?key=value&key1=value1... ,Get、Head类型请求遵循这个规则

FormParam

同NoBodyParam,将添加的参数拼接在url后面,如:CacheKey = url?key=value&key1=value1... , xxxForm类型请求遵循这个规则

JsonParam

将添加的参数转换成Json字符串jsonStr后,添加到url后面,如:CacheKey = url?json=jsonStr , xxxJson类型请求遵循这个规则

JsonArrayParam

同JsonParam,将添加的参数转换成Json字符串jsonStr后,添加到url后面,如:CacheKey = url?json=jsonStr, xxxJsonArray类型请求遵循这个规则

以上4个规则,可在对应的Param类中getCacheKey()方法查看

4.2、自定义CacheKey

如果以上规则不能满足你的业务需求,RxHttp还提供了两种自定义CacheKey的方式,如下:

1、通过RxHttp#setCacheKey(String)方法,为单个请求指定CacheKey

RxHttp.get("/service/...")
    .setCacheKey("自定义的CacheKey")  //自定义CacheKey
    .toObservableString()
    .subscribe(s -> {
       //成功回调
    }, throwable -> {
       //失败回调
    });

2、通过自定义Param,并重写getCacheKey()方法,为某一类请求制定CacheKey的生成规则,如下:

@Param(methodName = "postEncryptForm")
public class PostEncryptFormParam extends FormParam {

    public PostEncryptFormParam(String url) {
        super(url, Method.POST);
    }

    @Override
    public String getCacheKey() {
        String cacheKey = null;
        String simpleUrl = getSimpleUrl(); //拿到Url
        Headers headers = getHeaders();//拿到添加的请求头
        List<KeyValuePair> keyValuePairs = getQueryParam(); //拿到添加的参数
        cacheKey = "根据url/请求头/参数,自定义规则,生成CacheKey";
        return cacheKey;
    }
}

注:自定义CacheKey,一定要保证CacheKey的唯一性,若重复,将覆盖已存在的缓存

4.3、唯一性

唯一性,就是要保证不同的请求都具有不同的CacheKey。若相同,就会造成缓存错乱

举个例子:

有A、B两个不同的请求,CacheKey、缓存模式均一样,缓存模式为READ_CACHE_FAILED_REQUEST_NETWORK,即先读缓存,失败后,再请求网络。

此时,A先发请求,步骤为:读缓存失败—>请求网络—>请求成功,写入缓存—>结束;

随后B发起请求,步骤为:读缓存成功—>结束;

因为A和B的CacheKey是一样的,所以B读缓存时,读到的就是A的。而且,如果B的缓存模式为REQUEST_NETWORK_FAILED_READ_CACHE,此时,如果B请求成功,写缓存时,因为CacheKey一样,就会把A的缓存覆盖掉,下次A读取缓存时,读的就是B的缓存,这就是我说的缓存错乱

4.4、静态性

何为静态性?我对它的定义是:同一个请求,发送多次,要保证CacheKey是一致的,否则,缓存将毫无意义。

试想,我们有这样一种情况,每次发送请求,都要带上当前的时间戳,如下:

RxHttp.get("/service/...")   
    .add("currentTime", System.currentTimeMillis()) 
    .setCache(CacheMode.READ_CACHE_FAILED_REQUEST_NETWORK) //当前请求先读取缓存,失败后,再请求网络
    .toObservableString()    
    .subscribe(s -> {       
      //成功回调    
    }, throwable -> {       
      //失败回调    
    });

上面的代码,每次发起请求,时间戳都不一样,就导致内部每次生成的CacheKey也不一样,从而造成每次都会写入相同的缓存而不覆盖,更严重的是,每次读取缓存都会失败,那我们如何避免这种情况呢?有,前面介绍的,自定义Cachekey就能解决这个问题,那还有没有更简单的办法呢?也有,往下看。

剔除不参与CacheKey组拼的参数

我们可以调用RxHttpPlugins.setExcludeCacheKeys(String... keys)方法,设置不参与CacheKey组拼的参数,即剔除这些参数。对于上面的问题,就可以这么做:

RxHttpPlugins.setExcludeCacheKeys("currentTime")  //可变参数,可传入多个key

此时,发送请求,当前时间戳就不会参与CacheKey的组拼,从而保证了每次发起请求,CacheKey都是一样的,这就是我说的静态性

5、扩展

到这,也许有人会问我,我有这么一种业务场景:打开app,列表先展示缓存的数据,随后再请求网络,拉取最新的数据,用RxHttp如何实现?

对于这种场景,我们需要这样一种缓存模式,即:先读取缓存,不管成功与否,都继续请求网络。然而,RxHttp的5中缓存模式中,没有这样一种模式,怎么办?既然提出来了,肯定有办法,通过两种模式的组合来实现这个场景,如下:

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main_activity);
        //发送一个仅读取缓存的请求
        requestData(CacheMode.ONLY_CACHE);  
        //接着在发送一个请求网络,成功后写缓存的请求
        requestData(CacheMode.NETWORK_SUCCESS_WRITE_CACHE);
    }

    //获取数据
    public void requestData(CacheMode cacheMode) {
        RxHttp.get("/service/...")
            .setCacheMode(cacheMode)
            .toObservableString()
            .to(RxLife.toMain(this))  //感知生命周期,并在主线程回调
            .subscribe(s -> {
                //成功回调
                if (cacheMode == CacheMode.ONLY_CACHE) {
                    //缓存读取成功回调
                } else if (cacheMode == CacheMode.NETWORK_SUCCESS_WRITE_CACHE) {
                    //请求网络成功回调
                }
            }, throwable -> {

            });
    }
}

上面代码中,我们发送了两个请求,两个请求分别为CacheMode.ONLY_CACHECacheMode.NETWORK_SUCCESS_WRITE_CACHE这两种缓存模式,随后,在成功回调里,根据缓存模式的不同,执行不同的业务逻辑即可。

那RxHttp为什么不增加一种缓存模式,直接支持这种业务场景呢?原因有2个:

1、如果直接支持的话,就必须要增加一个缓存读取成功的回调,这样会破坏RxHttp现有的代码结构

2、个人感觉,组合的方式,比起增加一个缓存读取成功的回调,代码更加的简洁,学习成本更低

当然,对于直接支持,后续如果想到更好的方案,一定会加入,如果你有好方案,记得分享。

6、小结

其实,前面讲了这么做,RxHttp缓存功能的使用只需要2步的,

  • 第一步,设置一个缓存存储目录和缓存最大Size,如果需要,还可以设置全局缓存模式和缓存有效时长
  • 第二步,发请求时,设置对应的缓存模式即可,如果使用全局缓存模式,这一步还可以跳过

最后,喜欢的,请给本文点个赞,如果可以,还请给个star,创作不易,感激不尽。🙏🙏🙏

协程正在路上,需要多一点的时间,请耐心等待。。