34.Android MVC框架 - Robotlegs4Androird

---

Android 耦合的MVC

说到Android上的MVC，还真的不好区分。很多时候都是这样的，View层和Controller层总是傻傻分不清楚。

Model层显而易见的是各种bean（实体），配上 gson 或者 fastjson 解析网络请求回来的json，生成各种实例。

但是，在View层的 Activity 或 Fragment 上，虽然有View层的理念，避免不了很多Controller层的业务过度耦合在View层。

总结得出，View层（Activity、Fragment）除了自身的生命周期回调方法（onCreate、onStart … 等）外，还掺杂了各种Controller业务（直接操作Model、DB操作 … 等）

反正就是，各种乱七八糟的东西都放在Activity 或 Fragment，各种难看，各种耦合。

在这种情况下，衍生出了 MVP 和 MVVM 。现在主流的还是MVP，MVVM目前在Android上还不成熟，还处于测试阶段。

---

Robotlegs4Android MVC

这是Robotlegs4Android 的 MVC 流程图。

• EventDispatcher 完成各层之间的通信。
• Mediator 代理 View 层的业务，View层只显示简单的生命周期回调方法。
• Command 作为 Controller 层，对 View 传过来的业务进行相应处理。
• Actor 作为 Model 层，为 Command 提供 DB 的请求（SQLite 或 网络请求）。

---

Robotlegs4Android Gradle

dependencies {    compile 'com.camnter.robotlegs4android:robotlegs4android:0.8'}

---

Robotlegs4Android Github

Robotlegs4Android

---

Robotlegs4Android Model

extends Actor

定义一个Robotlegs4Android Model对象，只需要继承 Actor 即可。

UserModel

public class UserModel extends Actor {    public void login(String name,String password) {        // TODO Do you want to network requests    }    public boolean logout(){        // TODO Do you want to network requests        return true;    }}

User

public class User implements Serializable {    public String name;    public String sign;}

---

Robotlegs4Android View

• Robotlegs4Android Activity
• Robotlegs4Android Fragment

---

Robotlegs4Android Activity

• 如果你这个Activity不需要Fragment。 extends RobotlegsActivity。
• 如果你这个Activity需要Fragment。 extends RobotlegsFragmentActivity。

MainActivity （看起来真的很简单）

public class MainActivity extends RobotlegsFragmentActivity {    /**     * Please set the fragment layout id     * 请设置Fragment的布局Id     *     * @return     */    @Override    public int getLayoutId() {        return R.layout.activity_main;    }    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);    }}

MainActivityMediator（这里处理Activity要做的事情）

public class MainActivityMediator extends Mediator {    private static final String TAG = "MainActivityMediator";    private MainActivity activity;    private TabLayout tabLayout;    private ViewPager viewPager;    /**     * {@inheritDoc}     * {@linkplain IMediator #onRegister}     */    @Override    public void onRegister() {        this.activity = (MainActivity) this.getViewComponent();        this.initViews();        this.initData();    }    private void initViews() {        this.tabLayout = (TabLayout) this.activity.findViewById(R.id.tab_layout_tl);        this.viewPager = (ViewPager) this.activity.findViewById(R.id.view_pager_vp);    }    private void initData() {        String[] tabTitles = {"ONE", "TWO", "THR", "FOU"};        Fragment[] fragments = {                TabLayoutFirstFragment.getInstance(),                TabLayoutSecondFragment.getInstance(),                TabLayoutThirdFragment.getInstance(),                TabLayoutFourthFragment.getInstance()        };        MainActivityAdapter adapter = new MainActivityAdapter(this.activity.getSupportFragmentManager(), fragments, tabTitles);        this.viewPager.setAdapter(adapter);        this.tabLayout.setupWithViewPager(this.viewPager);    }}

---

Robotlegs4Android Fragment

extends RobotlegsFragment

TabLayoutFirstFragment（看起来真的很简单）

public class TabLayoutFirstFragment extends RobotlegsFragment {    private static TabLayoutFirstFragment instance;    private TabLayoutFirstFragment() {    }    public static TabLayoutFirstFragment getInstance() {        if (instance == null) instance = new TabLayoutFirstFragment();        return instance;    }    /**     * Please set the fragment layout id     * 请设置Fragment的布局Id     *     * @return     */    @Override    public int getLayoutId() {        return R.layout.tablayout_first_fragment;    }}

