NopCommerce使用Autofac实现依赖注入

NopCommerce的依赖注入是用的AutoFac组件，这个组件在nuget可以获取,而IOC反转控制常见的实现手段之一就是DI依赖注入，而依赖注入的方式通常有：接口注入、Setter注入和构造函数注入。

NopCommerce将所有和Autofac注入相关的工作都放到了EngineContext中，在Global.asax的Application_Start函数的第一句代码即是：

//initialize engine context
EngineContext.Initialize(false);

从这里开始EngineContext的初始化工作，初始化时会创建一个新的NopEngine，参数false指定当NopEngine不为空时是否重新生成一个新的NopEngine。

[MethodImpl(MethodImplOptions.Synchronized)]
public static IEngine Initialize(bool forceRecreate)
{
    if (Singleton<IEngine>.Instance == null || forceRecreate)
    {
        var config = ConfigurationManager.GetSection("NopConfig") as NopConfig;
        Debug.WriteLine("Constructing engine " + DateTime.Now);
        Singleton<IEngine>.Instance = CreateEngineInstance(config);
        Debug.WriteLine("Initializing engine " + DateTime.Now);
        Singleton<IEngine>.Instance.Initialize(config);
    }
    return Singleton<IEngine>.Instance;
}

NopEngine使用单例模式，在整个程序运行期间存在一个实例，代码首先会判断NopEngine是否为空，为空的话则根据web.config中配置的NopConfig节点信息创建一个新的NopEngine实例，然后对该实例进行初始化操作。web.config中的配置信息如下：

 <configSections>
    <section name="NopConfig" type="Easy.Core.Configuration.NopConfig, Easy.Core" requirePermission="false" />
  </configSections>
  <NopConfig>
    <DynamicDiscovery Enabled="true" />
    <Engine Type="" />
    <Themes basePath="~/Themes/" />
  </NopConfig>

CreateEngineInstance函数中使用new NopEngine()创建了一个NopEngine实例，在NopEngine的构造函数处对Autofac的容器（Container）作了初始化，如下代码：

public NopEngine(EventBroker broker, ContainerConfigurer configurer)
{
    var config = ConfigurationManager.GetSection("NopConfig") as NopConfig;
    InitializeContainer(configurer, broker, config);
}
private void InitializeContainer(ContainerConfigurer configurer, EventBroker broker, NopConfig config)
{
    var builder = new ContainerBuilder();

    _containerManager = new ContainerManager(builder.Build());
    configurer.Configure(this, _containerManager, broker, config);
}

NopCommerce通过ContainerManager对容器做了一层封装，方便对其他类型的IOC框架的扩充和支持。Configure函数完成了所有依赖的注入，同时查找所有实现了IDependencyRegistrar接口的类，并调用其Register方法，注册内容包括Http context、web helper、controller、data layer、plugin、cache manager、work context、services、settings、event consumers等等。

关于ContainerManager/ContainerConfigurer和IDependencyRegistrar是实现IOC的关键，下面对这两个部分做详细的讨论。

IOC和DI

IOC中文名被称作控制反转（Inversion of Control），DI被称为依赖注入（Dependency Injection），可参考Martin Fowler的这篇文章来了解这两个概念：IoC容器和DependencyInjection模式。使用控制反转模式开发项目流程是先建立接口，然后再实现类，或许有人不习惯这样的开发方法，但在规模较大的软件架构中，这种方法却可以有效的降低类之间的互相依赖的情况，不但能增加架构的弹性，也能有效的降低软件的复杂度。

如果不考虑控制反转的情况，采用直接创建类，并直接在应用层调用该类，如此一来，应用层的对象就会与BLL（业务逻辑层）对象高度依赖，这样的依赖 会导致这两个类无法拆开，从而增加了这个类的维护难度，同时导致了单元测试难以进行。为了解决耦合度问题，从而引入了控制反转的概念。

Autofac介绍

