大家好，今天来介绍我开源的一个autofac.Annotation项目源码：https://github.com/yuzd/Autofac.Annotation

本项目是autofa的一个扩展组件，autofac是一个老牌的DI容器框架，支持netframework和netcore
Annotdation是注解的意思，在java项目里面注解的概念和 csharp里面的 Attribute 的概念是一样的。

本项目的目的降低玩DI容器的门槛,快速实现依赖注入自动装配以及拦截器，AOP切面编程

基于参考 Java的 Spring注解方式开发思想，

所有autofac容器的注册和装配都是依赖标签来完成。

这样一来一方面很容易分清楚哪些是DI 哪些非DI，哪些是拦截器，哪些需要拦截器，轻松实现切面编程，代码也好看，吸收java的spring框架的优越的地方，配合.net语法的优越性，编程效率能够大大提升。

支持的标签一览

标签名称	使用位置	使用说明
AutoConfiguration	打在class上面	自动装配class里面带有Bean标签的方法
Bean	打在方法上面	配合AutoConfiguration标签使用
Component	打在class上面	自动注册
Autowired	打在构造方法的Parameter，类的Property，类的Field	自动装配
PropertySource	打在class上面	配合Value标签使用，设置Value的数据源，支持json,xml,支持资源内嵌
Value	打在构造方法的Parameter，类的Property，类的Field	静态数据装配，支持强大的EL表达式
Aspect	打在class上面	开启拦截器，默认注册为类拦截器，也可以指定为接口型拦截器(和pointcut的区别是它是打在哪个class哪个才会生效)
Pointcut	打在class上面	切面配置,一个切面拦截N多个对象

针对每个标签的使用文档请移步wiki文档传送门

https://github.com/yuzd/Autofac.Annotation/wiki

下面介绍一下最最常用的功能也就是注册和自动装配

Componet标签把类型注册到DI容器

原理解释

框架会扫描打了Componet标签的class。如果Componet标签里面指定了要注册的类型，则会只注册为这个类型到DI容器。如果没有指定则会把当前class(参考下面的4)，以及父类，以及接口都会注册到DI容器(参考下面的1,2和3)。

如何修改这个默认配置呢，比如关闭自动注册父类和接口。可以参考 https://github.com/yuzd/Autofac.Annotation/issues/11

Componet有哪些属性

属性名称	类型	含义
Service	Type	注册指定单个的类型
Key	String	注册指定单个的key(为了同个类型注册多次避免歧义)
Services	Type[]	注册指定多个的类型
Keys	String[]	注册指定多个的key(如果指定多个类型又想避免歧义可以搭配上面一起使用)
AutofacScope	Enum	InstancePerDependency(每次都是一个新实例，默认) SingleInstance(单例) InstancePerLifetimeScope(每个scope获取新的实例) InstancePerRequest(根据每个请求一个实例) 可以在插件初始化的时候指定一个默认的参考下方的截图说明
AutoActivate	bool	当指定Scope为单例的时候默认false 当DI容器初始化完成后会自动完成实例化
InitMethod	string	当实例化后自动执行的方法名称
DestroyMethod	string	当实例会DI容器回收会自动执行的方法名称
Ownership	Enum	LifetimeScope(DI容器管理自动回收策略，默认)External(自己手动管理实例回收)
Interceptor	Type	指定拦截器类型
InterceptorType	Enum	Interface(使用接口模式) Class(使用class的虚方法模式)
InterceptorKey	string	如果同一个类型的拦截器有多个可以指定Key
InjectPropertyType	Enum	属性自动装配的类型 ,Autowired(代表打了Autowired标签的才会装配),All(代表全部自动装配)

Componet的常用构造方法

默认的构造方法


//默认的构造方法会把当前class，以及父类，以及接口都会注册到DI容器
//这里只会注册A8到DI容器
[Component]
public class A8
{}//通过A8类型可以装配成功
[Autowired]
public A8 A8 { get; set; }·························································public class B
{}//这里会把A8 和 B 都注册到DI容器
[Component]
public class A8：B
{}//通过A8类型可以装配成功
[Autowired]
public A8 A8 { get; set; }//通过B类型也可以装配成功拿到的是A8类型
[Autowired]
public B B { get; set; }
··························································public interface IA
{}public interface IB:IA
{}public class B:IB
{}//这里会把A8  B IB IA 全都注册到DI容器 
//如果你指向注册A8 可以参考https://github.com/yuzd/Autofac.Annotation/issues/11 去配置
[Component]
public class A8：B
{}//通过A8类型可以装配成功 
[Autowired]
public A8 A8 { get; set; }//通过B类型也可以装配成功拿到的是A8类型
[Autowired]
public B B { get; set; }//通过IB类型也可以装配成功拿到的是A8类型
[Autowired]
public IB IB { get; set; }//通过IA类型也可以装配成功拿到的是A8类型
[Autowired]
public IA IA { get; set; }

