.Net Core 3.x Api開發筆記 -- IOC,使用Autofac實現依賴注入(三)

時間 2020-12-01

標籤 web api 微信異步 async ide 函數工具測試欄目快樂工作简体版

原文原文鏈接

本節演示在 .net Core ApI項目中引入 Autofac 容器web

項目前提條件:api

.net Core ApI項目微信

服務層--Service層異步

倉儲層--Repository層async

。。ide

第一步：安裝 NuGet 相關包，安裝以下兩個Autofac 包便可，目前版本 Autofac 6.0函數

第二步：註冊工具

Program.cs 文件中須要加入一句話：.UseServiceProviderFactory(new AutofacServiceProviderFactory())測試

        /// <summary>
        /// 默認初始化系統內置的配置
        /// </summary>
        /// <param name="args"></param>
        /// <returns></returns>
        public static IHostBuilder CreateHostBuilder(string[] args) =>
            Host.CreateDefaultBuilder(args)
                .UseServiceProviderFactory(new AutofacServiceProviderFactory())   //autofac 依賴注入
                .ConfigureWebHostDefaults(webBuilder =>
                {
                    webBuilder.UseStartup<Startup>();
                });

Startup.cs 文件中加入以下方法，固定寫法,方法內容暫時先空着，下邊繼續。。。ui

        /// <summary>
        /// Autofac引用
        /// </summary>
        /// <param name="builder"></param>
        public void ConfigureContainer(ContainerBuilder builder)
        {
            //註冊邏輯
        }

到這裏，配置操做基本上結束了，接下來根據業務具體操做！

業務場景：假若有一個通知系統，具體業務就是公司老闆經過電話系統通知手下都須要幹什麼事情！

在服務層 MyShop.Services 建立一個通知接口，而且實現該接口：

    public interface IMessageNotice
    {
        string Send(string arg);  //發送通知
    }


    /// <summary>
    /// 實現類1 電話通知
    /// </summary>
    public class MobileNotice : IMessageNotice
    {
        public string Send(string arg)
        {
            return $"電話通知系統，通知內容：{arg}";
        }
    }

在 Startup.cs 文件中註冊上邊接口，builder.RegisterType<MobileNotice>().As<IMessageNotice>()

        /// <summary>
        /// Autofac引用
        /// </summary>
        /// <param name="builder"></param>
        public void ConfigureContainer(ContainerBuilder builder)
        {
            //單個註冊
            builder.RegisterType<MobileNotice>().As<IMessageNotice>();
        }

在控制器Controller中注入 IMessageNotice接口

    public class NoticeController : ControllerBase
    {
        private readonly IMessageNotice messageNotice;

        public NoticeController(IMessageNotice _messageNotice)
        {
            messageNotice = _messageNotice;
        }


        /// <summary>
        /// 電話通知
        /// </summary>
        /// <returns></returns>
        [HttpGet]
        public async Task<IActionResult> MobileNotice()
        {
            string content = "下午不用上班";
            var result = await messageNotice.Send(content);
            return Ok(result);
        }

    }

而後運行測試：

假如：如今業務需求變了，老闆說了，如今互聯網時代，電話溝通已經不是惟一的工具了，還要系統能夠經過微信溝通，同時之前的電話通知也要支持！

很簡單，再寫個微信通知類，實現通知接口： IMessageNotice

 1     /// <summary>
 2     /// 微信通知
 3     /// </summary>
 4     public class WebChatNotice : IMessageNotice
 5     {
 6         //普通發送
 7         public string Send(string arg)
 8         {
 9             return  $"微信通知系統，通知內容：{arg}";
10         }
11 
12         //異步發送
13         public Task<string> SendAsync(string arg)
14         {
15             return Task.Run(() => { return $"微信通知系統，通知內容：{arg}"; });
16         }
17 
18     }

同時在 Startup 中註冊微信接口

        /// <summary>
        /// Autofac引用
        /// </summary>
        /// <param name="builder"></param>
        public void ConfigureContainer(ContainerBuilder builder)
        {
            //註冊電話接口
            builder.RegisterType<MobileNotice>().As<IMessageNotice>();

            //註冊微信接口
            builder.RegisterType<WebChatNotice>().As<IMessageNotice>();

        }

