Autofac入门

Posted springsnow

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Autofac入门相关的知识,希望对你有一定的参考价值。

原文:https://blog.csdn.net/WuLex/article/details/78663006


将Autofac集成到您的应用程序的基本模式是:

 记住控制反转(IoC)的结构。
 添加Autofac引用。
 在应用程序启动...
 创建一个ContainerBuilder。
 注册组件。
 构建容器并将其存储以备后用。
 在执行应用程序时
 从容器创建一个生命周期范围。
 使用生命周期作用域来解析组件的实例。

本入门指南将引导您完成简单的控制台应用程序的这些步骤。 一旦您掌握了基本知识,您可以查看Wiki的其他部分,以获取有关WCF,ASP.NET和其他应用程序类型的更高级用法和集成信息。

一、构建应用程序

控制反转背后的想法,而不是把你的应用程序中的类绑定在一起,让类“新建”它们的依赖关系,你可以切换它,所以在构造类的时候依赖关系被传入。Martin Fowler有一个很好的文章解释依赖注入/控制反转

对于我们的示例应用程序,我们将定义一个将当前日期写入的类。 但是,我们不希望它绑定到控制台,因为我们希望能够稍后测试该类,或者在控制台不可用的地方使用它。

我们也会尽量让写日期的机制被抽象出来,所以如果我们稍后想换一个写明天日期的版本的话,那将是一个很好的选择。

我们会做这样的事情:

using System;

namespace DemoApp
{
   //这个接口有助于从Console类中去除“写入输出”的概念。我们并不真正“关心”写操作是如何发生的,只是我们可以写。 
  public interface IOutput
  {
    void Write(string content);
  }

  //IOutput接口的这种实现实际上是我们如何写入控制台。 从技术上讲,我们也可以实现IOutput来写入调试或跟踪...或其他任何地方。
  public class ConsoleOutput : IOutput
  {
    public void Write(string content)
    {
      Console.WriteLine(content);
    }
  }

  //这个接口把执行写操作的实际机制的写日期的概念分离出来。 和IOutput一样,这个过程在一个接口后面被抽象出来。
  public interface IDateWriter
  {
    void WriteDate();
  }

  //这个TodayWriter是所有汇聚一起的地方。
  //请注意,它需要一个类型为IOutput的构造函数参数 - 它允许编写者根据实现写入任何地方。 此外,它实现了WriteDate,使得今天的日期被写出来;
  //你可以用不同的格式或不同的日期写一个。
  public class TodayWriter : IDateWriter
  {
    private IOutput _output;
    public TodayWriter(IOutput output)
    {
      this._output = output;
    }

    public void WriteDate()
    {
      this._output.Write(DateTime.Today.ToShortDateString());
    }
  }
}

现在我们有了一个合理的结构(如果有的话)依赖关系,让我们来看看Autofac吧!

二、添加Autofac引用

第一步是将Autofac引用添加到您的项目中。 对于这个例子,我们只使用核心Autofac。 其他应用程序类型可能会使用额外的Autofac集成库。

最简单的方法是通过NuGet。 “Autofac”软件包具有您所需的所有核心功能。
技术图片

三、应用程序启动

在应用程序启动时,您需要创建一个ContainerBuilder并向其注册组件。 组件是表达式,.NET类型或其他一些代码,它们公开一个或多个服务,并且可以采用其他依赖关系。

简而言之,想一下实现接口的.NET类型,如下所示:

public class SomeType : IService
{
}

您可以通过以下两种方式之一来解决该类型问题:

     作为类型本身,SomeType
     作为接口,一个IService

在这种情况下,组件是SomeType,它公开的服务是SomeTypeIService

在Autofac中,你可以用一个ContainerBuilder注册这样的东西:

// 创建你的构建者
var builder = new ContainerBuilder();

//通常你只想通过接口暴露这个类型: 
builder.RegisterType<SomeType>().As<IService>();

//但是,如果你想要两种服务(不常见),你可以这样说:
builder.RegisterType<SomeType>().AsSelf().As<IService>();

对于我们的示例应用程序,我们需要注册我们所有的组件(类)并公开他们的服务(接口),这样可以很好地连接起来。