TabLayoutFirstFragmentMediator（这里处理Fragment要做的事情）

public class TabLayoutFirstFragmentMediator extends Mediator implements View.OnClickListener {    public TabLayoutFirstFragment fragment;    public FragmentActivity activity;    private Button firstBT;    private TextView firstTV;    private ImageView firstIV;    private TextView controllerTV;    /**     * {@inheritDoc}     * {@linkplain IMediator #onRegister}     */    @Override    public void onRegister() {        this.fragment = (TabLayoutFirstFragment) this.getViewComponent();        this.activity = this.fragment.getActivity();        this.initViews();        this.initData();    }    private void initViews() {        this.firstBT = (Button) this.fragment.self.findViewById(R.id.first_bt);        this.firstTV = (TextView) this.fragment.self.findViewById(R.id.first_tv);        this.firstIV = (ImageView) this.fragment.self.findViewById(R.id.first_iv);        this.controllerTV = (TextView) this.fragment.self.findViewById(R.id.first_controller_tv);    }    private void initData() {        this.firstTV.setText("The ONE created by robotlegs4android frame");    }    /**     * Called when a view has been clicked.     *     * @param v The view that was clicked.     */    @Override    public void onClick(View v) {        switch (v.getId()) {            case R.id.first_bt: {            }        }    }}

---

Robotlegs4Androird Event

extends com.camnter.robotlegs4android.base.Event

为了各个层之间的通信，定义一个Event类型。

LoginEvent

public class LoginEvent extends Event {    public static final String USER_LOGIN = "user_login";    public static final String USER_LOGOUT = "user_logout";    public static final String USER_LOGIN_SUCCESS_FROM_MODEL_TO_CONTROLLER = "user_login_success_from_model_to_controller";    public static final String USER_LOGIN_SUCCESS_FROM_MODEL_TO_VIEW = "user_login_success_from_model_to_view";    public static final String USER_LOGIN_SUCCESS_FROM_CONTROLLER_TO_VIEW = "user_login_success_from_controller_to_view";    public String name;    public String password;    public User user;    public LoginEvent(String type) {        super(type);    }}

---

Robotlegs4Android Controller

extends Command

有了通讯，自然也要有Controller去处理，发向Controller的事件。

Login