再次運行，發現電話通知變成微信通知了！可是電話通知卻沒有了，這是由於上邊微信接口註冊時，自動把電話接口註冊覆蓋了！

老闆的要求是同時支持電話通知和微信通知，如今明顯不符合需求，那就繼續改！

修改註冊類，使用 Named<T>方法區分不一樣的實現類

        /// <summary>
        /// Autofac引用
        /// </summary>
        /// <param name="builder"></param>
        public void ConfigureContainer(ContainerBuilder builder)
        {
            //註冊電話接口
            builder.RegisterType<MobileNotice>().Named<IMessageNotice>("mobile");

            //註冊微信接口
            builder.RegisterType<WebChatNotice>().Named<IMessageNotice>("webchat");

        }

而後新建個Manager文件夾，添加一個通知管理類：NoticeManager，使用Autofac內置接口 ILifetimeScope 來實現接口調用

    /// <summary>
    /// 通知管理類
    /// </summary>
    public class NoticeManager
    {
        //ILifetimeScope 是Autofac內置類
        private readonly ILifetimeScope messageNotice;

        public NoticeManager(ILifetimeScope _messageNotice)
        {
            messageNotice = _messageNotice ?? throw new ArgumentNullException(nameof(_messageNotice));
        }


        //發送通知
        public List<string> SendNotice(string arg)
        {
            var list = new List<string>();

            //使用 ResolveNamed<T>方法區分
            var mobile = messageNotice.ResolveNamed<IMessageNotice>("mobile");   //電話通知
            var webchat = messageNotice.ResolveNamed<IMessageNotice>("webchat");   //微信通知

            list.Add(mobile.Send(arg));   //調用發送電話通知
            list.Add(webchat.Send(arg));  //調用發送微信通知

            return list;
        }
    }

同時在 Startup.cs 中註冊 NoticeManager 類，本身註冊本身，至關於new了一個實例

而後在控制器Controller裏，經過構造方法注入通知管理類 NoticeManager

        private readonly NoticeManager messageNotice;
        public NoticeController(NoticeManager _messageNotice)
        {
            messageNotice = _messageNotice;
        }

        /// <summary>
        /// 通知
        /// </summary>
        /// <returns></returns>
        [HttpGet]
        public async Task<IActionResult> MobileNotice()
        {
            string content = "下午不用來上班";
            var getlist = await Task.Run(() => { return messageNotice.SendNotice(content); });
            return Ok(getlist);
        }

如今再次運行，已經按照老闆的需求同時支持電話和微信通知了！

第三步：批量註冊

使用 RegisterAssemblyTypes 方法能夠按照程序集實現批量註冊，好處就很少說了！

批量註冊和單個類型註冊不衝突，能夠同時存在！

        /// <summary>
        /// Autofac引用
        /// </summary>
        /// <param name="builder"></param>
        public void ConfigureContainer(ContainerBuilder builder)
        {
            //註冊電話接口
            builder.RegisterType<MobileNotice>().Named<IMessageNotice>("mobile");

            //註冊微信接口
            builder.RegisterType<WebChatNotice>().Named<IMessageNotice>("webchat");

            //註冊管理類 本身註冊本身
            //builder.RegisterType<NoticeManager>();

            //批量註冊程序集 沒有接口，而且以Manager結尾的類,能夠代替上邊的 NoticeManager類註冊
            var myshopapibll = Assembly.Load("MyShopApi");
            builder.RegisterAssemblyTypes(myshopapibll)
            .Where(t=>t.Name.EndsWith("Manager"));


            //批量註冊程序集  有接口
            var basedir = AppContext.BaseDirectory;
            var bllservice = Path.Combine(basedir, "MyShop.Services.dll");
            if (!File.Exists(bllservice))
            {
                var msg = "MyShop.Services.dll不存在";
                throw new Exception(msg);
            }
            var assemblysServices = Assembly.LoadFrom(bllservice);  //Assembly.Load("MyShop.Services");
            builder.RegisterAssemblyTypes(assemblysServices)   //多個程序集用逗號","分割
            .AsImplementedInterfaces()   //批量關聯，讓全部註冊類型自動與其繼承的接口進行關聯
            .InstancePerDependency();    //瞬時模式
        }

