Flunt C# (Geliştiriciler için Nasıl Çalışır)

C#'ta Flunt Nasıl Kullanılır

1. Yeni bir C# konsol projesi oluşturun.
2. NuGet'ten Flunt paketini yükleyin.
3. Ad alanını içe aktarın ve sınıfı miras alın.
4. Veri modeline doğrulama ekleyin.
5. Doğrulama kontrolleri yapın ve sonucu gösterin.

Flunt C#'ı Anlamak

Çok yönlü ve hafif .NET frameworkü, Flunt, C# uygulamalarında akıcı doğrulama ve bildirim desenlerini geliştirmeyi kolaylaştırmak için oluşturulmuştur. Geliştiriciler, akıcı ve ifadeli bir şekilde doğrulama kuralları ve iş mantığı oluştururken Flunt'u kullandıklarında kod daha okunabilir ve sürdürülebilir hale gelir. Flunt'un geniş entegre doğrulama teknikleri ve uzantıları yelpazesiyle, geliştiriciler karmaşık veri yapıları gibi nesne ve koleksiyonları kolayca doğrulayabilirler.

Ayrıca, Flunt mevcut kod tabanları ve frameworklerle kolayca entegre olduğu için .NET kütüphane uygulamalarının güvenilirliğini ve sağlamlığını artırmak için kullanışlı bir araçtır. Her şey düşünüldüğünde, Flunt daha temiz, daha sağlam kod yazmayı teşvik eden açıklayıcı bir yaklaşım önerir.

Flunt C#'a Başlarken

Flunt C# Örneği

Flunt yüklendiği anda aşağıdaki kodu kullanabilirsiniz. Bu, Flunt kullanarak doğrulama kuralları oluşturmayı gösteren basit bir örnektir:

using System;
using Flunt.Validations;

public class Program
{
    static void Main(string[] args)
    {
        var person = new Person { Name = "Jack", Age = -25 };
        var contract = new PersonContract(person);

        // Perform validation checks
        if (contract.IsValid)
        {
            Console.WriteLine("Person is valid!");
        }
        else
        {
            Console.WriteLine("Validation failed:");
            foreach (var notification in contract.Notifications)
            {
                Console.WriteLine($"- {notification.Key}: {notification.Message}");
            }
        }
    }
}

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public class PersonContract : Contract<Person>
{
    public PersonContract(Person person)
    {
        // Ensure the correct format of the object
        Requires()
            .IsNotNull(person, nameof(person))
            .IsNotEmpty(person.Name, nameof(person.Name), "Name is required")
            .IsGreaterThan(person.Age, 0, nameof(person.Age), "Age must be a positive number");
    }
}

using System;
using Flunt.Validations;

public class Program
{
    static void Main(string[] args)
    {
        var person = new Person { Name = "Jack", Age = -25 };
        var contract = new PersonContract(person);

        // Perform validation checks
        if (contract.IsValid)
        {
            Console.WriteLine("Person is valid!");
        }
        else
        {
            Console.WriteLine("Validation failed:");
            foreach (var notification in contract.Notifications)
            {
                Console.WriteLine($"- {notification.Key}: {notification.Message}");
            }
        }
    }
}

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public class PersonContract : Contract<Person>
{
    public PersonContract(Person person)
    {
        // Ensure the correct format of the object
        Requires()
            .IsNotNull(person, nameof(person))
            .IsNotEmpty(person.Name, nameof(person.Name), "Name is required")
            .IsGreaterThan(person.Age, 0, nameof(person.Age), "Age must be a positive number");
    }
}

Imports System
Imports Flunt.Validations

Public Class Program
	Shared Sub Main(ByVal args() As String)
		Dim person As New Person With {
			.Name = "Jack",
			.Age = -25
		}
		Dim contract = New PersonContract(person)

		' Perform validation checks
		If contract.IsValid Then
			Console.WriteLine("Person is valid!")
		Else
			Console.WriteLine("Validation failed:")
			For Each notification In contract.Notifications
				Console.WriteLine($"- {notification.Key}: {notification.Message}")
			Next notification
		End If
	End Sub