public class Login extends Command {    private static final String TAG = "Login";    @Inject    public UserModel userModel;    @Inject    public LoginEvent event;    /**     * TODO - The Command subclass must inherit the execute method     * 备忘录 - Command子类必须继承execute方法     */    @Override    public void execute() {        switch (event.getType()) {            case LoginEvent.USER_LOGIN: {                userModel.login(event.name, event.password);                break;            }            case LoginEvent.USER_LOGOUT: {                userModel.logout();                break;            }            case LoginEvent.USER_LOGIN_SUCCESS_FROM_MODEL_TO_CONTROLLER: {                break;            }        }    }

---

!!!!!! Robotlegs4Android Context

extends com.camnter.robotlegs4android.mvcs.Context

必须定义一个com.camnter.robotlegs4android.mvcs.Context

• 1.为了配置View和对应Mediator。
• 2.为了单例注入Model（Actor）。
• 3.为了配置传入Controller（Command）的事件。

MainContext

public class MainContext extends Context {    public MainContext(Object contextView, Boolean autoStartup) {        super(contextView, autoStartup);    }    /**     * set your mvc relation     * 设置你的mvc关系     * <p/>     * Add the view map     * Link the View and View the corresponding Mediator     * 添加view映射     * 将View 和 View 对应的 Mediator 联系起来     * <p/>     * Injection as an singleton, instantiate the singleton     * 注入实例，实例化单例     * <p/>     * Add Event (Event) with the connection of the Command     * 添加事件（Event）与Command的联系     */    @Override    public void setMvcRelation() {        /*         * view映射         * 将View 和 View 对应的 Mediator 联系起来         * Add the view map         * Link the View and View the corresponding Mediator         */        this.getMediatorMap().mapView(MainActivity.class, MainActivityMediator.class, null, true, true);        this.getMediatorMap().mapView(TabLayoutFirstFragment.class, TabLayoutFirstFragmentMediator.class, null, true, true);        this.getMediatorMap().mapView(TabLayoutSecondFragment.class, TabLayoutSecondFragmentMediator.class, null, true, true);        this.getMediatorMap().mapView(TabLayoutThirdFragment.class, TabLayoutThirdFragmentMediator.class, null, true, true);        this.getMediatorMap().mapView(TabLayoutFourthFragment.class, TabLayoutFourthFragmentMediator.class, null, true, true);        /*         * 注入实现 实例化单例         * Injection as an singleton, instantiate the singleton         */        this.getInjector().mapSingleton(UserModel.class, "");        /*         * 添加事件与Command的联系         * Add Event (Event) with the connection of the Command         */        this.getCommandMap().mapEvent(LoginEvent.USER_LOGIN, Login.class,                null, false);        this.getCommandMap().mapEvent(LoginEvent.USER_LOGIN_SUCCESS_FROM_MODEL_TO_CONTROLLER, Login.class, null, false);    }}

---

!!!!!! Robotlegs4Android Application

extends RobotlegsApplication

必须定义一个Robotlegs4Android Application去初始化，对应的Robotlegs4Android Context

MainApplication

public class MainApplication extends RobotlegsApplication {    private static MainApplication ourInstance = new MainApplication();    public static MainApplication getInstance() {        return ourInstance;    }    /**     * Please write your custom robotlegs4android context     * 请填写你自定义的robotlegs4android context     * TODO After write your custom robotlegs4android context, please don't call this method     * TODO 填写完你自定义的robotlegs4android context后，请不要调用此方法     *     * @return     */    @Override    protected Context getMvcContextInstance() {        return new MainContext(this, true);    }    /**     * Called when the application is starting, before any activity, service,     * or receiver objects (excluding content providers) have been created.     * Implementations should be as quick as possible (for example using     * lazy initialization of state) since the time spent in this function     * directly impacts the performance of starting the first activity,     * service, or receiver in a process.     * If you override this method, be sure to call super.onCreate().     */    @Override    public void onCreate() {        super.onCreate();        if (ourInstance == null) ourInstance = this;    }}

AndroidManifest.xml

    <application        android:name="com.camnter.robotlegs4android.test.application.MainApplication"        android:allowBackup="true"        android:icon="@mipmap/ic_launcher"        android:label="@string/app_name"        android:theme="@style/AppTheme">        <activity            android:name=".view.activity.MainActivity"            android:label="@string/app_name">            <intent-filter>                <action android:name="android.intent.action.MAIN" />                <category android:name="android.intent.category.LAUNCHER" />            </intent-filter>        </activity>    </application>

---

Event View to Controller

TabLayoutFirstFragmentMediator 发送一个LoginEvent.USER_LOGIN的LoginEvent。

    /**     * Called when a view has been clicked.     *     * @param v The view that was clicked.     */    @Override    public void onClick(View v) {        switch (v.getId()) {            case R.id.first_bt: {                /*                 * you can send a your custom event from Model layer to Controller layer,and the                 * frame will search the event configuration from your custom context                 * 你可以发送一个你自定义的事件从Model层到Controller层，并且框架会去你自定义的context搜索                 * 这个事件的配置                 */                LoginEvent loginEvent = new LoginEvent(LoginEvent.USER_LOGIN);                loginEvent.name = "CaMnter";                loginEvent.password = "Save you from anything";                this.dispatch(loginEvent);            }        }    }

MainContext 设置了LoginEvent.USER_LOGIN事件的去向的Controller。

        this.getCommandMap().mapEvent(LoginEvent.USER_LOGIN, Login.class,                null, false);

Login 的execute()方法能拿到LoginEvent.USER_LOGIN事件。