注册为指定类型

publicclassB
{}//这个构造方法就是将A6注册为B类型
[Component(typeof(B))]
publicclassA6:B
{}//可以通过下面的方式自动装配 因为上面注册的是B类型 通过B类型可以装配成功 拿到的是A6类型
[Autowired]
public B B { get; set; }//通过下面的方式自动装配会失败 会失败 会失败
[Autowired]
public A6 A6 { get; set; }

同一个注册类型有多个采用Key方式解决歧义


public interface ITestAutowiredModal
{
}// ITestAutowiredModal这个类型被注册多个了 避免歧义用"abc"来解决
[Component("abc")]
public class TestAutowiredModal1:ITestAutowiredModal
{
}// ITestAutowiredModal这个类型被注册多个了 避免歧义用"def"来解决
[Component("def")]
public class TestAutowiredModal2:ITestAutowiredModal
{
}//可以用下面的方式来自动装配 拿到的是TestAutowiredModal1类型对象
[Autowired("abc")]public ITestAutowiredModal TestAutowiredModal1 { get; set; }//如果不指定的话会先尝试根据byType模式匹配，因为是指定了Key 所以根据byType拿不到，拿不到就会再次根据属性名称 “abc” 去匹配，就和上面的方式一样了
[Autowired]public ITestAutowiredModal abc { get; set; }//可以用下面的方式来自动装配 拿到的是TestAutowiredModal2类型对象
[Autowired("def")]public ITestAutowiredModal TestAutowiredModal2 { get; set; }

1. 把一个类型注册到DI容器

上面的例子就是把Student类型注册到容器

2. 把当前类型和父类注册到DI容器

上面的例子就是把Student2类型注册到容器
并且把Person类型也注册到容器根据Person类型拿到的是Student2的实体

3. 把当前类型和接口注册到DI容器

上面的例子就是把Student3类型注册到容器
并且把ISay也注册到容器根据ISay类型拿到的是Student3的实体

4. 当继承了父类或者接口想要指定注册类型怎么办？

上面的例子就是只能通过ISay拿到Student3的实体
不能通过Student3类型拿到！！

5. 怎么指定实例是单例,每次都是新的实例，还是每个Scope一个实例呢？

如上图所示可以指定AutofacScope属性
如果不指定就是每次获取的一个新的实例

6. 当同一个类型多次注册，如何区分得到我想要的？

如上图 ISay类型有2个实现类 Student3 和 Student4 分别指定了 Key的值
通过ISay + “Student3” 可以获取到 Student3的实体
通过ISay + “Student4” 可以获取到 Student4的实体

7.支持注册类型可以自动实例化对象

如上所示，设定AutoActivate = true代表是启动自动实例化
AutofacScope = AutofacScope.SingleInstance 代表单例模式
Student5类型会对象会自动实例化并且以单例的方式存储在DI容器内

8.支持设置实例化时运行指定方法

如上所示设置 InitMethod 和 DestroyMethod
当实例从DI容器初始化时就会调用 InitMethod
当DI容器Dispose的时候会触发调用DestroyMethod

另外

InitMethod支持注入
DestroyMethod只能是无参数方法

Autowired自动装配

Autowired有哪些属性

属性名称	类型	含义
Name	String	搭配Component指定Key的时候使用，消除一个类型被多个注册带来的歧义
Required	bool	默认装载失败会报错设置为false装载失败不会报错
CircularDependencies	bool	是否支持循环注入默认是false 不支持，插件初始化的时候可以设置一个默认值

打在构造方法上属性

在单例的对象里面Autowired多实例

使用ObjectFactory来实现，和Lazy的区别是 ObjectFactory修饰的每次获取都是从容器里面获取一遍。而Lazy只有首次才会去容器获取。

延迟自动装配Lazy


[Component]
public class TestLazyModel1
{[Autowired]public Lazy<TestAutowiredModal4> TestAutowiredModal4 { get; set; }[Autowired]public TestAutowiredModal3 TestAutowiredModal3 { get; set; }
}