一個簡單強大且靈活的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 和建議。