Extensions to RxJava
This library allow simple implementation for some tasks in android
Usage
Add library to project dependencies.
repositories {
maven { url "https://jitpack.io" }
}
dependencies {
// snapshot version
compile 'com.github.jacek-marchwicki.rx-java-extensions:rx-extensions:master-SNAPSHOT'
compile 'com.github.jacek-marchwicki.rx-java-extensions:rx-android-extensions:master-SNAPSHOT'
// or use specific version
compile 'com.github.jacek-marchwicki.rx-java-extensions:rx-extensions:<look-on-release-tab>'
compile 'com.github.jacek-marchwicki.rx-java-extensions:rx-android-extensions:<look-on-release-tab>'
}
If you have separate project for java you can use there only rx-extensions
, and add
rx-android-extensions
to android module.
Examples
In examples we use sample rest guestbok python server
Get retrofit
- Error managment
- Automatically retry when error
- Refresh button
- In memory cache with timeout
Observable<ResponseOrError<Response>> observable = retrofitService.getItem(id)
.compose(ResponseOrError.<Response>toResponseOrErrorObservable())
.compose(MoreOperators.<Response>repeatOnError(networkScheduler))
.compose(MoreOperators.<ResponseOrError<Response>>refresh(refreshSubject))
.compose(MoreOperators.<ResponseOrError<Response>>cacheWithTimeout(networkScheduler));
Load more
- Load more
- Manage errors
- Automatically retry when error
- Refresh button
- In memory cache with timeout
final OperatorMergeNextToken<Response, Object> mergeNextToken = OperatorMergeNextToken
.create(new Func1<Response, Observable<Response>>() {
@Override
public Observable<Response> call(@Nullable final Response response) {
if (response == null) {
// Load data
return itemsService.listItems(null)
.subscribeOn(networkScheduler);
} else {
final String nextToken = response.nextToken();
if (nextToken == null) {
// detect when there is no more data
return Observable.never();
}
// return more data
final Observable<Response> apiRequest = itemsService.listItems(nextToken)
.subscribeOn(networkScheduler);
// join with previous response
return Observable.just(response).zipWith(apiRequest, new MergeTwoResponses());
}
}
});
Observable<ResponseOrError<Response>> data = loadMoreSubject
.startWith((Object) null)
.lift(mergeNextToken)
.compose(ResponseOrError.<Response>toResponseOrErrorObservable())
.compose(MoreOperators.<Response>repeatOnError(networkScheduler))
.compose(MoreOperators.<ResponseOrError<Response>>refresh(refreshSubject))
.compose(MoreOperators.<ResponseOrError<Response>>cacheWithTimeout(networkScheduler));
Get title from response
- Map error responses
- Concurent subscriptions use same response
Observable<ResponseOrError<String>> titleObservable = itemsDao.dataObservable()
.compose(ResponseOrError.map(new Func1<Response, String>() {
@Override
public String call(Response response) {
return response.title();
}
}))
.subscribeOn(networkScheduler)
.observeOn(uiScheduler)
.compose(ObservableExtensions.<ResponseOrError<String>>behaviorRefCount());
Combine errors from multiple observers
Observable<Throwable> errorObservable =
ResponseOrError.combineErrorsObservable(ImmutableList.of(
ResponseOrError.transform(titleObservable),
ResponseOrError.transform(itemsObservable)));
Combine progress from multiple observers
Observable<Boolean> progressObservable =
ResponseOrError.combineProgressObservable(ImmutableList.of(
ResponseOrError.transform(titleObservable),
ResponseOrError.transform(itemsObservable)));
Bind data to views
presenter.titleObservable()
.compose(lifecycleMainObservable.<String>bindLifecycle())
.subscribe(MoreViewActions.setTitle(toolbar));
presenter.progressObservable()
.compose(lifecycleMainObservable.<Boolean>bindLifecycle())
.subscribe(ViewActions.setVisibility(progress, View.INVISIBLE));
presenter.errorObservable()
.map(ErrorHelper.mapThrowableToStringError())
.compose(lifecycleMainObservable.<String>bindLifecycle())
.subscribe(ViewActions.setText(error));
Build instructions
./gradlew build
License
Copyright [2016] [Jacek Marchwicki <[email protected]>]
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.