首页 > 代码库 > 认识Robotlegs(三)RL内置的注入机制

认识Robotlegs(三)RL内置的注入机制

  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