RetrofitCache：让Retrofit2+OkHttp3缓存配置如此简单的终极解决方案

2026/8/8 19:45:03 拓冰建站浏览量

RetrofitCache：让Retrofit2+OkHttp3缓存配置如此简单的终极解决方案

【免费下载链接】RetrofitCacheRetrofitCache让retrofit2+okhttp3+rxjava配置缓存如此简单。通过注解配置，可以针对每一个接口灵活配置缓存策略；同时让每一个接口方便支持数据模拟，可以代码减小侵入性，模拟数据可以从内存，Assets，url轻松获取。项目地址: https://gitcode.com/gh_mirrors/re/RetrofitCache

RetrofitCache是一款专为Android开发者打造的缓存解决方案，它让Retrofit2+OkHttp3+RxJava的缓存配置变得前所未有的简单。通过注解配置，开发者可以针对每一个接口灵活定制缓存策略，同时轻松支持数据模拟功能，模拟数据可从内存、Assets或URL获取，极大减小了代码侵入性。

为什么选择RetrofitCache？ 🚀

在移动应用开发中，网络请求的缓存管理和数据模拟是提升用户体验的关键环节。传统的缓存配置往往需要编写大量重复代码，而RetrofitCache通过以下特性解决了这些痛点：

注解驱动：使用简单的注解即可完成复杂的缓存策略配置
灵活缓存：支持针对不同接口设置不同的缓存时间和策略
数据模拟：轻松实现接口数据模拟，支持多种数据源
低侵入性：最小化对现有代码的改动，快速集成

快速开始：RetrofitCache的基础配置

1️⃣ 初始化配置

只需一行代码即可完成RetrofitCache的初始化：

RetrofitCache.getInstance().init(this);

如果需要设置默认的缓存时间，可以这样配置：

RetrofitCache.getInstance().init(this) .setDefaultTimeUnit(TimeUnit.MINUTES) .setDefaultTime(1);

2️⃣ 添加Retrofit实例

将Retrofit实例添加到RetrofitCache管理：

RetrofitCache.getInstance().addRetrofit(retrofit);

核心功能：注解式缓存配置

接口级缓存控制

RetrofitCache最强大的功能之一就是通过@Cache注解实现接口级别的缓存控制。例如，下面的代码将接口缓存时间设置为10秒：

@Cache(time = 10, timeUnit = TimeUnit.SECONDS) @GET("api/data/Android/10/1") Observable<HttpResult<List<GankAndroid>>> getGankAndroid();

这行代码位于app/src/main/java/ren/yale/android/retrofitcachetest/rx2/ApiRx2.java文件中，展示了如何为RxJava2接口添加缓存注解。

高级功能：灵活的数据模拟

使用@Mock注解实现数据模拟

RetrofitCache提供了强大的数据模拟功能，通过@Mock注解可以轻松实现：

1. 从Assets文件获取模拟数据

@Mock(assets = "mock/mock.json") @GET("api/data/Android/10/1") Observable<HttpResult<List<GankAndroid>>> getGankAndroid();

模拟数据文件路径：app/src/main/assets/mock/mock.json

2. 直接指定模拟数据

@Mock(value = "{\"error\":false,\"results\":[{\"_id\":\"5941f5f3421aa92c7be61c16\",...}]}") @GET("api/data/Android/10/1") Observable<HttpResult<List<GankAndroid>>> getGankAndroid();

3. 从URL获取模拟数据

@Mock(url = "http://gank.io/api/data/Android/10/2") @GET("api/data/Android/10/1") Observable<HttpResult<List<GankAndroid>>> getGankAndroid();

实用技巧：RetrofitCache高级配置

忽略特定参数

在某些情况下，你可能需要忽略请求中的某些参数（如token），可以通过以下方式实现：

RetrofitCache.getInstance().addIgnoreParam("access_token");

启用/禁用模拟功能

RetrofitCache.getInstance().enableMock(false);

设置缓存拦截器监听器

RetrofitCache.getInstance().setCacheInterceptorListener(new CacheInterceptorListener() { @Override public String rewriteCacheControl(String cacheControl) { return "public, max-age=60"; } });

总结：RetrofitCache的优势

RetrofitCache通过简洁的API和强大的注解系统，彻底简化了Retrofit2+OkHttp3的缓存配置流程。无论是快速集成基础缓存功能，还是实现复杂的接口级缓存策略，RetrofitCache都能满足你的需求。

主要优势：

极大减少缓存配置代码量
注解式开发，提高代码可读性
灵活的数据模拟功能，加速开发测试
支持RxJava1和RxJava2

如果你正在寻找一个简单高效的Retrofit缓存解决方案，RetrofitCache绝对是你的不二之选！

如何获取

要开始使用RetrofitCache，请克隆仓库：

git clone https://gitcode.com/gh_mirrors/re/RetrofitCache

项目结构清晰，主要库代码位于以下目录：

retrofitcachelib/ - 核心库
retrofitcachelibrx2/ - RxJava2支持库

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

建站实战干货

RetrofitCache：让Retrofit2+OkHttp3缓存配置如此简单的终极解决方案