Autofac官方文档(一)【开始】

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

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

本入门指南将引导您完成简单的控制台应用程序的这些步骤。 一旦您掌握了基本知识，您可以查看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());
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

现在我们有了一个合理的结构（如果有的话）依赖关系，让我们来看看Autofac吧！

添加Autofac引用

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

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

应用程序启动

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

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

public class SomeType : IService
{
}
1
2
3

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

     作为类型本身，SomeType
     作为接口，一个IService
1
2

在这种情况下，组件是SomeType，它公开的服务是SomeType和IService。

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

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

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

//但是，如果你想要两种服务（不常见），你可以这样说：
builder.RegisterType<SomeType>().AsSelf().As<IService>();
1
2
3
4
5
6
7
8

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

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

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();
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

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

应用程序执行

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

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

在解析组件时，根据您定义的实例范围，将创建对象的新实例。 （解析一个组件大致等同于调用“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();
      }
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

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给使用消费者。
1
2
3
4
5
6

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

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

进一步

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

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