批量註冊類型，當一個接口存在多個實現類時，若是不用 Named<T> 方法區分，也能夠使用 IEnumerable<T> 方式注入構造函數獲取實例，二者效果相同，以下標紅部分：

    public class NoticeManager
    {
        private readonly ILifetimeScope lifetimeScope;                //ILifetimeScope 是Autofac內置類
        private readonly IEnumerable<IMessageNotice> messageNotices;  //使用IEnumerable<IMessageNotice>格式注入
        public NoticeManager(ILifetimeScope _lifetimeScope, IEnumerable<IMessageNotice> _messageNotices)
        {
            lifetimeScope = _lifetimeScope ?? throw new ArgumentNullException(nameof(_lifetimeScope));
 messageNotices = _messageNotices ?? throw new ArgumentNullException(nameof(_messageNotices));
        }


        //發送通知
        public List<string> SendNotice(string arg)
        {
            var list = new List<string>();

            //方式1：使用 ResolveNamed<T>方法區分
            //var mobile = lifetimeScope.ResolveNamed<IMessageNotice>("mobile");   //電話通知
            //var webchat = lifetimeScope.ResolveNamed<IMessageNotice>("webchat");   //微信通知


            //方式2 使用IEnumerable<IMessageNotice> 獲取實例,效果和 Named<T> 註冊相同
            var mobile = messageNotices.Where(t=>t.GetType()==typeof(MobileNotice)).FirstOrDefault();   //電話通知
            var webchat = messageNotices.Where(t => t.GetType() == typeof(WebChatNotice)).FirstOrDefault();   //微信通知

            list.Add(mobile.Send(arg));   //發送電話通知
            list.Add(webchat.Send(arg));  //發送微信通知

            return list;
        }
    }

測試結果跟上邊同樣

第四步：擴展

爲了使代碼顯的更整潔，能夠對 Autofac註冊內容進行封裝！

新建一個擴展文件夾：Extensions，而後在裏邊新建一個擴展類：AutofacExtension 並繼承 Autofac.Module，而後把 Startup.cs 中Autofac的註冊內容剪切過來！

 1     public class AutofacExtension : Autofac.Module
 2     {
 3         //重寫Load函數
 4         protected override void Load(ContainerBuilder builder)
 5         {
 6             //註冊電話接口
 7             builder.RegisterType<MobileNotice>().Named<IMessageNotice>("mobile");
 8 
 9             //註冊微信接口
10             builder.RegisterType<WebChatNotice>().Named<IMessageNotice>("webchat");
11 
12             //註冊管理類 本身註冊本身
13             //builder.RegisterType<NoticeManager>();
14 
15             //批量註冊程序集 沒有接口，而且以Manager結尾的類,能夠代替上邊的 NoticeManager類註冊
16             var myshopapibll = Assembly.Load("MyShopApi");
17             builder.RegisterAssemblyTypes(myshopapibll)
18             .Where(t => t.Name.EndsWith("Manager"));
19 
20 
21             //批量註冊程序集  有接口
22             var basedir = AppContext.BaseDirectory;
23             var bllservice = Path.Combine(basedir, "MyShop.Services.dll");
24             if (!File.Exists(bllservice))
25             {
26                 var msg = "MyShop.Services.dll不存在";
27                 throw new Exception(msg);
28             }
29             var assemblysServices = Assembly.LoadFrom(bllservice);  //Assembly.Load("MyShop.Services");
30             builder.RegisterAssemblyTypes(assemblysServices)   //多個程序集用逗號","分割
31             .AsImplementedInterfaces()   //批量關聯，讓全部註冊類型自動與其繼承的接口進行關聯
32             .InstancePerDependency();    //瞬時模式
33         }
34     }

同時修改 Startup 文件中的內容以下：

1         /// <summary>
2         /// Autofac引用
3         /// </summary>
4         /// <param name="builder"></param>
5         public void ConfigureContainer(ContainerBuilder builder)
6         {
7             builder.RegisterModule(new AutofacExtension());
8         }