End Class

Public Class Person
	Public Property Name() As String
	Public Property Age() As Integer
End Class

Public Class PersonContract
	Inherits Contract(Of Person)

	Public Sub New(ByVal person As Person)
		' Ensure the correct format of the object
		Requires().IsNotNull(person, NameOf(person)).IsNotEmpty(person.Name, NameOf(person.Name), "Name is required").IsGreaterThan(person.Age, 0, NameOf(person.Age), "Age must be a positive number")
	End Sub
End Class

Person Sınıf: Bir varlığı Name ve Age özellikleriyle temsil eder.

PersonContract: Bu sınıf, Flunt'un temel konsepti olan Contract<t>'den türetilmiştir. Requires yöntemini kullanarak, yapıcı bir Person nesnesi alır ve doğrulama kuralları sağlar. Requires birden fazla doğrulama tanımlamak için zincirlenebilir bir metot sunar. Doğrulamalar, IsNotNull, IsNotEmpty, IsGreaterThan gibi yöntemler tarafından gerçekleştirilir. Her doğrulama kuralının ilişkili özel bir hata mesajı vardır.

Doğrulama: FluentValidation örneğine benzer, bu bir PersonContract ve bir Person nesnesinin örneğini oluşturur. Doğrulama sonuçları, sözleşmenin IsValid niteliği ile gösterilir. Doğrulamanın sonucuna göre başarı veya başarısızlık bildirimleri ve belirli hata mesajları gösterilir.

Flunt İşlemleri

C# uygulamalarında doğrulama ve bildirim işlemleri için Flunt çok sayıda operasyon sunar, bunlar arasında:

Doğrulama Kuralları Oluşturma: Zorunlu alanlar, veri türleri, değer aralıkları, maksimum uzunluk ve minimum uzunluk gibi nitelikler için doğrulama kuralları oluşturmak için akıcı arayüzü kullanın.

Doğrulama Yürütme: Veri bütünlüğünü ve iş mantığına uyumu garanti altına almak için nesneleri önceden tanımlanmış kurallara göre doğrulayın.

Doğrulama Hatalarını Yönetme: Doğrulama hatalarını not alın ve kaydedin, bunlara karşı nazikçe yanıt vererek kullanıcılara hata mesajları verin veya sorun giderme için hataları kaydedin.

Özel Doğrulama Mantığı: Karşılaşılan karmaşık doğrulama durumları veya belirli alan gereksinimlerine yanıt vermek için Flunt'u benzersiz doğrulama kuralları ile genişletin.

Frameworklerle Entegrasyon: Mevcut uygulamalardaki doğrulama yeteneklerini geliştirmek için Flunt, Entity Framework, ASP.NET Core ve daha fazlası dahil olmak üzere birçok tanınmış .NET framework ve kütüphanesi ile sorunsuz entegre edilebilir.

Flunt ve IronPDF Entegrasyonu

Flunt ile IronPDF'yi entegre ederek, geliştiriciler iş mantığı doğrulama ve doküman oluşturma süreçlerini hızlandırmak için her iki teknolojinin de gücünden yararlanabilirler. Geliştiriciler, Flunt ile giriş verilerini doğruladıktan sonra IronPDF'yi kullanarak PDF belgeleri oluşturarak, uygulamaları daha güvenilir ve kullanıcı dostu hale getirebilirler.

IronPDF'yi Yükleyin

• Visual Studio projesini başlatın.
• "Araçlar" > "NuGet Paket Yöneticisi" > "Paket Yöneticisi Konsolu"nu seçin.
• Paket Yöneticisi Konsolu'na bu komutu girin:

Install-Package IronPdf

• Alternatif olarak, IronPDF ve diğer gerekli NuGet Paketlerini yüklemek için Çözümler için NuGet Paket Yöneticisi'ni kullanabilirsiniz.
• Arama sonuçlarından IronPDF paketini bulup seçtikten sonra "Yükle" düğmesine tıklayın. Kurulum ve indirme işlemleri Visual Studio tarafından yönetilecektir.

