Project Name | Stars | Downloads | Repos Using This | Packages Using This | Most Recent Commit | Total Releases | Latest Release | Open Issues | License | Language |
---|---|---|---|---|---|---|---|---|---|---|
Unpeek Livedata | 853 | 7 months ago | 16 | June 13, 2022 | 7 | Java | ||||
LiveData 数据倒灌:别问,问就是不可预期 - Perfect alternative to SingleLiveEvent, supporting multiple observers. | ||||||||||
Lives | 520 | 2 years ago | Kotlin | |||||||
Lives - Android LiveData Extensions for Kotlin and Java | ||||||||||
Liveevent | 294 | 2 years ago | 5 | June 26, 2021 | apache-2.0 | Kotlin | ||||
This library holds a class to handle single live events in Android MVVM architectural pattern. https://proandroiddev.com/livedata-with-single-events-2395dea972a8 | ||||||||||
Mvvm Databinding With Livedata Login | 58 | 3 years ago | 2 | apache-2.0 | Java | |||||
MVVM, DataBinding With LiveData - Login Example | ||||||||||
Food Ordering App Like Swiggy Uber Eats Mvvm And Room Database | 33 | 4 years ago | 2 | Java | ||||||
Food ordering app using MVVM architecture patterns, Architecture Lifecycle components and Room database. | ||||||||||
Conductor Viewmodel | 33 | 3 years ago | apache-2.0 | Java | ||||||
Adds ViewModel and LiveData support to Conductor library | ||||||||||
Archdata | 25 | 3 years ago | mit | Kotlin | ||||||
LiveData types for Publishing and Replaying Data | ||||||||||
Statefullivedata | 19 | 2 years ago | 1 | mit | Kotlin | |||||
StatefulLiveData is a lean, yet powerful tool that harnesses the capabilities of LiveData and enhances them, enabling the observer to distinguish between different states the data can be in, such as Success, Loading and Error. | ||||||||||
Slush | 19 | 3 years ago | 4 | mit | Kotlin | |||||
A simple and easy adapter for RecyclerView. You don't have to make adapters and view holders anymore. Slush will help you. | ||||||||||
Observablecollections | 18 | a year ago | Kotlin | |||||||
Observable Collectons for Android Kotlin apps. Observes adds, deletes etc. |
Add RxJava-like operators to your LiveData objects with ease, usable in Kotlin (as extension functions) and Java (as static functions to a class called Lives)
Add the dependencies to your project:
AndroidX Version
implementation 'com.snakydesign.livedataextensions:lives:1.3.0'
implementation 'android.arch.lifecycle:extensions:x.x.x' // If you are using the AndroidX version, that's fine too, as the Jetifier will take care of the conversion.
Non AndroidX Version
implementation 'com.snakydesign.livedataextensions:lives:1.2.1'
implementation 'androidx.lifecycle:lifecycle-livedata:x.x.x'
If you want to use this library on a Java project, add the following dependency:
implementation 'org.jetbrains.kotlin:kotlin-stdlib:x.x.x'
Import the functions
import com.snakydesign.livedataextensions.*
Creating LiveData
liveDataOf
: Create a LiveData object from a value (like just
in RxJava, although it immediately emits the value) val liveData = liveDataOf(2) //liveData will produce 2 (as Int) when observed
from
: Creates a LiveData that emits the value that the callable
function produces, and immediately emits it. val liveData = liveDataOf {computePI()}
emptyLiveData
: Creates an empty LiveData val liveData = emptyLiveData<Int>()
Filtering
distinct
: Emits the items that are different from all the values that have been emitted so far val originalLiveData = MutableLiveData<Int>()
val newLiveData = originalLiveData.distinct()
originalLiveData.value = 2
originalLiveData.value = 2 // newLiveData will not produce this
originalLiveData.value = 3 // newLiveData will produce
originalLiveData.value = 2 // newLiveData will not produce this
distinctUntilChanged
: Emits the items that are different from the last item val originalLiveData = MutableLiveData<Int>()
val newLiveData = originalLiveData.distinctUntilChanged()
originalLiveData.value = 2
originalLiveData.value = 2 // newLiveData will not produce this
originalLiveData.value = 3 // newLiveData will produce
originalLiveData.value = 2 // newLiveData will produce
filter
:Emits the items that pass through the predicate val originalLiveData = MutableLiveData<Int>()
val newLiveData = originalLiveData.filter { it > 2 }
originalLiveData.value = 3 // newLiveData will produce
originalLiveData.value = 2 // newLiveData will not produce this
first()
: produces a SingleLiveData that produces only one Item.take(n:Int)
: produces a LiveData that produces only the first n Items.takeUntil(predicate)
: Takes until a certain predicate is met, and does not emit anything after that, whatever the value.skip(n)
: Skips the first n values.skipUntil(predicate)
: Skips all values until a certain predicate is met (the item that actives the predicate is also emitted).elementAt(index)
: emits the item that was emitted at index
positionnonNull()
: Will never emit the nulls to the observers.defaultIfNull(value)
: Will produce the value
when null
is received.Combining
merge(List<LiveData>)
: Merges multiple LiveData, and emits any item that was emitted by any of themLiveData.merge(LiveData)
: Merges this LiveData with another one, and emits any item that was emitted by any of themconcat(LiveData...)
: Concats multiple LiveData objects (and converts them to SingleLiveData
if necessary, and emits their first item in order. (Please check the note below.)LiveData.then(LiveData)
: Concats the first LiveData with the given one. (Please check the note below.)startWith(startingValue)
: Emits the startingValue
before any other value.zip(firstLiveData, secondLiveData, zipFunction)
: zips both of the LiveDatas using the zipFunction and emits a value after both of them have emitted their values, after that, emits values whenever any of them emits a value.combineLatest(firstLiveData, secondLiveData, combineFunction)
: combines both of the LiveDatas using the combineFunction and emits a value after any of them have emitted a value.LiveData.sampleWith(otherLiveData)
: Samples the current live data with other live data, resulting in a live data that emits the last value emitted by the original live data (if any) whenever the other live data emitsTransforming
map(mapperFunction)
: Map each value emitted to another value (and type) with the given functionswitchMap(mapperFunction)
: Maps any values that were emitted by the LiveData to the given function that produces another LiveDatadoBeforeNext(OnNextAction)
: Does the onNext
function before everything actually emitting the item to the observersdoAfterNext(OnNextAction)
: Does the onNext
function after emitting the item to the observers(function) : Does the onNext
function before everything actually emitting the item to the observersbuffer(count)
: Buffers the items emitted by the LiveData, and emits them when they reach the count
as a List.scan(accumulator)
: Applies the accumulator function to each emitted item, starting with the second emitted item. Initial value of the accumulator is the first item.scan(seed, accumulator)
: Applies the accumulator function to each emitted item, starting with the initial seed.amb(LiveData...)
: Emits the items of the first LiveData that emits the item. Items of other LiveDatas will never be emitted and are not considered.toMutableLiveData()
: Converts a LiveData to a MutableLiveData with the initial value set by this LiveData's valueYou can call any function prefixed with Lives
keyword.
import com.snakydesign.livedataextensions.Lives;
LiveData<String> liveData = Lives.map(Lives.just(2), new Function1<Integer, String>() {
@Override
public Integer invoke(Integer integer) {
return String.valueOf(integer);
}
}) ;
Please note that because of design of LiveData
, after a value is emitted to an observer, and then another value is emitted, the old value is destroyed in any LiveData object. So unlike RxJava, if a new Observer is attached, It will only receive the most recent value.
So If you want to use operators like concat
, you have to consider allowing only one observer to the LiveData.
PRs are more than welcome, and please file an issue If you encounter something .
You can also ping me on twitter @TheSNAKY.
Copyright 2018 Adib Faramarzi.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.