PureMVC_AppFacade_Android
這庫是一個輕量級MVC為Android軟件從頭開始架構的,特點是輕、解耦、模塊化,業務分離,簡單實用
該庫的設計主要有 Facade、Observer等,以及熱插拔特性,充分給了我開發者注重業務開發邏輯注意力,而不用在意邏輯的分離與耦合
How To Get Started:
第一步 初始化自定義模塊控制類:用于注冊模塊和解注冊模塊
AppModuleController:
初始化和創建 AppModuleController, 它繼承自 Controller
public class AppModuleController extends Controller {
@Override
public void registerAllModules() {
super.registerAllModules();
//這里注冊對應模塊
this.addOnceModuleClass(RunsUserLoginModule.class);
this.addOnceModuleClass(RunsHomePageModule.class);
}
@Override
public void unRegisterAllModules() {
super.unRegisterAllModules();
//這里解注冊對應模塊(最好位置與注冊對應)
this.removeModule(RunsUserLoginModule.class.getName());
this.removeModule(RunsHomePageModule.class.getName());
}
}
public class MainActivity extends AppCompatActivity {
private ActivityMainBinding activityMainBinding = null;
public MainActivity() {
super();
//初始化調用 注冊模塊到模塊管理類
Facade.getInstance().init(new AppModuleController());
}
}
第二步 創建模塊文件夾目錄(如圖)
至于每個模塊分別是什么職責一目了然
模塊結構圖
模塊目錄圖
第三步 創建對應的功能模塊,比如登錄、主頁等
RunsUserLoginModule
初始化和創建 RunsUserLoginModule, 它繼承自 Module, 注冊該模塊需要的Mediator,ViewModel, 以及移除解注冊.
public class RunsUserLoginModule extends Module {
@Override
public void onRegister() {
this.registerMediatorClass(RunsUserLoginMediator.class);
this.registerMediatorClass(RunsUserRegisterMediator.class);
//
this.registerViewModelClass(RunsUserLoginViewModel.class);
}
@Override
public void onRemove() {
this.removeAllMediator();
this.removeAllViewModel();
}
}
public class RunsUserLoginMediator extends Mediator {
@Override
public void initializeMediator() {
super.initializeMediator();
}
@Override
public void handleNotification(INotification notification) {
super.handleNotification(notification);
String notificationName = notification.getName();
if (notificationName.equals(Runs.BIND_VIEW_COMPONENT)) {
Object object = notification.getObject();
if (null != object) {
this.setViewComponent(object);
Toast.makeText((Context)object, Runs.BIND_VIEW_COMPONENT, Toast.LENGTH_SHORT).show();
}
return;
}
if (notificationName.equals(Runs.USER_LOGIN_NOTIFICATION)) {
...
return;
}
if (notificationName.equals(Runs.USER_REGISTER_NOTIFICATION)){
...
return;
}
if (notificationName.equals(Runs.USER_LOGOUT_NOTIFICATION)) {
...
return;
}
}
@Override
public String[] listNotificationInterests() {
return new String[]{
Runs.BIND_VIEW_COMPONENT,
Runs.USER_LOGIN_NOTIFICATION,
Runs.USER_LOGOUT_NOTIFICATION,
Runs.USER_REGISTER_NOTIFICATION };
}
}
public abstract class Runs {
public static final IFacade FACADE = Facade.getInstance();
//RunsUserLoginMediator
public static final String BIND_VIEW_COMPONENT = "BIND_VIEW_COMPONENT";
public static final String USER_LOGIN_NOTIFICATION = "USER_LOGIN_NOTIFICATION";
public static final String USER_LOGOUT_NOTIFICATION = "USER_LOGOUT_NOTIFICATION";
public static final String USER_REGISTER_NOTIFICATION = "USER_REGISTER_NOTIFICATION";
//RunsUserRegisterMediator
public static final String BIND_REGISTER_COMPONENT = "BIND_REGISTER_COMPONENT";
public static final String USER_BIND_PHONE_NOTIFICATION = "USER_BIND_PHONE_NOTIFICATION";
public static final String USER_REGISTER_DONE_NOTIFICATION = "USER_REGISTER_DONE_NOTIFICATION";
}
public class RunsUserLoginViewModel extends ViewModel {
@Override
public void setModel(Object model) {
super.setModel(model);
}
@Override
public void initializeViewModel() {
super.initializeViewModel();
}
}
Usage:
1.根據注冊名(Java中反射獲取Class字符串)獲取對應 Mediator(不常用)
String className = RunsUserLoginMediator.class.getName();
RunsUserLoginMediator mediator = (RunsUserLoginMediator)Runs.FACADE.getMediatorWithName(className);
2.根據注冊名(Java中反射獲取Class字符串)獲取對應 ViewModel(常用)
String className = RunsUserLoginViewModel.class.getName();
IViewModel viewModel = Runs.FACADE.getViewModelWithName(className);
3.核心用法,消息派發.通過sendNotification方法,發出的消息會被對應監聽的Mediator收聽到而做對應的邏輯處理(核心)
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
Runs.FACADE.sendNotification(Runs.BIND_VIEW_COMPONENT, this);
activityMainBinding = DataBindingUtil.setContentView(this, R.layout.activity_main);
activityMainBinding.login.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Runs.FACADE.sendNotification(Runs.USER_LOGIN_NOTIFICATION);
Intent intent = new Intent(MainActivity.this, RunsUserLoginActivity.class);
startActivity(intent);
}
});
activityMainBinding.register.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Runs.FACADE.sendNotification(Runs.USER_REGISTER_NOTIFICATION);
}
});
activityMainBinding.logout.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Runs.FACADE.sendNotification(Runs.USER_LOGOUT_NOTIFICATION);
}
});
}
Download
You can download a jar from GitHub's releases page.
Gradle:
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
dependencies {
compile 'com.github.RunsCode:AppFacadeMVC:v1.0.0'
}
Maven:
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
<dependency>
<groupId>com.github.RunsCode</groupId>
<artifactId>AppFacadeMVC</artifactId>
<version>v1.0.0</version>
</dependency>