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

How to use Flunt in C

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ı devralın.
4. Veri modeline doğrulama ekleyin.
5. Doğrulama kontrollerini yapın ve sonucu gösterin.

Understanding of Flunt C

Esnek ve hafif bir .NET framework olan Flunt, C# uygulamalarında akıcı doğrulama ve bildirim kalıplarının geliştirilmesini kolaylaştırmak için oluşturulmuştur. Geliştiriciler Flunt'u, doğrulama kuralları ve iş mantığını akıcı ve ifade edici bir şekilde inşa etmek için kullandıklarında kod daha okunabilir ve sürdürülebilir hale gelir. Flunt'un geniş çaplı entegre doğrulama teknikleri ve uzantıları ile geliştiriciler karmaşık veri yapıları, nesneler ve koleksiyonlar gibi yapıları kolayca doğrulayabilirler.

Ayrıca, Flunt mevcut kod tabanları ve çerçevelerle kolayca entegre olduğundan, .NET kütüphane uygulamalarının güvenilirliğini ve sağlamlığını artırmada yararlı bir araçtır. Genel olarak, Flunt bir deklaratif yaklaşımı teşvik ederek doğrulama ve hata yönetimini geliştiricilerin daha temiz, daha sağlam kod yazmalarını sağlar.

Getting Started with Flunt C

Flunt C# Örneği

Yüklendikten hemen sonra Flunt'u kullanarak aşağıdaki kodu kullanabilirsiniz. Bu, Flunt'u 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ı: Name ve Age özelliklerine sahip bir varlığı temsil eder.

PersonContract: Bu sınıf, Flunt'ın temel Contract<t> kavramından türetilmiştir. Requires yöntemi kullanılarak, yapılandırıcı bir Person nesnesi alır ve doğrulama kuralları sağlar. Requires çoklu doğrulamaları tanımlamak için zincirleme bir yöntem sunar. Doğrulamalar, IsNotNull, IsNotEmpty, IsGreaterThan gibi yöntemlerle gerçekleştirilir. Her doğrulama kuralı, özel bir hata mesajıyla ilişkilendirilmiştir.

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

Flunt İşlemleri

C# uygulamalarında doğrulama ve bildirim yönetimi için Flunt, aşağıdaki gibi birçok işlem sunar:

Doğrulama Kuralları Oluşturma: Zorunlu alanlar, veri türleri, değer aralıkları, maksimum uzunluk ve minimum uzunluk gibi öznitelikler 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 garantilemek 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 kayıt altına alın, kullanıcıları hata mesajları vererek ya da sorun giderme için hataları kaydederek kibarca yanıt verin.

Özel Doğrulama Mantığı: Karmaşık doğrulama durumlarına veya belirli alan gereksinimlerine yanıt olarak Flunt'u genişletmek için benzersiz doğrulama kuralları kullanın.

Çerçevelerle Entegrasyon: Mevcut uygulamalarda doğrulama yeteneklerini geliştirmek için Flunt, Entity Framework, ASP.NET Core ve daha fazlasını içeren birçok tanınmış .NET çerçevesi ve kütüphane ile sorunsuz bir şekilde entegre edilebilir.

Flunt'u IronPDF ile Entegre Etme

Geliştiriciler, Flunt'u IronPDF ile entegre ederek, iş mantığı doğrulaması ve belge oluşturma işlemlerini C# uygulamalarında hızlandırmak için her iki teknolojinin gücünü kullanabilir. Geliştiriciler, Flunt'la giriş verilerini doğruladıktan sonra IronPDF'i kullanarak PDF belgeleri oluşturarak uygulamaları daha güvenilir ve kullanıcı dostu hale getirebilirler.

IronPDF'i Kurun

• 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 İçin NuGet Paket Yöneticisini kullanabilirsiniz.
• Arama sonuçlarından IronPDF paketini arayıp seçtikten sonra "Yükle" butonuna tıklayın. Kurulum ve indirme Visual Studio tarafından yönetilecektir.

• NuGet, IronPDF paketinin ve proje için gerekli olan herhangi bir bağımlılığın yüklenmesini halledecektir.
• Kurulumdan sonra, IronPDF projenizde kullanılabilir olacaktır.

Lojiği Uygulamak

IronPDF'i PDF oluşturmak ve Flunt'u veri doğrulaması için kullanan basit bir C# uygulaması oluşturalım. Bu örnek, kullanıcı kaydı formu için Flunt'u kullanarak kullanıcı girişini doğrulayacak ve onaylanan kullanıcı verilerinin bir özetini PDF belge olarak oluşturacak.

1. Kişi Sınıfı: Ad ve yaş için özniteliklere sahip bir Kişi sınıfı tanımlanır. Constructor içinde Flunt'un akıcı arayüzünü kullanarak Kişi verilerini önceden tanımlanmış doğrulama kurallarına göre doğruluyoruz.
2. Pdf Üret: RenderHtmlAsPdf adlı bir yöntem tanımlanmıştı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 özeti HTML metnini bir PDF belgesine dönüştürür.
3. Ana Metot: Örnek Kişi verilerini kullanarak, Ana metot içinde Kullanıcı sınıfının bir örneğini inşa ediyoruz. Son olarak, Kişi verilerinin yasal olup olmadığını belirlemek için Flunt'ın IsValid özelliğini kullanıyoruz. Verileri doğruysa, IronPDF metodunu çağırarak PDF belgesini oluşturuyoruz. Değilse, doğrulama problemleri konsolda gösterilir.

IronPDF ile PDF oluşturmayı ve Flunt ile veri doğrulamayı 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ü garanti eder, profesyonel kalite belgeler üretir ve net, okunabilir ve sürdürülebilir kod yazmayı teşvik eder. IronPDF'in yetenekleri hakkında daha fazla bilgi edinmek için doküman sayfasına bakın. Aşağıda örnek kod parçası 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 koddan yürütme çıktısı aşağıdadır:

Sonuç

IronPDF ve Flunt, belge oluşturma ve veri doğrulama iş akışlarını basitleştirmek için iyi bir şekilde çalışan iki güçlü C# kütüphanesidir. IronPDF'in 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 kaliteli çözümler geliştirebilirler. Flunt ve IronPDF, geliştiricilere masaüstü uygulamaları, web uygulamaları veya bulut tabanlı çözümler geliştiriyor olsalar da, 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çları sağlar.

$999 Lite paketi, bir yıllık yazılım desteği, süresiz lisans ve kütüphane güncellemesini içerir. IronPDF, maliyet ve lisans gereksinimlerine yönelik daha fazla bilgi için IronPDF'in ücretsiz lisans detayları sağlar. Iron Software kütüphaneleri hakkında ek bilgi almak için Iron Software resmi web sitesini ziyaret edin.