    @Inject    public LoginEvent event;    /**     * TODO - The Command subclass must inherit the execute method     * 备忘录 - Command子类必须继承execute方法     */    @Override    public void execute() {        switch (event.getType()) {            case LoginEvent.USER_LOGIN: {                userModel.login(event.name, event.password);                break;            }            case LoginEvent.USER_LOGOUT: {                userModel.logout();                break;            }            case LoginEvent.USER_LOGIN_SUCCESS_FROM_MODEL_TO_CONTROLLER: {                Log.i(TAG, "This Login Controller know the user login success");                /*                 * send an USER_LOGIN_SUCCESS_FROM_CONTROLLER_TO_VIEW type of event to View layer                 * 发送一个USER_LOGIN_SUCCESS_FROM_CONTROLLER_TO_VIEW类型的事件到View层                 */                this.dispatch(new LoginEvent(LoginEvent.USER_LOGIN_SUCCESS_FROM_CONTROLLER_TO_VIEW));                break;            }        }    }

---

Event Model to Controller

UserModel 的login(String name,String password)方法发送一个LoginEvent.USER_LOGIN_SUCCESS_FROM_MODEL_TO_CONTROLLER的LoginEvent。

    public void login(String name,String password) {        // TODO Do you want to network requests        User user = new User();        user.name = "CaMnter";        user.sign = "Save you from anything";        /*         * you can send a your custom event from Model layer to Controller layer         * 你可以发送一个你自定义的事件从Model层到Controller层         */        this.dispatch(new LoginEvent(LoginEvent.USER_LOGIN_SUCCESS_FROM_MODEL_TO_CONTROLLER));    }

---

Event Model to View

UserModel 的login(String name,String password)方法再发送一个LoginEvent.USER_LOGIN_SUCCESS_FROM_MODEL_TO_VIEW的LoginEvent。

    public void login(String name,String password) {        // TODO Do you want to network requests        User user = new User();        user.name = "CaMnter";        user.sign = "Save you from anything";        /*         * you can send a your custom event from Model layer to View layer         * 你可以发送一个你自定义的事件从Model层到View层         */        LoginEvent loginEvent = new LoginEvent(LoginEvent.USER_LOGIN_SUCCESS_FROM_MODEL_TO_VIEW);        loginEvent.user = user;        this.dispatch(loginEvent);        /*         * you can send a your custom event from Model layer to Controller layer         * 你可以发送一个你自定义的事件从Model层到Controller层         */        this.dispatch(new LoginEvent(LoginEvent.USER_LOGIN_SUCCESS_FROM_MODEL_TO_CONTROLLER));    }

Mediator.getEventMap().mapListener(IEventDispatcher dispatcher, String type,IListener listener, Class<?> eventClass, Boolean useCapture,int priority, Boolean useWeakReference)
TabLayoutFirstFragmentMediator 添加对LoginEvent.USER_LOGIN_SUCCESS_FROM_MODEL_TO_VIEW类型的LoginEvent的监听。

     */    @Override    public void onRegister() {        this.fragment = (TabLayoutFirstFragment) this.getViewComponent();        this.activity = this.fragment.getActivity();        this.initViews();        this.initData();        this.initListeners();    }    private void initViews() {        this.firstBT = (Button) this.fragment.self.findViewById(R.id.first_bt);        this.firstTV = (TextView) this.fragment.self.findViewById(R.id.first_tv);        this.firstIV = (ImageView) this.fragment.self.findViewById(R.id.first_iv);        this.controllerTV = (TextView) this.fragment.self.findViewById(R.id.first_controller_tv);    }    private void initData() {        this.firstTV.setText("The ONE created by robotlegs4android frame");    }    private void initListeners() {        this.firstBT.setOnClickListener(this);        /*         * listening your custom event（such as listening to an USER_LOGIN_SUCCESS type of LoginEvent）         * listening from Model layer to View layer in here         * 监听你的自定义事件（例如监听一个USER_LOGIN_SUCCESS_FROM_MODEL_TO_CONTROLLER_AND_VIEW类型的LoginEvent）         * 在这里监听从Model层到View层         */        this.getEventMap().mapListener(this.getEventDispatcher(), LoginEvent.USER_LOGIN_SUCCESS_FROM_MODEL_TO_VIEW, new Listener() {                    /**                     * {@inheritDoc}                     * <p/>                     * {@linkplain IListener #onHandle}                     *                     * @param event                     */                    @Override                    public void onHandle(Event event) {                        if (event instanceof LoginEvent) {                            TabLayoutFirstFragmentMediator.this.firstIV.setVisibility(View.VISIBLE);                        }                    }                }, null,                false, 0, true);    }

---

Event Controller to View

Login 发送一个LoginEvent.USER_LOGIN_SUCCESS_FROM_CONTROLLER_TO_VIEW类型的LoginEvent。

    /**     * TODO - The Command subclass must inherit the execute method     * 备忘录 - Command子类必须继承execute方法     */    @Override    public void execute() {        switch (event.getType()) {            case LoginEvent.USER_LOGIN: {                userModel.login(event.name, event.password);                break;            }            case LoginEvent.USER_LOGOUT: {                userModel.logout();                break;            }            case LoginEvent.USER_LOGIN_SUCCESS_FROM_MODEL_TO_CONTROLLER: {                Log.i(TAG, "This Login Controller know the user login success");                /*                 * send an USER_LOGIN_SUCCESS_FROM_CONTROLLER_TO_VIEW type of event to View layer                 * 发送一个USER_LOGIN_SUCCESS_FROM_CONTROLLER_TO_VIEW类型的事件到View层                 */                this.dispatch(new LoginEvent(LoginEvent.USER_LOGIN_SUCCESS_FROM_CONTROLLER_TO_VIEW));                break;            }        }    }

Mediator.getEventMap().mapListener(IEventDispatcher dispatcher, String type,IListener listener, Class<?> eventClass, Boolean useCapture,int priority, Boolean useWeakReference)
TabLayoutFirstFragmentMediator 再添加一个对LoginEvent.USER_LOGIN_SUCCESS_FROM_CONTROLLER_TO_VIEW类型的LoginEvent的监听。

    /**     * {@inheritDoc}     * {@linkplain IMediator #onRegister}     */    @Override    public void onRegister() {        this.fragment = (TabLayoutFirstFragment) this.getViewComponent();        this.activity = this.fragment.getActivity();        this.initViews();        this.initData();        this.initListeners();    }    private void initViews() {        this.firstBT = (Button) this.fragment.self.findViewById(R.id.first_bt);        this.firstTV = (TextView) this.fragment.self.findViewById(R.id.first_tv);        this.firstIV = (ImageView) this.fragment.self.findViewById(R.id.first_iv);        this.controllerTV = (TextView) this.fragment.self.findViewById(R.id.first_controller_tv);    }    private void initData() {        this.firstTV.setText("The ONE created by robotlegs4android frame");    }    private void initListeners() {        this.firstBT.setOnClickListener(this);        /*         * listening your custom event（such as listening to an USER_LOGIN_SUCCESS type of LoginEvent）         * listening from Model layer to View layer in here         * 监听你的自定义事件（例如监听一个USER_LOGIN_SUCCESS_FROM_MODEL_TO_CONTROLLER_AND_VIEW类型的LoginEvent）         * 在这里监听从Model层到View层         */        this.getEventMap().mapListener(this.getEventDispatcher(), LoginEvent.USER_LOGIN_SUCCESS_FROM_MODEL_TO_VIEW, new Listener() {                    /**                     * {@inheritDoc}                     * <p/>                     * {@linkplain IListener #onHandle}                     *                     * @param event                     */                    @Override                    public void onHandle(Event event) {                        if (event instanceof LoginEvent) {                            TabLayoutFirstFragmentMediator.this.firstIV.setVisibility(View.VISIBLE);                        }                    }                }, null,                false, 0, true);        /*         * listening your custom event（such as listening to an USER_LOGIN_SUCCESS type of LoginEvent）         * listening from Controller layer to View layer in here         * 监听你的自定义事件（例如监听一个USER_LOGIN_SUCCESS_FROM_CONTROLLER_TO_VIEW类型的LoginEvent）         * 在这里监听从Controller层到View层         */        this.getEventMap().mapListener(this.getEventDispatcher(), LoginEvent.USER_LOGIN_SUCCESS_FROM_CONTROLLER_TO_VIEW, new Listener() {            /**             * {@inheritDoc}             * <p/>             * {@linkplain IListener #onHandle}             *             * @param event             */            @Override            public void onHandle(Event event) {                if (event instanceof LoginEvent) {                    TabLayoutFirstFragmentMediator.this.controllerTV.setVisibility(View.VISIBLE);                }            }        }, null, false, 0, true);    }

---