轻量级IOC框架SwiftSuspenders

该框架的1.6版本位于https://github.com/tschneidereit/SwiftSuspenders/blob/the-past/，现在已经出了重新架构的2.0版本，所以我决定先研究已经成熟的1.6版本，有时间再研究2.0版本的。

IOC的基本知识

控制反转（Inversion of Control，英文缩写为IoC）又叫做依赖注入（Dependency Injection，英文缩写为DI）,是一种降低耦合度的程序设计模式，它通过将对象的创建过程解耦出来来降低对象间的依赖关系。具体的，在文章依赖注入那些事儿里解释的很详细，另外也可参考老马的文章和深度理解依赖注入（Dependence Injection）。

describeType函数介绍

SwiftSuspenders是利用describeType函数来实现其反射机制的。

describeType函数可用来生成描述 ActionScript 对象（命名为方法的参数）的 XML 对象。利用此方法可实现 ActionScript 语言的反射编程概念。

为了详细说明这个函数，我们先自定义一个类MyClass:

    public class MyClass extends Object
    {
        public const const_varable:int = 0;
        [Inject(desc="a public varable")]
        public var pub_varable:String = "";private var pri_varable:String = "";
        [Inject(desc="a static function")]
        public static function static_func(s:String):void
        {
            trace(s);
        }
        public function get accpri():String
        {
            return pri_varable;
        }
        public function set accpri(v:String):void
        {
            pri_varable = v;
        }
        public function TraceOut():void {
            trace(accpri);
        }
        public function MyClass()
        {
        }
    }

如果传入的参数是类型的实例，则返回的 XML 对象包括该类型的所有实例属性，但不包括任何静态属性。
var m:MyClass = new MyClass();
trace(describeType(m));
得到如下的XML:

<type name="MyClass" base="Object" isDynamic="false" isFinal="false" isStatic="false">
  <extendsClass type="Object"/>
  <constant name="const_varable" type="int">
    <metadata name="__go_to_definition_help">
      <arg key="pos" value="110"/>
    </metadata>
  </constant>
  <variable name="pub_varable" type="String">
    <metadata name="Inject">
      <arg key="desc" value="a public varable"/>
    </metadata>
    <metadata name="__go_to_definition_help">
      <arg key="pos" value="184"/>
    </metadata>
  </variable>
  <accessor name="accpri" access="readwrite" type="String" declaredBy="MyClass">
    <metadata name="__go_to_definition_help">
      <arg key="pos" value="425"/>
    </metadata>
    <metadata name="__go_to_definition_help">
      <arg key="pos" value="498"/>
    </metadata>
  </accessor>
  <method name="TraceOut" declaredBy="MyClass" returnType="void">
    <metadata name="__go_to_definition_help">
      <arg key="pos" value="571"/>
    </metadata>
  </method>
  <metadata name="__go_to_ctor_definition_help">
    <arg key="pos" value="632"/>
  </metadata>
  <metadata name="__go_to_definition_help">
    <arg key="pos" value="67"/>
  </metadata>
</type>

忽略掉其中__go_to_ctor_definition_help形式的metadata，可以看到如下XML:

<type name="MyClass" base="Object" isDynamic="false" isFinal="false" isStatic="false">
  <extendsClass type="Object"/>
  <constant name="const_varable" type="int">
  </constant>
  <variable name="pub_varable" type="String">
    <metadata name="Inject">
      <arg key="desc" value="a public varable"/>
    </metadata>
  </variable>
  <accessor name="accpri" access="readwrite" type="String" declaredBy="MyClass">
  </accessor>
  <method name="TraceOut" declaredBy="MyClass" returnType="void">
  </method>
</type>

1.可以在解析 XML 对象时检查传入的是对象还是类，方法是检查 <type> 标签的 isStatic 属性的值，该值在 value 参数是类型的实例时为 false。

2.private属性和方法不会被describeType函数解析到。

要获取某个类型的静态属性，则传递该类型本身。返回的 XML 对象不仅仅包括类型的静态属性，而且还包括它的所有实例属性。
trace(describeType(MyClass));忽略掉其中__go_to_ctor_definition_help形式的metadata，可以得到如下XML:

