2018年4月17日 星期二

Unity Part 2 : Unity Container 容器的使用 XML 註冊

在上一篇 Unity Part 1 : 使用 Unity 容器進行各種相依性注入的操作的練習 文章中,我們實際進行 Unity 容器的註冊與解析操作,不過,在這個練習中,我們是將介面與具體實作類別的對應關係,使用程式碼的方式,註冊到容器中,在這篇文章中,我們將會使用 App.config 組態檔定檔案來進行相依性注入的註冊動作,關於 組態檔定檔案 的相關說明,可以參考 逐步解說:使用組態檔定義資料來源
在這裡,我們將要延續上一篇的專案,來進行使用 XML 組態設定檔案的方式,宣告相依性注入的對應關係
本篇文章的專案範例原始碼,可以從 UnityConfigurationXML 取得

建立練習專案

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

namespace UnityConfigurationXML
{
    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().LoadConfiguration();

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

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

        }
    }
}
  • 使用滑鼠雙擊 App.config 這個節點檔案,將底下 XML 內容將其予以替換掉
  • 我們在 container 段落中,進行了介面與具體實作類別的對應宣告
  • 更多關於如何使用系統組態檔案進行其他的 Unity 相依性注入的設定,可以參考 The Unity Configuration Schema.aspx)
XML
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <!--<section name="unity" type="Microsoft.Practices.Unity.Configuration.UnityConfigurationSection, Microsoft.Practices.Unity.Configuration"/>-->
    <section name="unity" type="Microsoft.Practices.Unity.Configuration.UnityConfigurationSection, Unity.Configuration"/>
  </configSections>

  <unity xmlns="http://schemas.microsoft.com/practices/2010/unity">
    <namespace name="UnityConfigurationXML" />
    <assembly name="UnityConfigurationXML" />

    <container>
      <register type="IEmployee" mapTo="Employee" />
      <register type="ICompany" mapTo="Company" />
    </container>
  </unity>

  <startup>
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.1" />
  </startup>
</configuration>

進行測試

  • 我們可以開始執行這個專案,您將會得到底下的內容
  • 我們的主程式一開始將會建立一個 UnityContainer 物件,接著呼叫 LoadConfiguration 方法,讀取系統組態檔案,進行相依性注入的註冊,最後,我們將會得到 UnityContainer 類別的執行個體
  • 我們將會透過 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

沒有留言:

張貼留言