循序渐进学.Net Core Web Api开发系列【11】：依赖注入

系列目录

循序渐进学.Net Core Web Api开发系列目录

 本系列涉及到的源码下载地址：https://github.com/seabluescn/Blog_WebApi

一、概述

本篇介绍如何采用依赖注入的方式创建和使用对象，主要从应用层面进行描述，不涉及具体的内部原理。

二、演练

假设要做一个日志服务的类，它实现在控制台打印出带时间信息的日志信息。

首先定义该服务的接口与实现类。

public interface ILogService
{
void LogInfomation(string info);
}

public class MyLogService : ILogService
{
void ILogService.LogInfomation(string info)
{
Console.WriteLine($" ==> MyLogService : {DateTime.Now.ToString()}:{info}");
}
}

注册该服务

public void ConfigureServices(IServiceCollection services)
{
services.AddMvc();
services.AddCors();

services.AddSingleton<ILogService, MyLogService>();
}

注册成功，我们在Controller中使用该服务：

public class ArticleController : Controller
{       
　　　　private readonly ILogService _myLog;

public ArticleController(ILogService myLog)
{
_myLog = myLog;
}

[HttpGet("logger")]
public void TestLogger(string logger)
{
_myLog.LogInfomation("hahaha");
return;
}
}

 简单分析一下：

1、首先通过services.AddSingleton方法向依赖注入容器登记注册MyLogService；

2、在构建Controller时，根据其构造函数类型遍历其输入参数，在依赖注入容器中找到该对象并作为实参传递给构造方法。

三、生命周期问题

注册一个服务，根据生命周期需要的不同，有下面三种方式：

services.AddSingleton<ILogService, MyLogService>();

services.AddScoped<ILogService, MyLogService>();

ervices.AddTransient<ILogService, MyLogService>();

三种注册方式分别对应三种生命周期

1）Singleton：单例服务，从当前服务容器中获取这个类型的实例永远是同一个实例；

2）Scoped：每个作用域生成周期内创建一个实例；

3）Transient：每一次请求服务都创建一个新实例；

对我们的日志进行改造，让其在构建时生成一个ID，通过观察其guid变化可以理解这三种生命周期的区别。

public class MyLogService : ILogService
{
public  Guid _guid;

public MyLogService()
{
_guid = Guid.NewGuid();
}

void ILogService.LogInfomation(string info)
{
Console.WriteLine($" ==> MyLogService : My Guid is :{_guid}");
Console.WriteLine($" ==> MyLogService : {DateTime.Now.ToString()}:{info}");
}
}

四、通过扩展方法注册服务

通过对IServiceCollection增加扩展方法来注册服务

public static class MyLogServiceCollectionExtensions
{
public static void AddMyLog(this IServiceCollection services)
{
services.AddSingleton<ILogService, MyLogService>();
}
}

这样，使用者的注册代码可以修改为：

public void ConfigureServices(IServiceCollection services)
{   

services.AddMvc();
services.AddCors();

services.AddMyLog(); 
}

可见AddMvc、AddCors等也是向容器注入服务。

public static IMvcBuilder AddMvc(this IServiceCollection services)
{
if (services == null)
{
throw new ArgumentNullException("services");
}
IMvcCoreBuilder mvcCoreBuilder = MvcCoreServiceCollectionExtensions.AddMvcCore(services);
MvcApiExplorerMvcCoreBuilderExtensions.AddApiExplorer(mvcCoreBuilder);
MvcCoreMvcCoreBuilderExtensions.AddAuthorization(mvcCoreBuilder);
MvcServiceCollectionExtensions.AddDefaultFrameworkParts(mvcCoreBuilder.PartManager);
MvcCoreMvcCoreBuilderExtensions.AddFormatterMappings(mvcCoreBuilder);
MvcViewFeaturesMvcCoreBuilderExtensions.AddViews(mvcCoreBuilder);
MvcRazorMvcCoreBuilderExtensions.AddRazorViewEngine(mvcCoreBuilder);
MvcRazorPagesMvcCoreBuilderExtensions.AddRazorPages(mvcCoreBuilder);
TagHelperServicesExtensions.AddCacheTagHelper(mvcCoreBuilder);
MvcDataAnnotationsMvcCoreBuilderExtensions.AddDataAnnotations(mvcCoreBuilder);
MvcJsonMvcCoreBuilderExtensions.AddJsonFormatters(mvcCoreBuilder);
MvcCorsMvcCoreBuilderExtensions.AddCors(mvcCoreBuilder);
return new MvcBuilder(mvcCoreBuilder.Services, mvcCoreBuilder.PartManager);
}

五、几个问题

1、如果多次注册会怎样

可以多次注册同一种生命周期的类，如下是可以的：

services.AddSingleton<ILogService, MyLogService>();
services.AddSingleton<ILogService, MyLogService>();
services.AddSingleton<ILogService, MyLogService>();

但下面这个代码不行：

services.AddSingleton<ILogService, MyLogService>();
services.AddScoped<ILogService, MyLogService>();

2、如何获取已经注册的服务列表

通过ServicesProvider可以获取服务列表

services.AddMyLog();
services.AddMyLog();
services.AddMyLog();

var provider = services.BuildServiceProvider();
var servicesList = provider.GetServices< ILogService >();
foreach (var service in servicesList)
{
Console.WriteLine("service:" + service.ToString());
}

以上代码输出3条记录。

但下面的代码只输出一条记录：

services.AddCors();
services.AddCors();
services.AddCors();

var provider = services.BuildServiceProvider();
var servicesList = provider.GetServices<ICorsService>();
foreach (var service in servicesList)
{
Console.WriteLine("service:" + service.ToString());
}

具体原因看一下源码就清楚了：

public static IServiceCollection AddCors(this IServiceCollection services)
{
if (services == null)
{
throw new ArgumentNullException("services");
}
services.TryAdd(ServiceDescriptor.Transient<ICorsService, CorsService>());
return services;
}
public static void TryAdd(this IServiceCollection collection, ServiceDescriptor descriptor)
{
if (!collection.Any((ServiceDescriptor d) => d.ServiceType == descriptor.ServiceType))
{
collection.Add(descriptor);
}
}

所以我们应该按照这个方法修改我们的AddMyLog方法。