Slick
A Reactive Android MVP Framework which is Slick to use.
Slick how? see it yourself :)
No need to extend anything
public class YourActivity extends AppCompatActivity implements ViewActivity {
@Presenter //<-- Just annotate your presenter
YourPresenter presenter;
@Override
protected void onCreate(Bundle savedInstanceState) {
//And call bind on the generated class with your presenter args
YourPresenter_Slick.bind(this, 123, "foo");
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_your);
}
@Override
public showMessage(String message) {
}
}
The Presenter:
public class YourPresenter extends SlickPresenter<ActivityView> {
public YourPresenter(@NonNull int code, String s) {
}
@Override
public void onViewUp(@NonNull ActivityView view) {
//view onStart
}
@Override
public void onViewDown() {
//view onStop
}
@Override
public void onDestroy() {
//only is called once when view is finishing
}
}
And a simple View interface, no need to extend anything
public interface ActivityView {
void showMessage(String message);
}
Other View types have the same logic, for more detailed instruction head to Wiki
Features:
- Supports Activity, Fragment, CustomView, and Conductor Controller
- No dark magic involved, Just simple debuggable generated code
- Retains Presenters in disposable, lifecycle-aware singletons
- Reactive support inspired by MVI and Elm architecture
- Do not need to extend any base class for your views
- Easily test presenters on JVM with junit
- Use multiple Presenter for one view
- Fully Type-safe
- Dagger ready!
Reactive MVP Features:
- Unidirectional Data Flow & Immutable ViewState
- Automatic subscription and disposing of RxJava2 streams
public class YourPresenterUni extends SlickPresenterUni<ViewActivity, ViewStateActivity> {
/** ... **/
@Override
protected void start(@NonNull ViewActivity view) {
Observable<PartialViewState<ViewStateActivity>> like = command(ViewActivity::likeMovie)
.flatMap(id -> repositoryMovies.like(id).subscribeOn(io))//call to backend
.map(PartialViewStateLiked::new);
Observable<PartialViewState<ViewStateActivity>> loadComments = command(ViewActivity::loadComments)
.flatMap(id -> repositoryComments.load(id).subscribeOn(io))
.map(PartialViewStateComments::new);
subscribe(new ViewStateActivity(Collections.emptyList(), false), merge(like, loadComments));
}
@Override
protected void render(@NonNull ViewStateActivity state, @NonNull ViewActivity view) {
if (!state.comments().isEmpty()) view.showComments(state.comments());
else view.showNoComments();
view.setLike(state.isLiked());
}
}
For more detailed guide on Reactive Features read the Wiki
Downloads
Packages are available in jcenter
// Base features
implementation 'com.mrezanasirloo:slick:1.1.5'
// Reactive features
implementation 'com.mrezanasirloo:slick-reactive:1.1.5'
implementation 'com.mrezanasirloo:slick-conductor:1.1.5'
implementation 'com.mrezanasirloo:slick-support-fragment:1.1.5'
annotationProcessor 'com.mrezanasirloo:slick-compiler:1.1.5'
Since Slick packages are not tied to a specific dependency you need to provide them.
// Conductor
implementation 'com.bluelinelabs:conductor:2.x.y'
// RxJava for Reactive Features
implementation 'io.reactivex.rxjava2:rxjava:2.x.y'
If you liked the project don't forget to start it β == β€οΈ
Licence
Copyright 2018. M. Reza Nasirloo
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.