DRY Prensibini Uzmanlaşmak: Daha Temiz Kod İçin C#'da Tasarım Kalıplarını Uygulamak

Adımlar ve Örnek:

1. İlk Kod: Çalışan ID'si oluşturma mantığı bir düğmenin tıklama olay işleyicisindeydi.

   

2. Refaktörlenmiş Kod: Tim, metodu daha esnek hale getirerek geliştirir. Belirli UI elemanlarina bagli kalmak yerine, metot simdi firstName ve lastName parametrelerini kabul eder ve oluşturulan ID'yi geri dondurur. Bu değişiklik, metodun çeşitli bağlamlarda ve UI öğelerinde kullanılmasını sağlar:

   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 daha sonra, bu metodun tıklama olayından nasıl çağrıldığını gösteriyor:

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

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

   Ayrıca bu metodun, birden fazla çalışan kaydı içeren CSV dosyalarını işleme gibi uygulamanın diğer bölümlerinde kullanılabileceğini belirtiyor, böylece kodu tekrar etmeden.

Adımlar ve Örnek:

1. Sınıf Kütüphanesi Oluşturulması:

   • Tim, (9:47)'de .NET Framework'te yeni bir sınıf kütüphanesi projesi oluşturarak adını DRYDemoLibrary koyuyor.

   • Bu kütüphane içinde EmployeeProcessor adında genel bir sınıf tanımlar ve GenerateEmployeeID metodunu bu sınıfa taşır:

     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. Projelerde Sınıf Kütüphanesini Kullanma:

   • Tim, WinForms (13:18) ve WPF projelerinde (14:00), DRYDemoLibrary sınıf kütüphanesine bir referans ekler.

   • Daha sonra eski kodu, sınıf kütüphanesinden GenerateEmployeeID metoduna yapılan çağrılarla değiştirir:

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

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

   • Bu yaklaşım, yöntemin artık tek bir yerde bakımı yapıldığından dolayı, tekrarı ortadan kaldırır. Tim, aynı sınıf kütüphanesinin farklı UI çerçeveleri (WinForms ve WPF) arasında tekrarlanmadan kullanılabileceğini gösterir.

3. Avantajları:

   • Tutarlılık: Mantığı bir sınıf kütüphanesinde merkezi hale getirerek, Tim, mantıktaki değişikliklerin (örneğin hata düzeltmeleri) tüm projelerde aynı şekilde uygulanmasını sağlar.

   • Bakım Azalır: Yöntem değişiklikleri yalnızca sınıf kütüphanesinde yapılır, bu da tutarsızlıkları önler ve bakım yükünü azaltır.

Adımlar ve Örnek:

1. Yeni Çözüm ve Proje Oluşturma:

   • Tim, (17:29)'da, bir konsol uygulaması için yeni bir çözüm oluşturarak, DRYDemoLibrary'yi Windows hizmeti veya konsol uygulaması gibi farklı projelerde kullanmanız gereken bir senaryoyu simüle eder.

   • Yeni projeye ConsoleUI adını verir ve temel bir konsol uygulaması kurmanın nasıl yapıldığını gösterir.

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

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

2. Sınıf Kütüphanesine Referans Ekleme:

   • Tim, yeni projede DRYDemoLibrary DLL dosyasına nasıl referans ekleneceğini açıklar. Bu, sınıf kütüphanesi projesinin bin dizinindeki DLL dosyasına göz atmayı ve onu konsol uygulamasına eklemeyi içerir.

     using DRYDemoLibrary;

     using DRYDemoLibrary;

   • Referans eklendikten sonra, Tim (19:24), kütüphaneden EmployeeProcessor sınıfını kullanarak kullanıcı girdisine dayalı olarak bir çalışan ID'si oluşturur.

     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. Konsol Uygulamasını Çalıştırma:

   • Tim, kütüphaneyi kullanarak başarıyla çalışan ID'si oluşturduğunu göstermek için konsol uygulamasını çalıştırır. Bu, sınıf kütüphanesindeki aynı kodun farklı projelerde yeniden kullanılabileceğini doğrular.

     

4. DLL Güncelleme:

   • Tim, DLL değişirse, ona referans yapan projelerde güncelleme yapabileceğinizi kısaca belirtir. Bu videoda detaylarına değinilmese de, birden fazla projede DLL'lerin yönetimi ve güncellenmesi için NuGet paketleri kullanmanın önerilen bir yaklaşım olduğunu belirtir.

Ana Noktalar:

1. Bir NuGet Paketi Oluşturma:

   • DLL dosyalarını manuel olarak yönetmek yerine, Tim sınıf kütüphanesi için bir NuGet paketi oluşturmayı önerir. Bu, DLL'yi bir NuGet paketi olarak paketlemeyi ve bir NuGet sunucusuna (özel veya genel) yüklemeyi içerir.

2. Paketlerin Güncellenmesi:

   • Bir NuGet paketi kullanarak, referans yapan tüm projelerde kütüphaneyi güncellemek için sadece paket sürümünü güncellemeniz yeterlidir. Bu yaklaşım, tutarlılığı sağlar ve sürüm uyuşmazlıkları veya eksik güncellemeler riskini azaltır.

