ezhome/android-rxpresenter

A Reactive Presenter library for MVP pattern for modern Android Apps

RxPresenter

A Reactive Presenter library for MVP pattern for modern Android Apps. This library follows the lifecycle of an android app component (Activity,AppCompatActivity,Fragment, DialogFragment). Specifically relies on RxLifecycle by Trello.

---

Contents

• Usage
• Download
• Tests
• Code style
• License

Usage

This library supports only the support Activity,AppCompatActivity, Fragment and DialogFragment. In order to be able to use the library, these app components must inherit one of the followings, MvpActivity, MvpFragment

Activity

bind(activity);

Fragment

bind(fragment);

Dialog Fragment

bind(dialogFragment);

Firstly you need to define an interface which representing a View in a MVP pattern and there is a 1-to-1 relationship and two way communication between View & Presenter. In our case this interface must extends MvpView eg.

interface DemoView extends MvpView {

}

Then you need to create a Presenter in the MVP pattern. In this library the Presenter must extend RxPresenter<V> where V is the View interface which we defined above. eg.

class DemoPresenter extends RxPresenter<DemoView> {

  DemoPresenter() {
  }
 }

The corresponding android app component must implements the View interface! After that you need just to initialise the presenter and bind(component) it to Fragment or DialogFragment. eg.

Without Dependency Injection

public class DemoFragment extends MvpFragment implements DemoView {

  private Presenter presenter = new DemoPresenter();

  @Override public void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    this.presenter.bind(this);
  }
}

With Dependency Injection - Dagger2

public class DemoFragment extends MvpFragment implements DemoView {

  @Inject Presenter presenter;

  @Override public void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    //Dagger2 injection code

    this.presenter.bind(this);
  }
}

After the line this.presenter.bind(this) the Presenter starts following the Android App Component's lifecycle and specifically on onViewCreated we bound the corresponding interface View automatically without the need to do it explicitly. Then the Presenter follows the typical lifecycle methods onResume, onPause, onDestroy.

RxPresenter exposes also helper methods which will help your RxJava observables to follow the Android App Component's lifecycle (with the use of RxLifecycle by Trello).

1. By default stops emitting in FragmentEvent.DESTROY_VIEW and use a Subscriber<T> to "react"

bindLifecycle(@NonNull Observable<T> observable, Subscriber<T>... subscribers)

2. By default stops emitting in FragmentEvent.DESTROY_VIEW and use an Action1<T> to "react"

bindLifecycle(@NonNull Observable<T> observable, Action1<T> action)

3. Stops emitting on the provided FragmentEvent and use a Subscriber<T> to "react"

 bindUntilEvent(@NonNull Observable<T> observable, @NonNull FragmentEvent event, Subscriber<T>... subscribers)

4. Stops emitting on the provided FragmentEvent and use an Action1<T> to "react"

 bindUntilEvent(@NonNull Observable<T> observable, @NonNull FragmentEvent event, Action1<T> action)

Download

The project is available on jCenter. In your app build.gradle (or explicit module) you must add this:

dependencies {
  //java
  compile 'com.ezhome:rxpresenter:1.3.0'

  //kotlin
  compile 'com.ezhome:rxpresenter-kotlin:1.3.0'
}

Tests

./gradlew :rxpresenter:test

Code style

Code style used in the project is called SquareAndroid from Java Code Styles repository by Square available at: https://github.com/square/java-code-styles.

License

See the LICENSE file for license rights and limitations (Apache license 2.0).

android-rxpresenter's Issues

Make library available with AutoDispose

The RxPresenter should be also available with https://github.com/uber/AutoDispose . This task depends on #10

Make library available with kotlin

Make library available with RxJava2