我们还需要存储容器,以便稍后可以使用它来解析类型。

using System;
using Autofac;

namespace DemoApp
{
  public class Program
  {
    private static IContainer Container { get; set; }

    static void Main(string[] args)
    {
      var builder = new ContainerBuilder();
      builder.RegisterType<ConsoleOutput>().As<IOutput>();
      builder.RegisterType<TodayWriter>().As<IDateWriter>();
      Container = builder.Build();

      //WriteDate方法是我们将使用依赖注入的地方。 我们将定义一下。
      WriteDate();
    }
  }
}

现在我们有一个包含所有组件注册的容器,并且提供了正确的服务。让我们来利用它。

四、应用程序执行

在执行应用程序时,您需要使用您注册的组件。你可以通过解决他们的生命周期域来做到这一点。

容器本身是一个有生命周期范围,你可以在技术上直接从容器中解决问题。但不建议直接从容器中解析。

在解析组件时,根据您定义的实例范围,将创建对象的新实例。 (解析一个组件大致等同于调用“new”来实例化一个类,这实际上是真正的简化了它,但是从类比的角度来看它没问题)。一些组件可能需要处理(就像它们实现IDisposable一样) - Autofac可以处理在处置寿命范围时为您配置这些组件。

但是,容器在您的应用程序的整个生命周期中都存在。如果你直接从容器中解决了很多东西,最终可能会有很多东西在等待处理。这不好(你可能会看到一个“内存泄漏”)。

相反,从容器中创建一个子生命周期范围并从中解决。当你完成解决组件,处理子范围,一切都为你清理。

(当你使用Autofac集成库时,这个子范围的创建基本上是为你完成的,所以你不必考虑它。)

对于我们的示例应用程序,我们将实现“WriteDate”方法来从作用域获取写入器,并在完成时处理作用域。

namespace DemoApp
{
  public class Program
  {
    private static IContainer Container { get; set; }

    static void Main(string[] args)
    {
      // 你之前看到的东西
    }

    public static void WriteDate()
    {

      //创建作用域,解析IDateWriter,使用它,然后处理作用域。
      using (var scope = Container.BeginLifetimeScope())
      {
        var writer = scope.Resolve<IDateWriter>();
        writer.WriteDate();
      }
    }
  }
}

Now when you run your program…

五、现在当你运行你的程序…

    “WriteDate”方法向Autofac请求IDateWriter。
    Autofac看到IDateWriter映射到TodayWriter,所以开始创建TodayWriter。
    Autofac认为TodayWriter在其构造函数中需要一个IOutput。
    Autofac将IOutput映射到ConsoleOutput,以创建一个新的ConsoleOutput实例。
    Autofac使用新的ConsoleOutput实例来完成构建TodayWriter。
    Autofac返回完全构建的`“WriteDate”`TodayWriter给使用消费者。

之后,如果您希望应用程序写入不同的日期,则可以实现不同的IDateWriter,然后在应用程序启动时更改注册。你不必改变任何其他类。很好,控制反转!

注意:一般来说,服务定位在很大程度上被认为是反模式(见文章)。也就是说,在任何地方手动创建作用域,并通过代码来使用容器不一定是最好的方法。使用Autofac集成库,您通常不必执行上面示例应用程序中的操作。相反,事情从应用程序的中央“顶级”位置解决,而手动解决方案很少见。当然,你如何设计你的应用程序取决于你。

六、进一步

示例应用程序给你一个如何使用Autofac的想法,但还有很多你可以做的。

     查看集成库列表,了解如何将Autofac与您的应用程序集成。
     了解如何注册增加灵活性的组件。
     了解Autofac配置选项,以便您更好地管理组件注册。

以上是关于Autofac入门的主要内容,如果未能解决你的问题,请参考以下文章

翻译Autofac的帮助文档1.入门指南

AutoFac简单入门

一个非常简单的入门级ASP.NET Core Autofac使用

推荐net开发cad入门阅读代码片段

.NET Core Autofac 4.0的配置和使用示例代码

Autofac 集成测试 在 ConfigureContainer 之后进行 Mock 注入