3. Faydaları:

   • Merkezi Yönetim: NuGet paketleri, kütüphane sürümlerini ve bağımlılıklarını yönetmek için merkezi bir yol sağlar.

   • Güncelleme Kolaylığı: Kütüphaneyi birden fazla proje arasında güncellemek daha kolay ve güvenilir hale gelir.

   • Entegrasyon: NuGet, çeşitli geliştirme araçları ve ortamları ile entegre olur, kütüphane bağımlılıklarını yönetme sürecini kolaylaştırır.

İlk Test Kurulumu

Tim, bir hatadan dolayı şu anda başarısız olan bir birim testi çalıştırarak başlar. Kodu ana çözümün dışında olsa bile sorunları belirlemek için birim testlerinin önemini vurgular. Kod, 4 harfli bir girdi bekliyordu, ancak Tim bir 3 harfli isim geçerek çözümde doğrudan eklenmemiş olsa bile DLL dosyasında çökmeye neden oldu.

Hatalara Yönelik Kodu Yeniden Düzenleme

Ad yönetimiyle ilgili sorunu çözmek için Tim kodu yeniden düzenler. DRY'yi geliştirmenin bir yolu olarak yeni bir sınıf kütüphanesi projesi oluşturmayı (23:50) açıklar. Bu yaklaşım, birden fazla nesne üzerindeki değişikliklerin bir kez yapılmasını ve tekrar etmeksizin etkili bir şekilde test edilmesini sağlar.

Birim Testler Ekleme

Tim, sınıf kütüphanesi projesinde EmployeeProcessorTest adında yeni bir test sınıfı tanıtarak ve XUnit kullanarak birim testler kurar. Çalışan ID'leri oluşturmak için bir test metodu nasıl oluşturulacağını ve bağımlılıkların taklit edilmesinin önemini, gerçek değerlere güvenmek yerine tartışır.

Bir Test Metodu Yazma

Tim, GenerateEmployeeID_ShouldCalculate adında bir birim test metodu yazar. Yöntemin beklenen sonuçları döndürmesini sağlamak için farklı senaryoları test etmek amacıyla satır içi verilerle bir teori kurar. Çıktıyı doğrulamak için Assert.Equal nasıl kullanılır açıklamalar yapar.

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);
   }
}

Birim Testi Çalıştırma

Tim, dinamik verileri, örneğin tarih-saat değerlerini test koşullarını ve sonuçlarını kontrol etmek için taklit etmenin önemini vurgular. Dinamik dizelerle çalışmanın zorluğunu ve kontrol edilen değerler kullanarak farklı senaryoları test etmenin yollarını tartışır. Daha sonra birim testini çalıştırır; ancak bundan önce, testlerin çalışabilmesi için gerekli iki NuGet paketini ekler: xunit.runner.console ve xunit.runner.visualstudio.

Bir satır içi veri için tüm testlerin başarılı bir şekilde çalıştırılmasının ardından çıktı şu şekilde gösterilir:

Şimdi (31:30)'da Tim başka bir satır içi veri ekledi ve alt dizi ikinci parametresini expectedStart.Length olarak değiştirdi:

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)'te, yeni teori ile birim testi tekrar çalıştırdıktan sonra test başarısız oldu:

Özel Yöntemlerle Kodu İyileştirme

DRY ilkesine uymak için Tim, DRYDemoLibrary'deki EmployeeProcessor sınıfı altında GetPartOfName adında özel bir metot oluşturarak kodu daha da düzenledi. Bu yöntem, adın parçalarının çıkarılmasını ele alır, kodun yeniden kullanılabilirliğini ve okunabilirliğini artırır. Tim aşağıdaki değişiklikleri yaptı:

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;
}

Birim Testlerini Güncelleme

Tim, koddaki değişiklikleri, örneğin alt dizelerin beklenen uzunluğunu değiştirmek gibi, yansıtmak için birim testlerini günceller. Bu testlerin çalıştırılmasının, sorunları hızla tanımlamaya yardımcı olduğunu ve kodun yeni gereksinimleri karşıladığını doğrulayan bir yol olduğunu açıklar. Tim, yeni teoriler ekleyip birim testleri çalıştırarak çıktının beklenilen gibi olup olmadığını doğrular:

Bir .NET Standard Kütüphanesi Oluşturma

Geliştirmede Tekrarı Azaltma

Tim Corey, bir .NET Standard kütüphanesini benimseyerek, yalnızca kod tabanınızda değil, aynı zamanda geliştirme sürecinde de kod tekrarını en aza indirdiğinizi vurgular. Farklı platforma özgü projelerde kodu çoğaltmak yerine, onu birden fazla ortamda çalışan tek bir kütüphanede merkezsizleştirirsiniz.

Faydaları:

• Birleştirilmiş Kod Tabanı: Çeşitli platformlar için tek bir kod tabanı, kodunuzu korumak ve güncellemek için gereken çabayı azaltır.
• Basitleştirilmiş Test Yapma: Bir .NET Standard kütüphanesi ile, birim testleri bir kez yazabilir ve bunların tüm desteklenen platformlara uygulanmasını sağlayabilirsiniz.

Test ve Hata Ayıklama: Tim, çabayı ve tekrarları daha da azaltmak için birim testleri tanıtır. Otomatik testler kodunuzun doğruluğunu manuel olarak her uygulama yinelemesini test etmeye gerek kalmadan doğrular.