GWT涂鸦(2)——MVP GWTUI框架CSSXML
程序员文章站
2022-03-09 17:42:26
...
The module XML file
位置：src/com.hellomvp/HelloMVP.gwt.xml
内容：
模块：helloMVP
继承User
继承Standard theme
继承Activity ：Presenter of MVP，依赖于Place模块，本质是一个widget上的事件处理引擎。
继承Place
：View States of MVP
entry-point：com.hellomvp.client.HelloMVP
replace-with
：对com.hellomvp.client.ClientFactory接口采用com.hellomvp.client.ClientFactoryImpl的默认注入
源client
源shared
The Host Page
位置：war/hellomvp.html
内容：标准内容
meta tag
css: hellomvp
.css
js: helloMVP
/helloMVP
.nocache.js
The Application Style Sheet
位置：war/hellomvp.css
内容：...
The Entry Point Class
位置：src/包.client/项目名.java
内容：
- private属性：一个最上层组件组件--SimplePanel appWidget ，一个初始的ui状态--Place defaultPlace ；
- onModuleLoad()：
- 通过GWT建立ClientFactory 对象，该工厂是对整个client端一系列对象的创建负责的抽象工厂（Abstract factory pattern ），所建对象包括eventBus，placeController，helloView，goodbyeView；ClientFactory接口中暴露了这些client对象的getter，ClientFactoryImpl里实现了对这些对象的new。
- 使用clientFactory对象作为参数，new出一个AppActivityMapper 对象。
- 使用activityMapper对象和eventBus对象作为参数，new出一个ActivityManager 对象；ActivityManager类是gwt的acitvity模块提供的框架类，它在从事件总线上捕获PlaceChangeEvent或者PlaceChangeRequestEvent后，将根据活动Mapper中提供的place与activity的关系，找到相应的活动来初始化之，并在widget准备好之后调用它的start方法。
- 使用 appWidget 作为参数调用activityManager的setDisplay 方法，该方法将传入的widget作为main widget以及event的接受者。
- 通过GWT建立AppPlaceHistoryMapper 对象。
- 使用historyMapper对象作为参数，new出一个PlaceHistoryHandler 对象；PlaceHistoryHandler类是gwt的Place模块可提供的框架类，由它来处理浏览器的前进后退以及bookmark等操作。
- 使用 placeControler，eventBus， defaultPlace 作为参数，调用 historyHandler的register 方法，该方法初始化整个 historyHandler。
- 将 appWidget 加入到RootPanel 中，RootPanel类是gwt的user模块提供的顶层容器类。
- 调用 historyHandler的handleCurrentHistory 方法，该方法使得app进入初始ui状态，即默认place
The MVP Configuration
位置：src/com.hellomvp.client.mvp
内容：
- ActivityMapper <|-- AppActivityMapper ：实现了Activity getActivity(Place place) ，从而完成从Place到Activity的单向映射配置。
- PlaceHistoryMapper <|-- AppPlaceHistoryMapper ： 继承gwt提供的框架接口，该接口定义了从Token到Place的双向映射。继承之后不用实现具体映射方法，可以通过@WithTokenizers 来实现映射配置。
The Place
位置：src/com.hellomvp.client.place
内容：
-
Place
<|--
GoodbyePlace
：
- 包含一个goodbyeName 属性以及它的getter方法，属性通常用来保存ui的状态值；
- 一个以String类型的token为参数的构造函数，token通常包含所有属性的值；
- 一个Tokenizer内部类，该类实现了PlaceTokenizer <GoodbyePlace >接口，即实现了从Place到Token的双向映射。该Tokenizer内部类会在AppPlaceHistoryMapper 接口中被注册到映射配置中。
-
Place
<|--HelloPlace
：
- 包含一个helloName 属性以及它的getter方法，属性通常用来保存ui的状态值；
- 一个以String类型的token为参数的构造函数，token通常包含所有属性的值；
- 一个Tokenizer内部类，该类实现了PlaceTokenizer <HelloPlace >接口，即实现了从Place到Token的双向映射。该Tokenizer内部类会在AppPlaceHistoryMapper 接口中被注册到映射配置中。
The Activity
位置：src/com.hellomvp.client.activity
内容：
-
AbstractActivity
<|--GoodbyeActivity
：一个简单的activity，对应的GoodbyeView
中不存在需要它实现的presenter，所以它只要负责start时对view的展现，不涉及presenter
- 提供一个由GoodbyePlace 和ClientFactory 作为参数的构造函数，这样可以从place得到view的当前状态。
- 实现 AbstractActivity 框架类中声明的start 方法，该方法中对 GoodbyeView 对象会进行一系列操作。
-
AbstractActivity
<|--HelloActivity
： 同时需要实现HelloView.Presenter接口中定义的业务方法
- 提供一个由HelloPlace 和ClientFactory 作为参数的构造函数，这样可以从place得到view的当前状态。
- 实现 AbstractActivity 框架类中声明的start 方法，该方法中对 HelloView 对象会进行一系列操作，包括把this作为presenter参数赋值给helloView.
- 覆盖了 AbstractActivity 框架类中声明的mayStop 方法，增加了在当前activity结束时给出提示的功能。
- 实现HelloView.Presenter接口中定义的goto(Place place) 方法。
The UI
位置：src/com.hellomvp.client.ui
内容：
- GoodbyeView<|--GoodbyeViewImpl ：一个简单的view，SimplePanel里包含一个html span，暴露的业务方法（声明在interface里）的实现是为span设置innerText值；
-
HelloView<|--HelloViewImpl
： 一个使用Presenter和uibind（通过ann来组装ui）的view，接口里定义了span的设置方法外加presenter的设置方法，以及presenter的接口定义：
- 2个@UiField 属性：一个SpanElement 和一个Anchor
- 1个绑定到Anchor 的@UiHandler 方法：调用prensenter.goto 方法。
- HelloViewImpl.ui.xml：一个以ui:UiBinder为root element的xml文件，是对@UiField组件的定义
UI是将View和Presenter进行组合，上述View和Presenter接口都不需要继承gwt的特定接口。