2018年4月18日 星期三

Unity Part 3 : Unity Container 容器的使用自動註冊

在上一篇 Unity Part 2 : Unity Container 容器的使用 XML 註冊 文章中,我們透過 App.Config 這個 XML 系統組態檔案,進行 Unity 容器所需要用到型別註冊,雖然這個方法可以讓我們不用使用程式碼的方式來進行型別註冊,再不重新編譯程式碼與產生新的組件情況之下,我們可以透過系統組態檔案進行重新調整型別對應的關係,這樣的操作也是相當具有彈性。在這篇文章之中,我們將來說明第三種的 Unity 容器之型別註冊方法,那就是使用自動掃描組件內的所有型別,自動產生 Unity 容器所需用到的型別註冊,在這裡,我們也可以稱為這樣的註冊方式為抽象型別的慣例註冊,關於更多 慣例註冊或者自動註冊的說明,可以參考 Registration by Convention.aspx)
在這裡,我們將要延續上一篇的專案,來進行使用自動註冊的方式,宣告相依性注入的對應關係
本篇文章的專案範例原始碼,可以從 UnityAutoRegistration 取得

建立練習專案

  • 點選 Visual Studio 2017 功能表 [檔案] > [新增] > [專案]
  • 當出現 [新增專案] 對話窗,點選 [已安裝] > [Visual C#] > [主控台應用程式] ,並且在最下方 [名稱] 欄位處,輸入 UnityAutoRegistration ,作為此練習的開發專案名稱。
Unity Dependency Injection
  • 使用滑鼠右擊該專案節點,選擇 [管理 NuGet 套件] ,點選 [瀏覽] 標籤頁次,在搜尋文字輸入盒中,輸入 Unity 關鍵字。
  • 當出現 Unity NuGet 套件之後,選擇這個套件,安裝到這個練習專案中
Manage NuGet for Unity Dependency Injection
  • 滑鼠雙擊 [Program.cs] 這個節點檔案,使用底下程式碼將其替換
  • 在這裡,我們定義了兩個介面合約 IEmployee , ICompany
  • 另外,我們實作 IEmployee 的具體類別 Employee,在這裡類別中,我們分別展示如何使用建構式注入、屬性注入、方法注入,因此,我們在這個實作類別中,定義了三個屬性 PropertyInjectionCompany , ConstructorInjectionCompany , MethodInjectionCompany
  • 我們也實作 ICompany 的具體類別 Company,在這個類別的建構式內,我們將會顯示出當時產生物件的雜湊碼,透過了雜湊碼我們就可以區分出,再透過不同相依性注入而得到的物件,究竟是不是同一個執行個體。
  • 當我們建立起一個 UnityContainer 執行個體之後,我們使用擴充方法 UnityContainer.RegisterTypes 這個擴充方法,來進行抽象型別與具體實作型別的自動註冊。。
C Sharp / C#
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Unity;
using Unity.Attributes;
using Unity.RegistrationByConvention;

namespace UnityAutoRegistration
{
    public interface IEmployee
    {
        void DisplaySalary();
    }
    public class Employee : IEmployee
    {
        [Dependency]
        public ICompany PropertyInjectionCompany { get; set; }
        public ICompany ConstructorInjectionCompany { get; set; }
        public ICompany MethodInjectionCompany { get; set; }

        [InjectionConstructor]
        public Employee(ICompany tmpCompany)
        {
            ConstructorInjectionCompany = tmpCompany;
        }

        [InjectionMethod]
        public void Initialize(ICompany tmpCompany)
        {
            MethodInjectionCompany = tmpCompany;
        }
        public void DisplaySalary()
        {
            PropertyInjectionCompany.ShowSalary();
            ConstructorInjectionCompany.ShowSalary();
            MethodInjectionCompany.ShowSalary();

            Console.WriteLine($"Property Injection Object Hash Code is {PropertyInjectionCompany.GetHashCode()}");
            Console.WriteLine($"Constructor Injection Object Hash Code is {ConstructorInjectionCompany.GetHashCode()}");
            Console.WriteLine($"Method Injection Object Hash Code is {MethodInjectionCompany.GetHashCode()}");
        }
    }

    public interface ICompany
    {
        void ShowSalary();
    }
    public class Company : ICompany
    {
        public Company()
        {
            Console.WriteLine($"Company Object Hash Code = {this.GetHashCode()}");
        }
        public void ShowSalary()
        {
            Console.WriteLine("你的薪水是 22 K");
        }
    }

    class Program
    {
        static void Main(string[] args)
        {
            var container = new UnityContainer();
            container.RegisterTypes(
                AllClasses.FromLoadedAssemblies(),
                WithMappings.FromMatchingInterface,
                WithName.Default,
                WithLifetime.ContainerControlled);

            IEmployee emp = container.Resolve<IEmployee>();
            emp.DisplaySalary();

            Console.WriteLine("Press any key for continuing...");
            Console.ReadKey();

        }
    }
}

進行測試

  • 我們可以開始執行這個專案,您將會得到底下的內容
  • 我們的主程式一開始將會建立一個 UnityContainer 物件
  • 接著透過這個敘述 container.RegisterTypes(AllClasses.FromLoadedAssemblies(),WithMappings.FromMatchingInterface,WithName.Default,WithLifetime.ContainerControlled); 就會自動掃描組件內的所有型別,並且進行註冊的動作。
  • 我們將會透過 IUnityContainer.Resolve 方法,解析出 IEmployee 介面的具體實作物件出來
  • 透過解析出來的具體實作物件,我們將會呼叫該具體實作物件的 DisplaySalary 方法
Console
Company Object Hash Code = 42750725
Company Object Hash Code = 49212206
Company Object Hash Code = 40256670
你的薪水是 22 K
你的薪水是 22 K
你的薪水是 22 K
Property Injection Object Hash Code is 49212206
Constructor Injection Object Hash Code is 42750725
Method Injection Object Hash Code is 40256670
Press any key for continuing...

進階閱讀

其他相關文章

更多關於 Xamarin / Xamarin.Forms 教學、技術分享、用法文章,請參考 I ♥ Xamarin

沒有留言:

張貼留言