• Projeniz için gerekli olan IronPDF paketini ve diğer bağımlılıkları NuGet yükleyecektir.
• Kurulumdan sonra IronPDF projenizde kullanıma hazır hale gelir.

Mantığın Uygulanması

PDF oluşturmak için IronPDF ve veri doğrulaması için Flunt kullanan temel bir C# uygulaması oluşturalım. Bu örnekte, bir kayıt formu için kullanıcı girişini doğrulamak için Flunt'u ve doğrulanmış kullanıcı verileri özetini içeren bir PDF belgesi oluşturmak için IronPDF'yi kullanacağız.

1. Kişi Sınıfı: İsim ve yaş özelliklerine sahip bir Kişi sınıfı tanımlanır. Kişi verisini, yapıcıda Flunt'un akıcı arayüzünü kullanarak önceden tanımlanmış doğrulama kurallarına göre doğrularız.
2. Pdf Oluştur: RenderHtmlAsPdf adlı bir yöntem tanımlanır ve bir Kullanıcı nesnesini girdi olarak alır. Bu işlev, IronPDF'in HtmlToPdf sınıfını kullanarak kullanıcı kayıt özetini temsil eden HTML metnini bir PDF belgesine dönüştürür.
3. Ana Metot: Ana metot içerisinde, örnek Kişi verilerini kullanarak Kullanıcı sınıfının bir örneğini oluştururuz. Son olarak, Flunt'un IsValid niteliğini kullanarak Kişi verilerinin meşru olup olmadığını belirleriz. Veriler doğru olduğunda, PDF belgesi oluşturmak için IronPdf metodunu çağırırız. Değilse, doğrulama sorunları konsolda gösterilir.

Flunt ile veri doğrulaması ve IronPDF ile PDF oluşturma işlemlerini birleştirerek C# uygulamasında kullanıcı girişini değerlendirmek ve PDF belgeleri oluşturmak için hızlı bir iş akışı geliştirdik. Bu yöntem veri bütünlüğünü sağlar, profesyonel kalitede belgeler üretir ve net, okunabilir ve sürdürülebilir kod yazımını teşvik eder. IronPDF'nin yetenekleri hakkında daha fazla bilgi edinmek için dokümantasyon sayfasına bakın. Aşağıda örnek kod snippet'i bulunmaktadır.

using IronPdf;
using System;
using System.Linq;
using System.Text;
using Flunt.Validations;

namespace ConsoleApp
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // StringBuilder for HTML content
            StringBuilder sb = new StringBuilder();
            var person = new Person { Name = "Jack", Age = -25 };
            var contract = new PersonContract(person);

            if (contract.IsValid)
            {
                Console.WriteLine("Person is valid!");
                sb.Append("<p>Person is valid!</p>");
            }
            else
            {
                sb.Append("<p>Validation failed: </p>");
                foreach (var notification in contract.Notifications)
                {
                    sb.Append($"- {notification.Key}: {notification.Message}<br>");
                }
            }

            var renderer = new HtmlToPdf();
            // Set HTML content for the page
            var pdfDocument = renderer.RenderHtmlAsPdf(sb.ToString());
            // Save the document
            pdfDocument.SaveAs("output.pdf");
            // Dispose the renderer object
            renderer.Dispose();
            // Display a message
            Console.WriteLine("Report generated successfully!");
        }
    }

    public class Person
    {
        public string Name { get; set; }
        public int Age { get; set; }
    }

    public class PersonContract : Contract<Person>
    {
        public PersonContract(Person person)
        {
            Requires()
                .IsNotNull(person, nameof(person))
                .IsNotEmpty(person.Name, nameof(person.Name), "Name is required")
                .IsGreaterThan(person.Age, 0, nameof(person.Age), "Age must be a positive number");
        }
    }
}

using IronPdf;
using System;
using System.Linq;
using System.Text;
using Flunt.Validations;

