一、前言
首先声明一下,没有完美的架构,只要适合自己的项目,那就是最好的架构。
本例子是MVP + Retrofit + RxJava结合的例子,但本文的重点在于讲解MVP架构,所以涉及Retrofit和RxJava的部分将直接略过,默认读者已了解这两部分内容,如有需要,请自行查阅相关资料,网上资料很多。
史上最全MVP资料合集: Android MVP 详解(上)
RxJava学习参考资料: 是时候学习RxJava了
二、MVC
早期项目中,我们会使用MVC架构来构建我们的项目,但是MVC架构的缺陷很明显,V层和C层的职责混淆不清,很容易就会写成万能的Activity,把业务逻辑、View操作等一系列功能全放到Activity中来实现。
三、MVP
MVP是MVC的进化版,它把Controller的职责从Activity/Fragment中拆分出来,作为Presenter,这样就实现了Activity/Fragment和业务逻辑的解耦,更好地解决了数据与界面的关系。
- View层: 对应于Activity/Fragment,负责View的绘制以及与用户交互
- Presenter层: 负责完成View与Model间的交互
- Model层: 实体模型、与数据进行交互,对数据进行加工处理
1. 架构图
(上图由ProcessOn在线工具绘制)
2. 类图
(上图由StarUML绘制)
四、MVP实践
1. 两个基类接口
首先定义两个接口,这两个接口分别是所有View和Presenter的基类: IBaseView
和IBasePresenter
。
-
IBaseView
中主要定义一些通用的界面方法,如显示/隐藏进度条、显示提示信息等。 -
IBasePresenter
中也可以定义一些通用的方法,如初始化方法等。
public interface IBaseView {
void showLoading();
void hideLoading();
void showMessage(String msg);
}
public interface IBasePresenter {
...
}
2. 定义契约类(接口)
使用契约类来统一管理View与Presenter的所有接口,这种方式使得View与Presenter中有哪些功能,一目了然,维护起来也很方便。
public interface CookDetailContract {
interface IView extends IBaseView {
void updateCookDetail(CookDetail cookDetail);
}
interface IPresenter extends IBasePresenter {
void getCookDetail(String apikey, String id);
}
}
-
CookDetailContract
中的IView
接口定义了该界面(功能)中所有的UI状态情况,MainAcitivty作为View层,实现了该接口,这样MainActivity
就只关注UI相关的状态更新。 -
IPresenter
接口则定义了该界面(功能)中所有的用户操作事件,CookDetailPresenter
作为Presenter层,实现了该接口,这样CookDetailPresenter
就只关注业务层的相关逻辑,UI的更新只需调用IView
的状态方法。
3. View层(Activity/Fragment)
Activity/Fragment是一个全局的控制者,负责创建View以及Presenter实例,并将二者联系起来。
在本例中,MainActivity实现了CookDetailContract.IView
接口,并在onResume()回调中创建CookDetailPresenter
实例,CookDetailPresenter的构造函数中实现了View和Presenter的关联。
在创建完Presenter后,调用Presenter的getCookDetail()方法获取相应的数据(如上图步骤①)。
在获取到Model层的数据后,Presenter通过IView中的updateCookDetail()方法返回数据(如上图步骤④),Activity获取数据后,将结果展示到界面上反馈给用户。
mCookDetailPresenter = new CookDetailPresenter(MainActivity.this, this);
mCookDetailPresenter.getCookDetail(Config.API_KEY, (id++) + "");
@Override
public void updateCookDetail(CookDetail cookDetail) {
tvName.setText(cookDetail.getName());
Picasso.with(this).load(Config.IMAGE_URL_PREFIX + cookDetail.getImg()).into(ivImage);
}
4. Presenter层
它实现了契约类中的IPresenter
接口。
Presenter翻译过来是主持人的意思,它做为MVP架构中最关键的一层,负责连接View层和Model层。比如控制显示/隐藏进度框、显示/隐藏空布局、错误布局,调用相应的Model层方法进行数据的获取,并在Model层返回数据后,将数据适配到View中展示。这样,便可以让Model层只关注数据相关的操作、也让View层只专注于界面的展示,让各个层级各司其职,相互协作。
public class CookDetailPresenter implements CookDetailContract.IPresenter {
private Context mContext;
private CookDetailContract.IView mView;
private CookDetailManager mCookDetailManager = CookDetailManager.getInstance();
public CookDetailPresenter(Context context, CookDetailContract.IView view) {
this.mContext = context;
this.mView = view;
}
@Override
public void getCookDetail(String apikey, String id) {
mView.showLoading();
mCookDetailManager.getCookDetail(apikey, id, new Callback() {
@Override
public void onSuccess(CookDetail object) {
mView.updateCookDetail(object);
mView.hideLoading();
}
@Override
public void onFail(int errorNo, String errorMsg) {
ErrorUtil.processErrorMessage(mContext, errorNo, errorMsg, mView);
mView.hideLoading();
}
});
}
}
5. Model层
Model层不只包含实体对象,更主要的功能是处理一切与数据相关的操作,如数据的获取、存储、数据状态变化都是Model层的任务,Presenter会根据需要调用该层的数据处理逻辑(如上图步骤②),如有需要,Model层会使用回调将数据传回Presenter层(如上图步骤③)。
public class CookDetailManager {
private volatile static CookDetailManager instance;
private CookDetailManager() {
}
public static CookDetailManager getInstance() {
if (instance == null) {
synchronized (CookDetailManager.class) {
if (instance == null) {
instance = new CookDetailManager();
}
}
}
return instance;
}
public void getCookDetail(String apikey, String id, final Callback callback) {
if (callback == null) {
return;
}
Retrofit retrofit = RetrofitClient.INSTANCE.getRetrofit();
ApiService apiService = retrofit.create(ApiService.class);
Observable observable = apiService.getCookDetail(apikey, id);
observable.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.subscribe(new Subscriber() {
@Override
public void onCompleted() {
}
@Override
public void onError(Throwable e) {
callback.onFail(Constants.ErrorNo.ServerError, "");
e.printStackTrace();
}
@Override
public void onNext(CookDetail respEntity) {
callback.onSuccess(respEntity);
}
});
}
}
五、总结
使用MVP架构,缺点在于需要增加很多接口类、实现类,对于刚开始接口MVP架构的人来说,增加了不少的学习成本,看着一堆的类、一堆的接口,调来调去的,刚开始肯定会看晕。
但是当你熟悉了MVP架构,并掌握了它的精髓后,会发现虽然增加了很多代码,但是整体架构变得非常清晰,代码也可以多处复用。各个类和层的职责都非常明确且单一,后期的扩展,维护都会更加容易。整体的可测试性非常的好,UI层和业务层可以分别进行单元测试。
项目代码已共享到Github:AndroidMVPArchitecture
六、效果图
六、参考资料
Android官方MVP架构项目解析
Android:“万能”Activity重构篇-牛晓伟
Android高仿微信之mvp实现(一)
RxJava 与 Retrofit 结合的最佳实践
Android MVP 详解(下)
Android MVP 实战经验
PS:欢迎关注SherlockShi博客