<type name="MyClass" base="Class" isDynamic="true" isFinal="true" isStatic="true">
  <extendsClass type="Class"/>
  <extendsClass type="Object"/>
  <accessor name="prototype" access="readonly" type="*" declaredBy="Class"/>
  <method name="static_func" declaredBy="MyClass" returnType="void">
    <parameter index="1" type="String" optional="false"/>
    <metadata name="Inject">
      <arg key="desc" value="a static function"/>
    </metadata>
  </method>
  <factory type="MyClass">
    <extendsClass type="Object"/>
    <constant name="const_varable" type="int">
    </constant>
    <variable name="pub_varable" type="String">
      <metadata name="Inject">
        <arg key="desc" value="a public varable"/>
      </metadata>
    </variable>
    <accessor name="accpri" access="readwrite" type="String" declaredBy="MyClass">
    </accessor>
    <method name="TraceOut" declaredBy="MyClass" returnType="void">
    </method>
  </factory>
</type>

1.若传入参数为类，则实例属性嵌套在名为 <factory> 的标签内，从而与静态属性区分开来。在这种情况下，<type> 标签的 isStatic 属性为 true。

2.所有的非静态方法将显示在<factory> 标签内，静态方法显示在<factory> 标签外。

下表描述了由 describeType() 生成的 XML 对象的某些标签和属性（返回的所有类和接口名称均采用完全限定的格式）：

标签	属性	说明
<type>		XML 对象的根标签。
	name	ActionScript 对象的数据类型的名称。
	base	ActionScript 对象的定义类的直接超类。如果 ActionScript 对象是类对象，则值为 Class。
	isDynamic	如果 ActionScript 对象的定义类是动态的，则为 true；否则为 false。如果 ActionScript 对象是类对象，则值为 true，因为 Class 类是动态的。
	isFinal	如果 ActionScript 对象的定义类是最终类，则为 true；否则为 false。
	isStatic	如果 ActionScript 对象是类对象或构造函数，则为 true；否则为 false。此属性之所以名为 isStatic，原因是：如果此属性为 true，则未嵌套在 factory 标记内的任何标签都是静态的。
<extendsClass>		ActionScript 对象的定义类的每个超类都有一个单独的 extendsClass 标签。
	type	ActionScript 对象的定义类扩展的超类的名称。
<implementsInterface>		ActionScript 对象的定义类或其任何超类实现的每个接口都有一个单独的 implementsInterface 标签。
	type	ActionScript 对象的定义类实现的接口的名称。
<accessor>		存取器是 getter 和 setter 函数定义的一个属性。
	name	存取器的名称。
	access	属性的访问权限。可能的值包括 readonly、writeonly 和 readwrite。
	type	属性的数据类型。
	declaredBy	包含关联的 getter 或 setter 函数的类。
<constant>		常量是用 const 语句定义的一个属性。
	name	常量的名称。
	type	常量的数据类型。
<constructor>		在构造函数有参数时显示。
<method>		方法是作为类定义的一部分声明的函数。
	name	方法的名称。
	declaredBy	包含方法定义的类。
	returnType	方法的返回值的数据类型。
<parameter>		方法定义的每个参数都有一个单独的 parameter 标签。此标签始终嵌套在 <method> 标签内。
	index	一个数字，对应于参数在方法的参数列表中出现的顺序。第一个参数的值为 1。
	type	参数的数据类型。
	optional	如果参数是可选参数，则为 true；否则为 false。
<variable>		变量是用 var 语句定义的一个属性。
	name	变量的名称。
	type	变量的数据类型。
<factory>		如果 ActionScript 对象是类对象或构造函数，则所有实例属性和方法均嵌套在此标签内。如果 <type> 标签的 isStatic 属性为 true，则未嵌套在 <factory> 标签内的所有属性和方法都是静态的。只有在 ActionScript 对象是类对象或构造函数时，此标签才会出现。
<metadata>		用[]括起来的标签
	name	标签的名称。
<arg>		标签中()括起来的参数
	key	参数的名称。
	value	参数的值。

