Robotlegs中的注入是由注入器Injector实现,先来看看Robotlegs中哪些地方存在注入器Injector。
首先Context里面有Injector,CommandMap、MediatorMap和ViewMap里面也有Injector。
Context自身内部除了有一个Injector单例之外还有CommandMap、MediatorMap、ViewMap这些单例,这些对象内部具有Injector。Robotlegs框架内部存在Injector的类基本上就是这4个,当然除了Context内部的commandMap、mediatorMap、viewMap单例之外你也可以手动创建新的CommandMap、MediatorMap、ViewMap,本文不讨论这种情况,我们在此只分析Robotlegs内置结构的4种Injector和它们的注入机制,后面提到的CommandMap、MediatorMap、ViewMap皆是指Context.commandMap、Context.mediatorMap和Context.viewMap。
Context,CommandMap,MediatorMap,ViewMap内部都有Injector,但它们是不同的。CommandMap.injector和MediatorMap.injector是Context.injector的子注入器,它们都继承了Context.injector的注入规则,同时又拥有各自的注入规则。而ViewMap.injector使用的就是Context.injector,也就是说ViewMap和Context的注入器是同一个。
Robotlegs区别与其他mvc框架的特色是运用了命令模式和中介模式规范了注入机制的使用,从而使整个应用程序框架结构更清晰高效易于维护。下面我们具体来分析一下这些注入机制。
Context相关的注入机制
Context中的Injector就是注入器的一般用法,Context在初始化的时候内部的添加了下面这些注入规则:
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);
被Context.Injector(或者子注入器)注入过的类内部都可以接收这些注入规则。注意这里的EventMap不是对象实例,每个IEventMap请求都会得到一个新的EventMap对象。此外,经过ViewMap映射的显示对象也可以接收这些注入规则,本文ViewMap相关的注入机制中会介绍。
CommandMap相关的注入机制
CommandMap内部的Injector是Context.Injector的子注入器。调用CommandMap.mapEvent方法时需传入(eventType:String, commandClass:Class, eventClass:Class = null)这些参数,CommandMap为总线eventDispatcher添加名为eventType的事件侦听。 当总线eventDispatcher派发名为eventType的事件时CommandMap执行了如下代码:
injector.mapValue(Event, event);//这里Event是flash.events.Event 或者是eventClass类型,event是总线eventDispatcher派发的事件。 var command:Object = injector.instantiate(commandClass); command.execute();
总线eventDispatcher接收到事件时Robotlegs会创建commandClass对象实例,同时把event注入到了commandClass,如果commandClass内部需要接收这个注入只要加入如下代码:
[Inject] public var event:Event; //也可以把Event换成eventDispatcher派发的具体事件类型eventClass。
前面说过CommandMap.Injector是Context.Injector的子注入器,所以CommandMap.Injector把自身的注入规则注入到commandClass的同时也会把Context.Injector的注入规则注入进commandClass。事实上commandClass的基类Command已经为我们定义了下面这些注入点,我们在commandClass内部可以直接使用这些注入。
[Inject] public var contextView:DisplayObjectContainer; [Inject] public var commandMap:ICommandMap; [Inject] public var eventDispatcher:IEventDispatcher; [Inject] public var injector:IInjector; [Inject] public var mediatorMap:IMediatorMap;
MediatorMap相关的注入机制
MediatorMap内部的Injector是Context.Injector的子注入器。调用MediatorMap.mapView方法时需传入(viewClass:*, mediatorClass:Class, injectViewAs:* = null)这些参数,MediatorMap为contextView添加Event.ADDED_TO_STAGE事件,viewClasss实例为显示对象且必须为contextView的子显示对象。当viewComponent显示对象创建并添加到Stage的时候MediatorMap执行了如下代码:
var mediator:IMediator; injector.mapValue(viewClass, viewComponent); mediator = injector.instantiate(mediatorClass); mediator.onRegister();
所以Robotlegs在创建mediatorClass对象实例的同时把viewComponent注入到了mediatorClass,如果mediatorClass内部需要接收这个注入只要加入如下代码:
[Inject] public var view:viewComponent;
在mediatorClass的onRegister方法内部可以访问到注入的view。 另外要注意的是一个mediator可以对应多个view,MediatorMap.mapView方法有injectViewAs这个参数,它可以是一个viewClass组成的数组,如果是这种情况injector会为每一个viewClass都创建注入规则,这样在mediatorClass内部可以接收多个viewClass注入。 当injectViewAs参数非空的时候会忽略viewClass参数。
同样,前面说过MediatorMap.Injector是Context.Injector的子注入器,所以MediatorMap.Injector把自身的注入规则注入到mediatorClass的同时也会把Context.Injector的注入规则注入进mediatorClass。事实上mediatorClass的基类Mediator已经为我们定义了下面这些注入点,我们在mediatorClass内部可以直接使用这些注入。
[Inject] public var contextView:DisplayObjectContainer; [Inject] public var mediatorMap:IMediatorMap;
ViewMap相关的注入机制
ViewMap可以添加显示对象(DisplayObject的子对象),经过ViewMap.mapType添加的显示对象第一次被放置到舞台的时候会被注入Context.injector的注入规则,在这些对象内部可以添加注入点来接收Context.injector的注入。当显示对象添加到舞台时ViewMap执行了如下代码: injector.injectInto(target);
这里的injector就是Context.injector,target是被ViewMap.mapType添加过的显示对象。target可以接收的注入规则可以参考上面的Context相关的注入机制。 此外ViewMap还有一个ViewMap.mapPackage方法用来添加类名前缀,如果被放置到舞台的显示对象的类名符合这些前缀同样也会被注入Context.injector的注入规则。
KevinChu
2014-6-11
认识Robotlegs(三)RL内置的注入机制