Autofac是一款IOC框架，比较于其他的IOC框架，如Spring.NET、Unity、Castle等，它更显得轻量级，同时保证了高性能。它具有以下优点：

1. 和C#语言联系紧密，可以使用C#语言的很多特性，譬如Lambda表达式等；
2. 较低的学习曲线，只需了解IoC和DI的概念以及在何时需要使用它们即可；
3. XML配置支持；
4. 自动装配；
5. 与ASP.NET MVC3集成；（Orchard也是使用Autofac实现IOC的）

在MVC3项目中使用Autofac

在MVC3工程中使用Autofac的最好也是最简单的方法是使用NuGet来安装Autofac.Mvc3，安装完成以后，在Global.asax的Application_Start方法中添加如下代码：

1. protected void Application_Start()
2. {
3. var builder = new ContainerBuilder();
4. builder.RegisterControllers(typeof(MvcApplication).Assembly);
5. var container = builder.Build();
6. DependencyResolver.SetResolver(new AutofacDependencyResolver(container));
7. // Other MVC setup...

这样就开启了Controller的依赖注入功能。其中的DependencyResolver是一个全局静态类，MVC3提供了对依赖注入的支 持，SetResolver函数用于设置使用哪个Resolver（解析器）来进行依赖注入，这里使用的是Autofac的依赖注入解析器。如果要使用自 己的解析器，必须在这里使用SetResolver函数设置。

1. 注册Controller

可以使用下面的方法对特定的Controller进行注册：

1. var builder =  new ContainerBuilder();
2. builder.RegisterType<HomeController>().InstancePerRequest();

1. 同时可以使用Autofac提供的RegisterControllers扩展方法来对程序集中所有的Controller一次性的完成注册：

1. var builder = new ContainerBuilder();
2. builder.RegisterControllers(Assembly.GetExecutingAssembly());

2. 注册Model Binder

与控制器的注册类似，模型绑定也可以再Global.asax.cs中注册。您可以通过如下操作完成整个程序集的注册：

1. var builder = newContainerBuilder();
2. builder.RegisterModelBinders(Assembly.GetExecutingAssembly());
3. builder.RegisterModelBinderProvider();

您也必须记住使用RegisterModelBinderProvider扩展方法来注册RegisterModelBinderProvider。这个方法用是Autofac对IModelBinderProvider接口的实现。

因为RegisterModelBinders扩展方法通过扫描程序集来添加模型绑定的，所以您需要指定IModelBuilder注册的目标类是什么类型。

1. [ModelBinderType(typeof(string))]
2. public class StringBinder : IModelBinder
3. {
4. public override object BindModel(ControllerContext controllerContext,ModelBindingContext bindingContext)
5. {
6. //do implementation here
7. }
8. }

多行的ModelBuilderTypeAttribute实例可以添加到需要对个类型注册的类中。

3. 注入HTTP抽象类

MVC集成的Autofac模块将会为HTTP抽象类添加HTTP 请求的生命收起范围内的注册。包括依稀抽象类：

• HttpContextBase
• HttpRequestBase
• HttpResponseBase
• HttpServerUtilityBase
• HttpSessionStateBase
• HttpApplicationStateBase
• HttpBrowserCapabilitiesBase
• HttpCachePolicyBase
• VirtualPathProvider

需要使用上面的抽象应该使用容器的RegisterModule方法来添加AutofacWebTypesModule

1. builder.RegisterModule(newAutofacWebTypesModule());

4. 注入View page

您可以通过在容器创建之前添加ViewRegistrationSource 到容器中使属性注入来使MVC页面可用。

1. builder.RegisterSource(newViewRegistrationSource());

您的viewpage必须继承MVC类中用于创建，当使用Razor试图引擎时将需要继承WebViewPage类：

1. public abstract class CustomViewPage : WebViewPage
2. {
3. public IDependencyDependency { get; set; }
4. }

当使用的是webform的试图引擎时，ViewPage，ViewMasterPage和ViewUserControl类都得到相应的支持。

1. public abstract class CustomViewPage : ViewPage
2. {
3. public IDependencyDependency { get; set; }
4. }

必须确保您实际的试图页面继承了您自定义的基类。在Razor视图引擎.cshtml中可以使用@inherits指令来实现：

1. @inherits Example.Views.Shared.CustomViewPage

使用webform时可以做如下设置

1. <%@ PageLanguage="C#" MasterPageFile="~/Views/Shared/Site.Master" Inherits="Example.Views.Shared.CustomViewPage" %>

5. 对Filter Attribute进行属性注入

为过滤器使用属性注入必须在容器创建之前调用RegisterFilterProvider方法，并将其传到AutofacDependencyResolver

1. ContainerBuilder builder = new ContainerBuilder();
2. builder.RegisterControllers(Assembly.GetExecutingAssembly());
3. builder.Register(c => new Logger()).As<ILogger>().InstancePerHttpRequest();
4. builder.RegisterFilterProvider();
5. IContainer container = builder.Build();
6. DependencyResolver.SetResolver(new AutofacDependencyResolver(container));

然后您就可以为您的过滤器添加属性了，并且

1. public class CustomActionFilter : ActionFilterAttribute
2. {
3. public ILogger Logger { get; set; }
4. public override void OnActionExecuting(ActionExecutingContext filterContext)
5. {
6. Logger.Log("OnActionExecuting");
7. }
8. }

下面是类似用户验证过滤器的自定义特性

1. public class CustomAuthorizeAttribute : AuthorizeAttribute
2. {
3. public ILogger Logger { get; set; }
4. protected override bool AuthorizeCore(HttpContextBase httpContext)
5. {
6. Logger.Log("AuthorizeCore");
7. return true;
8. }
9. }

应用如下：

1. [CustomActionFilter]
2. [CustomAuthorizeAttribute]
3. public ActionResult Index()
4. {
5. // ...
6. }

1. 关于Autofac更多的信息，可以参考autofac在google code上的wiki文档：http://code.google.com/p/autofac/wiki/Mvc3Integration

NopCommerce是如何使用Autofac实现依赖注入的？

NopCommerce将所有和Autofac注入相关的工作都放到了EngineContext中，在Global.asax的Application_Start函数的第一句代码即是：

1. //initialize engine context
2. EngineContext.Initialize(false);

从这里开始EngineContext的初始化工作，初始化时会创建一个新的NopEngine，参数false指定当NopEngine不为空时是否重新生成一个新的NopEngine。

1. [MethodImpl(MethodImplOptions.Synchronized)]
2. public static IEngine Initialize(bool forceRecreate)
3. {
4. if (Singleton<IEngine>.Instance == null || forceRecreate)
5. {
6. var config = ConfigurationManager.GetSection("NopConfig") as NopConfig;
7. Debug.WriteLine("Constructing engine " + DateTime.Now);
8. Singleton<IEngine>.Instance = CreateEngineInstance(config);
9. Debug.WriteLine("Initializing engine " + DateTime.Now);
10. Singleton<IEngine>.Instance.Initialize(config);
11. }
12. return Singleton<IEngine>.Instance;
13. }

NopEngine 使用单例模式，在整个程序运行期间存在一个实例，代码首先会判断NopEngine是否为空，为空的话则根据web.config中配置的 NopConfig节点信息创建一个新的NopEngine实例，然后对该实例进行初始化操作。web.config中的配置信息如下：

1. <configSections>
2. <section name="NopConfig" type="Easy.Core.Configuration.NopConfig, Easy.Core" requirePermission="false" />
3. </configSections>
4. <NopConfig>
5. <DynamicDiscovery Enabled="true" />
6. <Engine Type="" />
7. <Themes basePath="~/Themes/" />
8. </NopConfig>

CreateEngineInstance函数中使用new NopEngine()创建了一个NopEngine实例，在NopEngine的构造函数处对Autofac的容器（Container）作了初始化，如下代码：

1. public NopEngine(EventBroker broker, ContainerConfigurer configurer)
2. {
3. var config = ConfigurationManager.GetSection("NopConfig") as NopConfig;
4. InitializeContainer(configurer, broker, config);
5. }

1. private void InitializeContainer(ContainerConfigurer configurer, EventBroker broker, NopConfig config)
2. {
3. var builder = new ContainerBuilder();
4. _containerManager = new ContainerManager(builder.Build());
5. configurer.Configure(this, _containerManager, broker, config);
6. }

NopCommerce通过ContainerManager对容器做了一层封装，方便对其他类型的IOC框架的扩充和支持。Configure函数完成了所有依赖的注入，同时查找所有实现了IDependencyRegistrar接 口的类，并调用其Register方法，注册内容包括Http context、web helper、controller、data layer、plugin、cache manager、work context、services、settings、event consumers等等。

关于ContainerManager/ContainerConfigurer和IDependencyRegistrar是实现IOC的关键，下面对这两个部分做详细的讨论。

// todo：仍需继续分析具体实现

ContainerManager/ContainerConfigurer

1. ContainerManagerContainerManager对依赖注入中使用的容器做了一层封装，提供了这些函数：

• AddComponent/AddComponentInstance/AddComponentWithParameters
• Resolve/ResolveAll/ResovleUnregistered
• UpdateContainer

DependencyRegistrar

• web helper
• controller
• data layer
• plugin
• cache manager
• work context
• services
• settings
• event consumers

from:aneasystone ==>http://www.cnblogs.com/aneasystone/archive/2012/08/27/2659176.html

IOC和DI

IOC中文名被称作控制反转（Inversion of Control），DI被称为依赖注入（Dependency Injection），可参考Martin Fowler的这篇文章来了解这两个概念：IoC容器和DependencyInjection模式。使用控制反转模式开发项目流程是先建立接口，然后再实现类，或许有人不习惯这样的开发方法，但在规模较大的软件架构中，这种方法却可以有效的降低类之间的互相依赖的情况，不但能增加架构的弹性，也能有效的降低软件的复杂度。

如果不考虑控制反转的情况，采用直接创建类，并直接在应用层调用该类，如此一来，应用层的对象就会与BLL（业务逻辑层）对象高度依赖，这样的依赖 会导致这两个类无法拆开，从而增加了这个类的维护难度，同时导致了单元测试难以进行。为了解决耦合度问题，从而引入了控制反转的概念。

Autofac介绍

Autofac是一款IOC框架，比较于其他的IOC框架，如Spring.NET、Unity、Castle等，它更显得轻量级，同时保证了高性能。它具有以下优点：

1. 和C#语言联系紧密，可以使用C#语言的很多特性，譬如Lambda表达式等；
2. 较低的学习曲线，只需了解IoC和DI的概念以及在何时需要使用它们即可；
3. XML配置支持；
4. 自动装配；
5. 与ASP.NET MVC3集成；（Orchard也是使用Autofac实现IOC的）

在MVC3项目中使用Autofac

在MVC3工程中使用Autofac的最好也是最简单的方法是使用NuGet来安装Autofac.Mvc3，安装完成以后，在Global.asax的Application_Start方法中添加如下代码：

1. protected void Application_Start()
2. {
3. var builder = new ContainerBuilder();
4. builder.RegisterControllers(typeof(MvcApplication).Assembly);
5. var container = builder.Build();
6. DependencyResolver.SetResolver(new AutofacDependencyResolver(container));
7. // Other MVC setup...

这样就开启了Controller的依赖注入功能。其中的DependencyResolver是一个全局静态类，MVC3提供了对依赖注入的支 持，SetResolver函数用于设置使用哪个Resolver（解析器）来进行依赖注入，这里使用的是Autofac的依赖注入解析器。如果要使用自 己的解析器，必须在这里使用SetResolver函数设置。

1. 注册Controller

可以使用下面的方法对特定的Controller进行注册：

1. var builder =  new ContainerBuilder();
2. builder.RegisterType<HomeController>().InstancePerRequest();

1. 同时可以使用Autofac提供的RegisterControllers扩展方法来对程序集中所有的Controller一次性的完成注册：

1. var builder = new ContainerBuilder();
2. builder.RegisterControllers(Assembly.GetExecutingAssembly());

2. 注册Model Binder

与控制器的注册类似，模型绑定也可以再Global.asax.cs中注册。您可以通过如下操作完成整个程序集的注册：

1. var builder = newContainerBuilder();
2. builder.RegisterModelBinders(Assembly.GetExecutingAssembly());
3. builder.RegisterModelBinderProvider();

您也必须记住使用RegisterModelBinderProvider扩展方法来注册RegisterModelBinderProvider。这个方法用是Autofac对IModelBinderProvider接口的实现。

因为RegisterModelBinders扩展方法通过扫描程序集来添加模型绑定的，所以您需要指定IModelBuilder注册的目标类是什么类型。

1. [ModelBinderType(typeof(string))]
2. public class StringBinder : IModelBinder
3. {
4. public override object BindModel(ControllerContext controllerContext,ModelBindingContext bindingContext)
5. {
6. //do implementation here
7. }
8. }

多行的ModelBuilderTypeAttribute实例可以添加到需要对个类型注册的类中。

3. 注入HTTP抽象类

MVC集成的Autofac模块将会为HTTP抽象类添加HTTP 请求的生命收起范围内的注册。包括依稀抽象类：

• HttpContextBase
• HttpRequestBase
• HttpResponseBase
• HttpServerUtilityBase
• HttpSessionStateBase
• HttpApplicationStateBase
• HttpBrowserCapabilitiesBase
• HttpCachePolicyBase
• VirtualPathProvider

需要使用上面的抽象应该使用容器的RegisterModule方法来添加AutofacWebTypesModule

1. builder.RegisterModule(newAutofacWebTypesModule());

4. 注入View page

您可以通过在容器创建之前添加ViewRegistrationSource 到容器中使属性注入来使MVC页面可用。

1. builder.RegisterSource(newViewRegistrationSource());

您的viewpage必须继承MVC类中用于创建，当使用Razor试图引擎时将需要继承WebViewPage类：

1. public abstract class CustomViewPage : WebViewPage
2. {
3. public IDependencyDependency { get; set; }
4. }

当使用的是webform的试图引擎时，ViewPage，ViewMasterPage和ViewUserControl类都得到相应的支持。

1. public abstract class CustomViewPage : ViewPage
2. {
3. public IDependencyDependency { get; set; }
4. }

必须确保您实际的试图页面继承了您自定义的基类。在Razor视图引擎.cshtml中可以使用@inherits指令来实现：

1. @inherits Example.Views.Shared.CustomViewPage

使用webform时可以做如下设置

1. <%@ PageLanguage="C#" MasterPageFile="~/Views/Shared/Site.Master" Inherits="Example.Views.Shared.CustomViewPage" %>

5. 对Filter Attribute进行属性注入

为过滤器使用属性注入必须在容器创建之前调用RegisterFilterProvider方法，并将其传到AutofacDependencyResolver

1. ContainerBuilder builder = new ContainerBuilder();
2. builder.RegisterControllers(Assembly.GetExecutingAssembly());
3. builder.Register(c => new Logger()).As<ILogger>().InstancePerHttpRequest();
4. builder.RegisterFilterProvider();
5. IContainer container = builder.Build();
6. DependencyResolver.SetResolver(new AutofacDependencyResolver(container));

然后您就可以为您的过滤器添加属性了，并且

1. public class CustomActionFilter : ActionFilterAttribute
2. {
3. public ILogger Logger { get; set; }
4. public override void OnActionExecuting(ActionExecutingContext filterContext)
5. {
6. Logger.Log("OnActionExecuting");
7. }
8. }

下面是类似用户验证过滤器的自定义特性

1. public class CustomAuthorizeAttribute : AuthorizeAttribute
2. {
3. public ILogger Logger { get; set; }
4. protected override bool AuthorizeCore(HttpContextBase httpContext)
5. {
6. Logger.Log("AuthorizeCore");
7. return true;
8. }
9. }

应用如下：

1. [CustomActionFilter]
2. [CustomAuthorizeAttribute]
3. public ActionResult Index()
4. {
5. // ...
6. }

1. 关于Autofac更多的信息，可以参考autofac在google code上的wiki文档：http://code.google.com/p/autofac/wiki/Mvc3Integration

NopCommerce是如何使用Autofac实现依赖注入的？

NopCommerce将所有和Autofac注入相关的工作都放到了EngineContext中，在Global.asax的Application_Start函数的第一句代码即是：

1. //initialize engine context
2. EngineContext.Initialize(false);

从这里开始EngineContext的初始化工作，初始化时会创建一个新的NopEngine，参数false指定当NopEngine不为空时是否重新生成一个新的NopEngine。

1. [MethodImpl(MethodImplOptions.Synchronized)]
2. public static IEngine Initialize(bool forceRecreate)
3. {
4. if (Singleton<IEngine>.Instance == null || forceRecreate)
5. {
6. var config = ConfigurationManager.GetSection("NopConfig") as NopConfig;
7. Debug.WriteLine("Constructing engine " + DateTime.Now);
8. Singleton<IEngine>.Instance = CreateEngineInstance(config);
9. Debug.WriteLine("Initializing engine " + DateTime.Now);
10. Singleton<IEngine>.Instance.Initialize(config);
11. }
12. return Singleton<IEngine>.Instance;
13. }

NopEngine 使用单例模式，在整个程序运行期间存在一个实例，代码首先会判断NopEngine是否为空，为空的话则根据web.config中配置的 NopConfig节点信息创建一个新的NopEngine实例，然后对该实例进行初始化操作。web.config中的配置信息如下：

1. <configSections>
2. <section name="NopConfig" type="Easy.Core.Configuration.NopConfig, Easy.Core" requirePermission="false" />
3. </configSections>
4. <NopConfig>
5. <DynamicDiscovery Enabled="true" />
6. <Engine Type="" />
7. <Themes basePath="~/Themes/" />
8. </NopConfig>

CreateEngineInstance函数中使用new NopEngine()创建了一个NopEngine实例，在NopEngine的构造函数处对Autofac的容器（Container）作了初始化，如下代码：

1. public NopEngine(EventBroker broker, ContainerConfigurer configurer)
2. {
3. var config = ConfigurationManager.GetSection("NopConfig") as NopConfig;
4. InitializeContainer(configurer, broker, config);
5. }

1. private void InitializeContainer(ContainerConfigurer configurer, EventBroker broker, NopConfig config)
2. {
3. var builder = new ContainerBuilder();
4. _containerManager = new ContainerManager(builder.Build());
5. configurer.Configure(this, _containerManager, broker, config);
6. }

NopCommerce通过ContainerManager对容器做了一层封装，方便对其他类型的IOC框架的扩充和支持。Configure函数完成了所有依赖的注入，同时查找所有实现了IDependencyRegistrar接 口的类，并调用其Register方法，注册内容包括Http context、web helper、controller、data layer、plugin、cache manager、work context、services、settings、event consumers等等。

关于ContainerManager/ContainerConfigurer和IDependencyRegistrar是实现IOC的关键，下面对这两个部分做详细的讨论。

// todo：仍需继续分析具体实现

ContainerManager/ContainerConfigurer

1. ContainerManagerContainerManager对依赖注入中使用的容器做了一层封装，提供了这些函数：

• AddComponent/AddComponentInstance/AddComponentWithParameters
• Resolve/ResolveAll/ResovleUnregistered
• UpdateContainer

DependencyRegistrar

• web helper
• controller
• data layer
• plugin
• cache manager
• work context
• services
• settings