一个简单强大且灵活的MVP框架。 项目地址:EasyMvpjava
(以简单的登录注册为例)git
public interface LoginView extends BaseMvpView {
void loginSuccess();
}
复制代码
public class LoginPresenter extends BasePresenter<LoginView> {
public void login() {
mView.loginSuccess();
}
}
复制代码
@CreatePresenter(presenter = LoginPresenter.class)
public class ExampleActivity3 extends BaseMvpActivity<LoginPresenter> implements LoginView {
@Override
protected int getContentView() {
return R.layout.activity_main;
}
@Override
public void init() {
getPresenter().login();
}
@Override
public void loginSuccess() {
Log.i("ExampleActivity1", "登录成功");
}
}
复制代码
其中在 Activity 中,Presenter 实例的获取方法能够有上面代码所示的经过 getPresenter 来获取,这种方法须要在 BaseMvpActivity 后面 填入泛型参数你的 Presenter 实现类,好比上面所示的 LoginPresenter。 除了这种方法,也能够经过注解的方式获取实例:github
@CreatePresenter(presenter = LoginPresenter.class)
public class ExampleActivity3 extends BaseMvpActivity implements LoginView {
@PresenterVariable
private LoginPresenter mLoginPresenter;
@Override
protected int getContentView() {
return R.layout.activity_main;
}
@Override
public void init() {
mLoginPresenter.login();
}
@Override
public void loginSuccess() {
Log.i("ExampleActivity1", "登录成功");
}
}
复制代码
若是不喜欢注解,还能够经过直接获取的方式获取:数组
@CreatePresenter(presenter = LoginPresenter.class)
public class ExampleActivity3 extends BaseMvpActivity implements LoginView {
private LoginPresenter mLoginPresenter;
@Override
protected int getContentView() {
return R.layout.activity_main;
}
@Override
public void init() {
mLoginPresenter = getPresenterProviders().getPresenter(0);
mLoginPresenter.login();
}
@Override
public void loginSuccess() {
Log.i("ExampleActivity1", "登录成功");
}
}
复制代码
经过 getPresenterProviders().getPresenter(int index) 方法获取,传入的参数是你经过 @CreatePresenter 注解传入的 class 对象的 数组下标,这里由于只有一个 Presenter, 因此传 0 便可。框架
多个 Presenter 的状况前两个步骤跟上面同样,主要是在 Activity 绑定这边有些区别:ide
@CreatePresenter(presenter = {LoginPresenter.class, RegisterPresenter.class})
public class ExampleActivity1 extends BaseMvpActivity implements LoginView, RegisterView {
@PresenterVariable
private LoginPresenter mLoginPresenter;
@PresenterVariable
private RegisterPresenter mRegisterPresenter;
@Override
protected int getContentView() {
return R.layout.activity_main;
}
@Override
public void init() {
//也能够经过这种方式去获取实例
//mLoginPresenter = getPresenterProviders().getPresenter(0);
//mRegisterPresenter = getPresenterProviders().getPresenter(1);
mLoginPresenter.login();
mRegisterPresenter.register();
}
@Override
public void loginSuccess() {
Log.i("ExampleActivity1", "登录成功");
}
@Override
public void registerSuccess() {
Log.i("ExampleActivity1", "注册成功");
}
}
复制代码
如上所示,假如一个 Activity 中须要同时用到 LoginPresenter 和 RegisterPresenter 中的某些方法,只须要使用注解 @CreatePresenter 依次传入它们的 class 对象便可完成绑定。一样地为了获得各个 Presenter 的实例,能够经过 @PresenterVariable 注解去获取,固然若是不喜欢用注解,也能够经过 getPresenterProviders().getPresenter(int index) 方法去获取哦。this
并非全部地方都须要用到 Mvp,当不须要用的时候,其实也没什么特别,就正经常使用就行:spa
public class ExampleActivity4 extends BaseMvpActivity {
@Override
protected int getContentView() {
return R.layout.activity_main;
}
@Override
public void init() {
}
}
复制代码
上面例子中有用到 BasePresenter, BaseMvpView, BaseMvpActivity 等一些基础类,这里给出一种例子,用户可根据本身须要去编写。.net
BaseMvpView 是基础的 View 层接口:code
public interface BaseMvpView {
void showError(String msg);
void complete();
void showProgressUI(boolean isShow);
}
复制代码
能够看到就是定义了一些公共的接口方法。其实这个接口能够不须要,可是通常为了方便,就写上吧。
BasePresenter 就是基础的 BasePresenter 了,做用也是实现一些公共的 Presenter 接口方法:
public class BasePresenter <V> {
protected Context mContext;
protected V mView;
protected void onCleared() {
}
public void attachView(Context context, V view) {
this.mContext = context;
this.mView = view;
}
public void detachView() {
this.mView = null;
}
public boolean isAttachView() {
return this.mView != null;
}
public void onCreatePresenter(@Nullable Bundle savedState) {
}
public void onDestroyPresenter() {
this.mContext = null;
detachView();
}
public void onSaveInstanceState(Bundle outState) {
}
}
复制代码
里面实现一些公共的 Presenter 方法,通常像 attachView,detachView ,isAttachView 等方法是必定要实现的,由于这些与生命周期绑定有关,能够作资源的赋值和释放等操做。
这个你们都知道,就是 Activity 的基类了,看看它的一种实现:
public abstract class BaseMvpActivity<P extends BasePresenter> extends AppCompatActivity implements BaseMvpView {
private PresenterProviders mPresenterProviders;
private PresenterDispatch mPresenterDispatch;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(getContentView());
mPresenterProviders = PresenterProviders.inject(this);
mPresenterDispatch = new PresenterDispatch(mPresenterProviders);
mPresenterDispatch.attachView(this, this);
mPresenterDispatch.onCreatePresenter(savedInstanceState);
init();
}
@Override
protected void onSaveInstanceState(Bundle outState) {
super.onSaveInstanceState(outState);
mPresenterDispatch.onSaveInstanceState(outState);
}
protected abstract int getContentView();
public abstract void init();
protected P getPresenter() {
return mPresenterProviders.getPresenter(0);
}
public PresenterProviders getPresenterProviders() {
return mPresenterProviders;
}
@Override
public void showError(String msg) {
}
@Override
public void complete() {
}
@Override
public void showProgressUI(boolean isShow) {
}
@Override
protected void onDestroy() {
super.onDestroy();
mPresenterDispatch.detachView();
}
}
复制代码
BaseMvpActivity 后面定义的泛型 P 主要是为了一个 Presenter 的时候使用 getPresenter() 方法时用到的,代码如上面例子所示。能够看看 getPresenter() 的实现:
protected P getPresenter() {
return mPresenterProviders.getPresenter(0);
}
复制代码
也只是调用了 PresenterProviders.getPresenter(int index) 方法而已。
而后 BaseMvpActivity 实现了 BaseMvpView 接口,默认实现了一些公共方法,当你继承它的时候,须要能够重写他们。
主要说一下 PresenterProviders,这个类的做用是解析用到的注解以及完成绑定和解绑 View 等一些公共的 Presenter 操做。
public static PresenterProviders inject(Context context) {
return new PresenterProviders(context);
}
private PresenterProviders(Context context) {
mContext = checkContext(context);
resolveCreatePresenter();
resolvePresenterVariable();
}
复制代码
下面简单分析一下 PresenterProviders 具体实现:
关于注解的知识,能够看这篇文章,看完应该就懂了:深刻理解Java注解类型(@Annotation)
PresenterStore 类: 这个类的主要做用就是将 Presenter 的实例存储起来,用的是 HashMap 实现:
private static final String DEFAULT_KEY = "PresenterStore.DefaultKey";
private final HashMap<String, P> mMap = new HashMap<>();
public final void put(String key, P presenter) {
P oldPresenter = mMap.put(DEFAULT_KEY + ":" + key, presenter);
if (oldPresenter != null) {
oldPresenter.onCleared();
}
}
public final P get(String key) {
return mMap.get(DEFAULT_KEY + ":" + key);
}
public final void clear() {
for (P presenter : mMap.values()) {
presenter.onCleared();
}
mMap.clear();
}
复制代码
由于须要处理的是一个或多个 Presenter 对象,因此这样作的目的是为了能够统一管理和查找。
public <P extends BasePresenter> PresenterProviders resolveCreatePresenter() {
CreatePresenter createPresenter = mContext.getClass().getAnnotation(CreatePresenter.class);
if (createPresenter != null) {
Class<P>[] classes = (Class<P>[]) createPresenter.presenter();
for (Class<P> clazz : classes) {
String canonicalName = clazz.getCanonicalName();
try {
mPresenterStore.put(canonicalName, clazz.newInstance());
} catch (InstantiationException e) {
e.printStackTrace();
} catch (IllegalAccessException e) {
e.printStackTrace();
}
}
}
return this;
}
复制代码
resolveCreatePresenter() 方法主要的做用是解析 @CreatePresenter 注解,过程是这样的:首先获取到注解上全部定义的 class 对象数组 classes,而后 循环,取它们的 canonicalName 做为 key ,调用 newInstance 方法实例化后做为 value 存入上面说到的 HasMap 中。
接下来是 resolvePresenterVariable 方法:
public <P extends BasePresenter> PresenterProviders resolvePresenterVariable() {
for (Field field : mContext.getClass().getDeclaredFields()) {
//获取字段上的注解
Annotation[] anns = field.getDeclaredAnnotations();
if (anns.length < 1) {
continue;
}
if (anns[0] instanceof PresenterVariable) {
String canonicalName = field.getType().getName();
P presenterInstance = (P) mPresenterStore.get(canonicalName);
if (presenterInstance != null) {
try {
field.setAccessible(true);
field.set(mContext, presenterInstance);
} catch (IllegalAccessException e) {
e.printStackTrace();
}
}
}
}
return this;
}
复制代码
resolvePresenterVariable 方法主要的做用就是为将用 @PresenterVariable 注解标记的对象在 HashMap 中找到对应的实例,并赋值。过程是这样的,首先经过 getDeclaredFields 获取类上因此的变量的 Field,而后判断若是该变量有标记 @PresenterVariable 注解的话,就取它的 Type 对应的 Name,这个 Name 的值是会与 canonicalName 同样的,因此就能够经过它做为 key 在 HashMap 中查找对应的实例,找到后经过 Field 的 set 方法给变量赋值。
还有一个类 PresenterDispatch :
能够看到 attachView 和 detachView 等一些操做都是经过它来完成的,之因此须要这个类,是为了隔离开 PresenterProviders 和 PresenterStore,省得耦合。
public class PresenterDispatch {
private PresenterProviders mProviders;
public PresenterDispatch(PresenterProviders providers) {
mProviders = providers;
}
public <P extends BasePresenter> void attachView(Context context, BaseContract.View view) {
PresenterStore store = mProviders.getPresenterStore();
HashMap<String, P> mMap = store.getMap();
for (Map.Entry<String, P> entry : mMap.entrySet()) {
P presenter = entry.getValue();
if (presenter != null) {
presenter.attachView(context, view);
}
}
}
public <P extends BasePresenter> void detachView() {
PresenterStore store = mProviders.getPresenterStore();
HashMap<String, P> mMap = store.getMap();
for (Map.Entry<String, P> entry : mMap.entrySet()) {
P presenter = entry.getValue();
if (presenter != null) {
presenter.detachView();
}
}
}
...
}
复制代码
能够看到他里面是拿到了 PresenterProviders 对象,而后再拿到存储了 Presenter 实例的 HashMap,而后再进行操做。其余一些公共实现也能够这样作。
整个过程就完成了,是否是很简单。在实际的运用过程当中能够根据本身额须要作对应的修改。 喜欢就给个 Star 吧,欢迎留言提 Issues 和建议。