掌握DRY原則：在C#中應用設計模式以獲得更乾淨的代碼

步驟和示例：

1. 初始程式碼：生成員工ID的邏輯直接位於按鈕的點擊事件處理程序中。

   

2. 重構程式碼：Tim通過使其更靈活來提高方法的改進。 方法不再依賴於特定的UI元素，現在接受lastName作為參數並返回生成的ID。 此更改允許該方法在各種上下文和UI元素中使用：

   private string GenerateEmployeeID(string firstName, string lastName)
   {
     string employeeID = firstName.Substring(0, 4) + lastName.Substring(0, 4) + DateTime.Now.Millisecond.ToString();
     return employeeID;
   }

   private string GenerateEmployeeID(string firstName, string lastName)
   {
     string employeeID = firstName.Substring(0, 4) + lastName.Substring(0, 4) + DateTime.Now.Millisecond.ToString();
     return employeeID;
   }

   Tim然後展示如何從點擊事件中調用此方法：

   employeeIdText.Text = GenerateEmployeeID(firstNameText.Text, lastNameText.Text);

   employeeIdText.Text = GenerateEmployeeID(firstNameText.Text, lastNameText.Text);

   他還提到，現在這個方法可以在應用程式的其他部分使用，例如在處理包含多個員工紀錄的CSV文件時，而無需重複程式碼。

步驟和示例：

1. 創建類程式庫：

   • Tim在(9:47)創建了一個新的.NET Framework類程式庫專案，命名為DRYDemoLibrary。

   • 在此程式庫中，他定義了一個公共類GenerateEmployeeID方法移動到此類中：

     public class EmployeeProcessor
     {
      public string GenerateEmployeeID(string firstName, string lastName)
      {
         string employeeID = firstName.Substring(0, 4) + lastName.Substring(0, 4) + DateTime.Now.Millisecond.ToString();
         return employeeID;
      }
     }

     public class EmployeeProcessor
     {
      public string GenerateEmployeeID(string firstName, string lastName)
      {
         string employeeID = firstName.Substring(0, 4) + lastName.Substring(0, 4) + DateTime.Now.Millisecond.ToString();
         return employeeID;
      }
     }

2. 在專案中使用類程式庫：

   • 在他的WinForms(13:18)和WPF專案(14:00)中，Tim添加了一個到DRYDemoLibrary類程式庫的引用。

   • 然後他用來自類程式庫的GenerateEmployeeID方法調用代替了舊程式碼：

     EmployeeProcessor processor = new EmployeeProcessor();
     employeeIDText.Text = processor.GenerateEmployeeID(firstNameText.Text, lastNameText.Text);

     EmployeeProcessor processor = new EmployeeProcessor();
     employeeIDText.Text = processor.GenerateEmployeeID(firstNameText.Text, lastNameText.Text);

   • 這種方法消除了冗餘，因為該方法現在只需在一個地方進行維護。 Tim證明相同的類程式庫可以在不同的UI框架（WinForms和WPF）間重複使用而無需重複程式碼。

3. 優勢：

   • 一致性：通過在類程式庫中集中化邏輯，Tim確保對邏輯（例如，修正錯誤）的更改在所有專案中均能一致應用。

   • 減少維護：方法中的更改只需在類程式庫中進行，避免不一致並降低維護負擔。

步驟和示例：

1. 創建新解決方案和專案：

   • Tim在(17:29)開始創建一個新解決方案用於控制台應用程序，模擬一個使用DRYDemoLibrary於不同類型專案（如Windows服務或控制台應用程序）的場景。

   • 他命名新專案為ConsoleUI並展示如何設置一個基本控制台應用程序。

     class Program
     {
      static void Main(string[] args)
      {
         Console.ReadLine();
      }
     }

     class Program
     {
      static void Main(string[] args)
      {
         Console.ReadLine();
      }
     }

