RxBus
Android reactive event bus that simplifies communication between Presenters, Activities, Fragments, Threads, Services, etc.
Download
dependencies {
compile 'com.github.florent37:rxbus:1.0.0'
}
RxBus in 2 steps
- Prepare subscribers
RxBus.getDefault()
.onEvent("eventName")
.doOnSubscribe(disposables::add)
.subscribe(s -> {
//called when an event "eventName" is posted
}
);
- Post event
RxBus.getDefault().post("eventName");
Messages types
rxbus.post(String) <-> rxbus.onEvent(String) rxbus.post(userInstance) <-> rxbus.onEvent(User.class)Extended Bus
- Extend RxBus for a specific usage
public class RxBusUser extends RxBus {
private static RxBusUser instance = new RxBusUser();
public static RxBusUser getInstance() {
return instance;
}
public Observable<User> onUserChanged(){
return super.onEvent(User.class);
}
public void userChanged(User user){
super.post(user);
}
public void displayUser(boolean display){
super.post(new DisplayUserCustomEvent(display));
}
public Observable<Boolean> onDisplayUser(){
return super.onEvent(DisplayUserCustomEvent.class)
.map(DisplayUserCustomEvent::displayUser);
}
protected class DisplayUserCustomEvent {
public boolean displayUser;
public DisplayUserCustomEvent(boolean displayUser) {
this.displayUser = displayUser;
}
public boolean displayUser() {
return displayUser;
}
}
}
- Register to user change
final RxBusUser rxBusUser = RxBusUser.getInstance();
rxBusUser.onUserChanged()
.doOnSubscribe(disposables::add)
.subscribe(user -> display(user));
- Post the user
RxBusUser.getInstance().userChanged(user);
Unsubscribe
-
don't forget to add the disposable to a CompositeDisposable
.doOnSubscribe(compositeDisposable::add) -
OnDestroy should call
compositeDisposable.clear()
Credits
Author: Florent Champigny http://www.florentchampigny.com/
Blog : http://www.tutos-android-france.com/
License
Copyright 2017 Florent37, Inc. 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.