该框架的1.5版本位于https://github.com/robotlegs/robotlegs-framework/tree/version1,现在已经出了重新架构的2.0版本,所以我决定先研究已经成熟的1.6版本,有时间再研究2.0版本的。
我看完这个框架的源码和范例的第一印象就是自动化,这个框架把很多逻辑都集成到了系统内部,而我们只需要进行一些简单的映射,进行一些简单的功能实现就能完成一个项目了。
基本结构
Robotlegs 的MVCS实现将应用程序解耦为4层:Model-View-Controller (MVC) 和 Service层,view 层处理用户交互. model 层处理用户创建的或从外部获取的数据. controller 提供一种封装各层之间复杂交互的机制. 最后, service 层提供一种和外界(比如远程服务 API 或文件系统)交互的独立机制.
其核心主要是有4个类:
Context: 提供一个中心的事件 bus 并且处理自己的启动和关闭. 一个 context 定义了一个范围. 框架 actor 们处在 context 之内,并且在 context 定义的范围之内进行相互间的通讯.在利用Robotlegs框架时,我们需要继承该类,并实现我们自己的startup函数,当我们建立了Context后,startup函数会在初始化后自动运行,我们需要在这个函数里配置模型映射,事件映射和视图映射以及新建视图进行系统初始化,下面是一个例子:
public class ExampleContext extends Context { public function ExampleContext(contextView:DisplayObjectContainer, autoStartup:Boolean = true) { super(contextView, autoStartup); } override public function startup():void { commandMap.mapEvent(ContextEvent.STARTUP, PrepModelCommand, ContextEvent, true); commandMap.mapEvent(ContextEvent.STARTUP, PrepViewCommand, ContextEvent, true); commandMap.mapEvent(ContextEvent.STARTUP, PrepControllerCommand, ContextEvent); commandMap.mapEvent(ContextEvent.STARTUP, StartupCommand, ContextEvent, true); // fire! dispatchEvent(new ContextEvent(ContextEvent.STARTUP)); } }
Actor: Model 和 Service都继承自Actor。
Command: Controller由Command实现,针对我们需要处理的消息,我们先定义相应的处理类,并在execute函数中进行处理。然后我们将消息和相应的Command映射起来:
commandMap.mapEvent(eventType:String, commandClass:Class, eventClass:Class = null, oneshot:Boolean = false)
Mediator:View层包括view component和Mediator,在建立视图前,我们需要先建立view component和Mediator之间的映射:
mediatorMap.mapView( ViewClass, MediatorClass, autoCreate, autoRemove );
建立完两者之间的映射后,当我们新建一个view component加入stage时,系统自动帮我们新建一个指定的Mediator与之相关联。
Mediator 负责所中介的 view component 发出的事件, 我们需要将消息和相应的处理函数映射起来:
eventMap.mapListener(myMediatedViewComponent, SomeEvent.USER_DID_SOMETHING, handleUserDidSomethingEvent)
SwiftSuspenders框架的应用
RobotLegs框架配备了SwiftSuspenders来实现它的自动化依赖注入。SwiftSuspenders框架的详细信息,见文章轻量级IOC框架SwiftSuspenders,下面说说这个框架在Robotlegs中的应用。
1.在新建Context时就进行一些值映射,这样可以轻松的保证一些对象在整个系统中的一致性。
protected function mapInjections():void { injector.mapValue(IReflector, reflector); injector.mapValue(IInjector, injector); injector.mapValue(IEventDispatcher, eventDispatcher); injector.mapValue(DisplayObjectContainer, contextView); injector.mapValue(ICommandMap, commandMap); injector.mapValue(IMediatorMap, mediatorMap); injector.mapValue(IViewMap, viewMap); injector.mapClass(IEventMap, EventMap); }
2.初始化Modal和Service时。因为一般这些都有Singleton的需求,可以利用injector.mapSingleton来轻松实现
3.用injector轻松实现添加view component时新建相关联的Mediator。
4.框架使用者也能从中获利。
系统自动化的实现
让我们再来回顾一下启动一个系统需要做的事:
1.新建Context
2.将Modal映射为Singleton
3.为消息映射相关的Command
4.为view component映射相关的Mediator
5.新建view component并加入view list中。
然后的然后,整个系统就跑起来了!
我们不需要为新建的view component建立Meditor,系统会在一个view component加入view list中后,从mediatorMap中找出和view component对应的Mediator类,并新建相应的Mediator。并且会自动的调用Mediator的onRegister函数,将Mediator处理的事件加入eventMap中。
我们不需要操心Modal的新建,一致性等问题,因为injector帮我们将其映射成了singleton,这样我们只需要在使用Modal的类中加入[Inject]注入点就行。
共用的eventMap使得各个部分的通信更容易,每个层都不需要操心和其他层之间的交互,只需要把自己的事情处理好,其他的事情通过dispatch将消息发出去让其他的层处理就行。
应用的例子
joelhooks为robotlegs写了很多的例子,可以通过https://github.com/joelhooks/robotlegsdemos看到,我就不赘述了。