2. 添加對類程式庫的引用：

   • Tim解釋如何在新專案中添加對DRYDemoLibrary DLL的引用。 這包括瀏覽到類程式庫專案bin文件夾中的DLL文件，並將其添加到控制台應用程序。

     using DRYDemoLibrary;

     using DRYDemoLibrary;

   • 添加引用後，Tim(19:24)使用程式庫中的EmployeeProcessor類生成基於用戶輸入的員工ID。

     Console.WriteLine("What is your first name?");
     string firstName = Console.ReadLine();
     
     Console.WriteLine("What is your last name?");
     string lastName = Console.ReadLine();
     
     EmployeeProcessor processor = new EmployeeProcessor();
     string employeeID = processor.GenerateEmployeeID(firstName, lastName);
     
     Console.WriteLine($"Your employee ID is {employeeID}");

     Console.WriteLine("What is your first name?");
     string firstName = Console.ReadLine();
     
     Console.WriteLine("What is your last name?");
     string lastName = Console.ReadLine();
     
     EmployeeProcessor processor = new EmployeeProcessor();
     string employeeID = processor.GenerateEmployeeID(firstName, lastName);
     
     Console.WriteLine($"Your employee ID is {employeeID}");

3. 運行控制台應用程序：

   • Tim展示運行控制台應用程序，以顯示它成功使用該程式庫生成員工ID。 這確認相同的程式庫程式碼可以在不同專案中重複使用。

     

4. 更新DLL：

   • Tim簡要提到，如果DLL更改，可以在引用它的專案中進行更新。 他指出，儘管本視頻未詳細介紹，但使用NuGet包是管理和更新多個專案中DLL的推薦方法。

關鍵點：

1. 創建一個NuGet包：

   • Tim建議將類程式庫創建為NuGet包，以替代手動管理DLL文件。 這涉及將DLL包裝成NuGet包並上傳到NuGet伺服器（私有或公開）。

2. 更新包：

   • 通過使用NuGet包，您可以在引用它的所有專案中更新程式庫，只需更新包版本即可。 這能確保一致性並減少版本不匹配或遺漏更新的風險。

3. 好處：

   • 集中管理：NuGet包提供了一種集中管理程式庫版本和依賴關係的方法。

   • 更新便利性：使在多個專案中更新程式庫變得更容易且更可靠。

   • 整合：NuGet與各種開發工具和環境整合，簡化了管理程式庫依賴關係的過程。

初始測試設置

Tim一開始運行一個目前因DLL中的錯誤而失敗的單元測試。 他強調單元測試在識別問題方面的重要性，甚至當程式碼不在主要解決方案中時。 程式碼預期一個4個字母的輸入，但Tim卻傳遞了一個3個字母的名字，這導致即使它未直接包含在解決方案中，DLL文件中的程式崩潰。

重構程式碼以解決錯誤

為了解決名字處理問題，Tim對程式碼進行了重構。 他解釋了如何通過創建新的類程式庫專案(23:50)，將DRY應用於開發中。 這種方法確保對多個對象的更改可以一次進行並有效測試，而不需重複修正。

添加單元測試

Tim在類程式庫專案中引入了一個新的測試類名為EmployeeProcessorTest，並使用XUnit設置了單元測試。 他展示了如何創建一個生成員工ID的測試方法，並討論了模擬依賴關係而不是依賴實際值的重要性。

編寫測試方法

Tim編寫了一個名為GenerateEmployeeID_ShouldCalculate的單元測試方法。 他設置了一個帶內聯數據的理論來測試不同場景，確保方法返回預期結果。 他還解釋了如何使用Assert.Equal來驗證輸出。

public class EmployeeProcessorTest
{
   [Theory]
   [InlineData("Timothy", "Corey", "TimoCore")]
   public void GenerateEmployeeID_ShouldCalculate(string firstName, string lastName, string expectedStart)
   {
      // Arrange
      var processor = new EmployeeProcessor();

      // Act
      var actualStart = processor.GenerateEmployeeID(firstName, lastName).Substring(0, 8);

      // Assert
      Assert.Equal(expectedStart, actualStart);
   }
}

public class EmployeeProcessorTest
{
   [Theory]
   [InlineData("Timothy", "Corey", "TimoCore")]
   public void GenerateEmployeeID_ShouldCalculate(string firstName, string lastName, string expectedStart)
   {
      // Arrange
      var processor = new EmployeeProcessor();

      // Act
      var actualStart = processor.GenerateEmployeeID(firstName, lastName).Substring(0, 8);

      // Assert
      Assert.Equal(expectedStart, actualStart);
   }
}