namespace ConsoleApp
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // StringBuilder for HTML content
            StringBuilder sb = new StringBuilder();
            var person = new Person { Name = "Jack", Age = -25 };
            var contract = new PersonContract(person);

            if (contract.IsValid)
            {
                Console.WriteLine("Person is valid!");
                sb.Append("<p>Person is valid!</p>");
            }
            else
            {
                sb.Append("<p>Validation failed: </p>");
                foreach (var notification in contract.Notifications)
                {
                    sb.Append($"- {notification.Key}: {notification.Message}<br>");
                }
            }

            var renderer = new HtmlToPdf();
            // Set HTML content for the page
            var pdfDocument = renderer.RenderHtmlAsPdf(sb.ToString());
            // Save the document
            pdfDocument.SaveAs("output.pdf");
            // Dispose the renderer object
            renderer.Dispose();
            // Display a message
            Console.WriteLine("Report generated successfully!");
        }
    }

    public class Person
    {
        public string Name { get; set; }
        public int Age { get; set; }
    }

    public class PersonContract : Contract<Person>
    {
        public PersonContract(Person person)
        {
            Requires()
                .IsNotNull(person, nameof(person))
                .IsNotEmpty(person.Name, nameof(person.Name), "Name is required")
                .IsGreaterThan(person.Age, 0, nameof(person.Age), "Age must be a positive number");
        }
    }
}

Imports IronPdf
Imports System
Imports System.Linq
Imports System.Text
Imports Flunt.Validations

Namespace ConsoleApp
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' StringBuilder for HTML content
			Dim sb As New StringBuilder()
			Dim person As New Person With {
				.Name = "Jack",
				.Age = -25
			}
			Dim contract = New PersonContract(person)

			If contract.IsValid Then
				Console.WriteLine("Person is valid!")
				sb.Append("<p>Person is valid!</p>")
			Else
				sb.Append("<p>Validation failed: </p>")
				For Each notification In contract.Notifications
					sb.Append($"- {notification.Key}: {notification.Message}<br>")
				Next notification
			End If

			Dim renderer = New HtmlToPdf()
			' Set HTML content for the page
			Dim pdfDocument = renderer.RenderHtmlAsPdf(sb.ToString())
			' Save the document
			pdfDocument.SaveAs("output.pdf")
			' Dispose the renderer object
			renderer.Dispose()
			' Display a message
			Console.WriteLine("Report generated successfully!")
		End Sub
	End Class

	Public Class Person
		Public Property Name() As String
		Public Property Age() As Integer
	End Class

	Public Class PersonContract
		Inherits Contract(Of Person)

		Public Sub New(ByVal person As Person)
			Requires().IsNotNull(person, NameOf(person)).IsNotEmpty(person.Name, NameOf(person.Name), "Name is required").IsGreaterThan(person.Age, 0, NameOf(person.Age), "Age must be a positive number")
		End Sub
	End Class
End Namespace

Yukarıdaki kodun yürütme çıktı aşağıdaki gibidir:

Sonuç

IronPDF ve Flunt, doküman oluşturma ve veri doğrulama iş akışlarını kolaylaştırmak için iyi beraber çalışan iki güçlü C# kütüphanesidir. IronPDF'nin gelişmiş PDF üretim özellikleri ve Flunt'un güçlü doğrulama yetenekleri ile geliştiriciler, çeşitli uygulamalar için güvenilir, etkili ve yüksek kalibreli çözümler oluşturabilirler. Flunt ve IronPDF, ister masaüstü uygulamaları, web uygulamaları, ister bulut tabanlı çözümler geliştiriyor olsun, kullanıcıların ve paydaşların ihtiyaçlarını karşılayan yüksek kaliteli yazılımlar oluşturmak için gerekli araçlarla geliştiricileri donatır.

$799 Lite paketi, bir yıl süren yazılım desteği, kalıcı bir lisans ve kütüphane güncellemesi içerir. IronPDF, maliyet ve lisans gereksinimlerine ilişkin daha fazla detay için IronPDF ücretsiz lisanslama detaylarını sağlar. Iron Software kütüphaneleri hakkında ek bilgi için Iron Software resmî web sitesini ziyaret edin.