GWT MVP 学习笔记

GWT MVP 学习笔记

　　在GWT的在线文档中只看 《GWT Development with Activities and Places》就可以了，这是2.1中新推出的做法，结合考虑了浏览器的前进、后退、书签/收藏、直接输入URL，以及页面跳转前的用户确认，比较全面。

　　其中提到的《 Large scale application development and MVP, Part I 》和《 Large scale application development and MVP, Part II 》两篇文章是比较原始的做法，使用history对象手工来做MVP，如不打算研究架构设计的就没必要看了。

　　==================================

　　使用 Activities and Places 的 GWT MVP 所涉及的概念：

　　▲ View ：把一个View分为 Interface 和 实现类（如：PC / PAD / 手机），Interface 和 实现类没有特殊要求，但出于重复利用、和 Presenter 的结合，可以：

　　△ view 的 interface 可以继承 IsWidget ，并包含一个 Presenter 内部interface。参见：public interface HelloView extends IsWidget {}

　　△ view 的 实现类 可以继承Composite， 参见：public class HelloViewImpl extends Composite implements HelloView {}

　　△ Composite的父类Widget实现了IsWidget 的asWidget() 方法，这样在 Activity.Start() 中就可以

　　用 containerWidget.setWidget(xxxxView.asWidget()); 把 view 加入到上级容器中并显示出来

　　▲ Activity ：就是 Presenter ，需要实现 Activity interface，但可以继承 AbstractActivity 以实现默认的功能。

　　参见：public class HelloActivity extends AbstractActivity implements HelloView.Presenter {}，代码之下在线文档可以看一下

　　△ start() : 显示view

　　△ mayStop() : 要求用户确认是否离开当前正在执行的 view

　　△ goTo() : 自定义的方法，响应 view 传来的用户事件，非Activity必须的方法

　　▲ Place ： 暂且把它当做 URL 中用来确定 view 的部分吧。需要继承 Place接口，包含实现了 PlaceTokenizaer接口的 Tokenizer内部类。如不需要实现浏览器的前进、后退、书签/收藏、直接输入URL等情况，也可以不需要 Tokenizer内部类。

　　▲ ClientFactory ：自定义的 interface 和其实现类（如：PC / PAD / 手机），并非必须，但可以将需要反复用到或较占资源的对象放入ClientFactory 对象中，如：EventBus、PlaceController、常用的view等。并通过 GWT.create(ClientFactory.class) 和 .gwt.xml 中 <replace-with> 标签根据用户访问时的浏览器环境进行延迟加载，定义方式如下：

　　<inherits name='....FormFactor'/>

　　<replace-with class="ClientFactoryImpl">

　　<when-type-is class="ClientFactory"/>

　　<when-property-is name="formfactor" value="PAD"/>

　　</replace-with>

　　以上 formfactor 在<inherits >标签指定的 FormFactor.gwt.xml 中用JavaScript定义，参见：eclipse安装目录下　 \plugins\com.google.gwt.eclipse.sdkbundle_2.4.0.v201112160242-rel-r37\gwt-2.4.0 下

　　\samples\MobileWebApp\src\main\java\com\google\gwt\sample\mobilewebapp

　　注：View 由于要同浏览器 DOM 结合，较占资源，所以放入 ClientFactory 中在启动时就一次性装入，而 Activity不那么占资源，同时为了避免每次调用 Activity 时需清除原先内容的麻烦，Activity每次都new一个新的出来。

　　==================================

　　使用 Activities and Places 的 GWT MVP 所涉及的类或接口有：

　　▲ AbstractActivity抽象类：见上

　　▲ ActivityManager类：从 EventBus 上捕获 PlaceChangeEvent 或者 PlaceChangeRequestEvent 后，

　　将根据 ActivityMapper 找到相应的 activity 来初始化， 并在widget准备好之后调用它的start方法。

　　▲ ActivityMapper接口：通过其中的 getActivity()方法 根据目标place返回目标activity

　　-----------------------------

　　▲ place：见上，Represents a bookmarkable location in an app

　　（似乎没有什么有用的Field和Method，存在的目的仿佛就是为了构成 ActivityMapper 和 PlaceHistoryMapper ）

　　▲ PlaceController：In charge of the user's location in the app.似乎主要就是负责Place的跳转（有goto()方法）

　　▲ PlaceHistoryHandler：Monitors PlaceChangeEvents and History events and keep them in sync

　　处理浏览器的前进后退以及bookmark等操作

　　▲ PlaceHistoryMapper接口:将url转换成place。 继承gwt提供的框架接口， 该接口定义了从Token到Place的双向映射。

　　继承之后不用实现具体映射方法， 可以通过@WithTokenizers({XxxxPlace.Tokenizer.class, Yyyy.Tokenizer.class,...})来实现映射配置。

　　参见：public interface AppPlaceHistoryMapper extends PlaceHistoryMapper {}

　　-----------------------------

　　▲ SimpleEventBus ：Dispatches Events to interested parties. ActivityManager 和 PlaceHistoryHandler 通过它获得浏览器事件（GWT view部件事件或浏览器前进、后退、书签、URL输入等事件）

　　===============================================

　　GWT MVP工作原理：

　　参见：How it all works & How to navigate & Activities

　　用户从GWT界面进行某些操作（如点击按钮等）：

　　view.onClickXxx() -> OriginalActivity.goTo(nextPlace) -> PlaceController.goTo(nextPlace) ->

　　=>

　　=> | =>

　　| => ->

　　nextActivity.Start()

　　=>

　　-------------------------------------------

　　如用户使用浏览器的 Bookmark / forward / backward 进入GWT 项目：

　　Bookmark / forward / backward操作

　　=>->

　　======================================