運行單元測試

Tim強調對動態數據，如日期時間值的模擬以控制測試條件和結果的重要性。 他討論了處理動態字符串的挑戰，以及如何通過使用控制的值來測試不同的場景。 然後他運行了單元測試，但在這之前，他添加了兩個必須運行測試的NuGet套件：xunit.runner.visualstudio。

成功運行所有測試之後一個內聯數據的輸出結果如下所示：

現今於(31:30)，Tim添加了另一個內聯數據，並將子字串的第二個參數更改為expectedStart.Length。

public class EmployeeProcessorTest
{
   [Theory]
   [InlineData("Timothy", "Corey", "TimoCore")]
   [InlineData("Tim", "Corey", "TimCore")]
   public void GenerateEmployeeID_ShouldCalculate(string firstName, string lastName, string expectedStart)
   {
      var processor = new EmployeeProcessor();
      var actualStart = processor.GenerateEmployeeID(firstName, lastName).Substring(0, expectedStart.Length);
      Assert.Equal(expectedStart, actualStart);
   }
}

public class EmployeeProcessorTest
{
   [Theory]
   [InlineData("Timothy", "Corey", "TimoCore")]
   [InlineData("Tim", "Corey", "TimCore")]
   public void GenerateEmployeeID_ShouldCalculate(string firstName, string lastName, string expectedStart)
   {
      var processor = new EmployeeProcessor();
      var actualStart = processor.GenerateEmployeeID(firstName, lastName).Substring(0, expectedStart.Length);
      Assert.Equal(expectedStart, actualStart);
   }
}

在(32:05)再次運行單元測試後，第二個理論導致測試失敗：

通過私有方法改進程式碼

為遵循DRY，Tim進一步通過在DRYDemoLibrary下的實際GetPartOfName來對程式碼進行了重構。 這一方法處理名稱部分的提取，提升程式碼重用性和可讀性。 Tim做了以下更改：

public string GenerateEmployeeID(string firstName, string lastName)
{
   string employeeID = $@"{GetPartOfName(firstName, 4)}{GetPartOfName(lastName, 4)}{DateTime.Now.Millisecond.ToString()}";
   return employeeID;
}

private string GetPartOfName(string name, int numberOfCharacters)
{
   string output = name;

   if (name.Length > numberOfCharacters)
   {
      output = name.Substring(0, numberOfCharacters);
   }

   return output;
}

public string GenerateEmployeeID(string firstName, string lastName)
{
   string employeeID = $@"{GetPartOfName(firstName, 4)}{GetPartOfName(lastName, 4)}{DateTime.Now.Millisecond.ToString()}";
   return employeeID;
}

private string GetPartOfName(string name, int numberOfCharacters)
{
   string output = name;

   if (name.Length > numberOfCharacters)
   {
      output = name.Substring(0, numberOfCharacters);
   }

   return output;
}

更新單元測試

Tim更新了單元測試以反映程式碼中的更改，例如修改子字串的預期長度。 他解釋了如何通過運行這些測試來快速識別問題，並驗證程式碼是否符合新要求。 Tim添加了新理論，然後運行單元測試以驗證輸出是否符合預期：

創建.NET標準程式庫

減少開發中的重複

Tim Corey強調，通過採用.NET標準程式庫，您不僅可減少程式碼庫中的程式碼重複，還可以在開發過程中減少重複。 與其在不同的平台專案中重複程式碼，不如將其集中在一個在多個環境中工作的單一程式庫中。

好處：

• 統一的程式碼庫：一個程式碼庫對於多個平台減少了維護和更新程式碼所需的工作量。
• 簡化測試：使用.NET標準程式庫，您可以一次編寫單元測試，並確保它們適用於所有支持的平台。

測試和調試：Tim將單元測試引入作為進一步減少努力和重複的方法。 自動化測試驗證了程式碼的正確性，而無需手動測試每次應用程序的迭代。