在debug编译条件下运行时我们能够正确获取metadata，但是release编译条件下会忽略未知的metadata，这时，需要在flex sdk的编译参数里面添加

-keep-as3-metadata+=MyMetadata

应用及API

1.定义依赖

Swiftsuspenders支持3种依赖定义：

a.值绑定，将一个注入请求返回为一个给定的对象

mapValue(whenAskedFor : Class, useValue : Object, named : String = "")

b.类绑定，将一个注入请求返回为一个给定类的新建的实例

mapClass(whenAskedFor : Class, instantiateClass : Class, named : String = "")

c.单例绑定，将所有的注入请求返回为同一个共享的实例，这个实例由第一次请求时创建。

mapSingleton(whenAskedFor : Class, named : String = "")

public function mapSingletonOf(whenAskedFor : Class, useSingletonOf : Class, named : String = "")

另外，Swiftsuspenders支持通过使用mapRule来扩展依赖映射

当一个类型在多处被注入，且需要使用不同的注入依赖时，通过指定注入名的方式来区别各处的注入。

2.定义注入点

Swiftsuspenders支持在4个位置进行注入：

a.属性(如setter)

b.变量

c.方法(支持可选参数)

d.构造函数(支持可选参数)

3.变量注入的用例

    public interface IClass
    {
        function ClassInfo():String;
    }

    public class ClassA implements IClass
    {

        public function ClassA()
        {

        }
        public function ClassInfo():String
        {
            return "Class A";
        }
    }

    public class ClassB  implements IClass
    {

        public function ClassB()
        {

        }
        public function ClassInfo():String
        {
            return "Class B";
        }
    }

    public class MyClass
    {
        [Inject]
        public var iclass:IClass;

        public function MyClass()
        {

        }
        public function TraceOut():void
        {
            trace(iclass.ClassInfo());
        }

    }

        var inj :Injector = new Injector();

        inj.mapClass(MyClass, MyClass);
        inj.mapClass(IClass, ClassA);
        var a:MyClass = inj.getInstance(MyClass);
        inj.unmap(IClass);
        inj.mapClass(IClass, ClassB);
        var b:MyClass = inj.getInstance(MyClass);
        a.TraceOut();
        b.TraceOut();

4.构造函数注入的用例

当对构造函数注入使用注入名时，元数据必须放在类定义的前面，而不是在构造函数前，这个是由于Flash Player的限制造成的。

只需修改上面代码中的MyClass类:

    [Inject]
    public class MyClass
    {
        public var iclass:IClass;

        public function MyClass(c:IClass)
        {
            iclass = c;
        }
        public function TraceOut():void
        {
            trace(iclass.ClassInfo());
        }

    }

5.其他

a.可以使用PostConstruct来标注注入完成后自动调用的方法

有些需要在注入完成后调用的方法，可以申明[PostConstruct]元数据，从而在所有的注入完成后，自动调用被[PostConstruct]申明的方法。可以通过order参数来决定方法调用的顺序,如：

[PostConstruct(order=1)]

b.可以用hasMapping来查询某依赖是否已经存在，若是需要重新映射已经存在的依赖，需要先使用unmap方法解除原有依赖。

c.支持子注入器，通过createChildInjector方法实现。

d.支持通过XML文件配置注入信息。

设计结构

SwiftSuspenders的类图如上图所示。整个框架以Injector为核心。InjectionPoint包中包含了所有与注入点相关的类，InjectionResult包中包含了返回策略相关的类。

Injector中的m_mappings中包含所有的映射关系InjectionConfig，当调用mapClass,mapValue,mapSingleton时实际上就是建立类的映射关系，其序列图如下：

m_injecteeDescriptions中包含InjecteeDescription对象，这个对象包括所有的注入点信息，包括构造注入点信息，和其他注入点信息。当getInstance时将根据之前配置的映射信息来获取所有注入点，再通过根据注入点进行注入来获取最终的对象，其流程图如下：

这里面getInjectionPoints函数就是利用之前介绍的describeType函数来获取类的内容，并进行解析以获取注入点。