Super cool library for Android to manage database caching and networking with ease. It helps you to handle all scenario of API request(success/error/loading) in one place along with database caching. It's inspired from Goolge's Github Browser Sample. It's built on top of Retrofit and use powerful and elegant kotlin flow api.
You can find companion medium article here
Add JitPack to your project level build.gradle file
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
Add Gradle dependency as
dependencies {
implementation 'com.github.hadiyarajesh:flower:1.0.0'
}
Prerequisite
- Your Dao method must return
Flow<YourModelClass> - Your api method must return
Flow<ApiResponse<YourModelClass>> - Add FlowCallAdapterFactory as CallAdapterFactory in your retrofit builder
1. In repository class
return the networkBoundResource() function. This function takes following functions as parameter
- fetchFromLocal - It fecth data from local database
- shouldFetchFromRemote - It decide whether network request should be made or use local persistent data if available
- fetchFromRemote - It perform network request operation
- processRemoteResponse - It process result of network response (if requires)
- saveRemoteData - It saves result of network request to local persistent database
- onFetchFailed - It handle network request failure scenario (Non HTTP 200..300 response, exceptions etc)
Sample call to networkBoundResource() should look like this
2. In view model class
Collect or transform flow to get 3 different state of on-going request, LOADING, SUCESS or ERROR
Now you can observe it in your Activity/Fragment.
Sample app is provided in this repository. You can find it here. It fetch random quote from remote api and save it to local persistent database in order to display it on UI.