GWT涂鸦(2)——MVP GWTUI框架CSSXML
程序员文章站
2022-03-09 17:43:02
...
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的特定接口。