CSLA .NET (Comment ça fonctionne pour les développeurs)

Qu'est-ce que CSLA .NET ?

Rocky Lhotka a créé le cadre open-source CSLA .NET (Architecture logique évolutive basée sur des composants) pour aider les programmeurs à créer des applications commerciales fiables, extensibles et gérables pour la plateforme .NET. Il favorise une division claire des responsabilités en mettant l'accent sur l'utilisation d'objets métier qui contiennent toutes les logiques métier, critères de validation et vérifications d'autorisation. La maintenabilité et l'évolutivité sont améliorées par la capacité de CSLA à prendre en charge la conception en n-tier et à abstraire la logique d'accès aux données, ce qui permet de déployer la logique métier sur plusieurs couches.

En plus de prendre en charge les objets mobiles, il peut également être utilisé avec diverses technologies d'interface utilisateur, notamment Windows Forms, WPF, ASP.NET MVC et Blazor, pour permettre un traitement client riche et serveur efficace des formulaires web. Le développement d'applications de niveau entreprise réactives, efficaces et cohérentes est facilité par cette flexibilité, qui garantit que la logique métier peut être réutilisée de manière fiable à travers plusieurs couches de présentation.

Install-Package CSLA
Install-Package CSLA-Server

Install-Package CSLA
Install-Package CSLA-Server

using System;
using Csla.Configuration;
namespace CslaDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Initialize CSLA .NET
            var applicationContext = new ApplicationContext();
            // Use dependency injection if needed (for ASP.NET Core or other frameworks)
            var services = new ServiceCollection();
            services.AddCsla();
            var provider = services.BuildServiceProvider();
            applicationContext = provider.GetService<ApplicationContext>();
            Console.WriteLine("CSLA .NET is configured and ready to use!");
        }
    }
}

using System;
using Csla.Configuration;
namespace CslaDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Initialize CSLA .NET
            var applicationContext = new ApplicationContext();
            // Use dependency injection if needed (for ASP.NET Core or other frameworks)
            var services = new ServiceCollection();
            services.AddCsla();
            var provider = services.BuildServiceProvider();
            applicationContext = provider.GetService<ApplicationContext>();
            Console.WriteLine("CSLA .NET is configured and ready to use!");
        }
    }
}

Imports System
Imports Csla.Configuration
Imports Microsoft.Extensions.DependencyInjection

Namespace CslaDemo
    Class Program
        Shared Sub Main(ByVal args As String())
            ' Initialize CSLA .NET
            Dim applicationContext As ApplicationContext = New ApplicationContext()
            ' Use dependency injection if needed (for ASP.NET Core or other frameworks)
            Dim services As New ServiceCollection()
            services.AddCsla()
            Dim provider = services.BuildServiceProvider()
            applicationContext = provider.GetService(Of ApplicationContext)()
            Console.WriteLine("CSLA .NET is configured and ready to use!")
        End Sub
    End Class
End Namespace

using Csla;
namespace CslaDemo
{
    [Serializable]
    public class Person : BusinessBase<Person>
    {
        public static readonly PropertyInfo<int> IdProperty = RegisterProperty<int>(c => c.Id);
        public int Id
        {
            get => GetProperty(IdProperty);
            set => SetProperty(IdProperty, value);
        }
        public static readonly PropertyInfo<string> NameProperty = RegisterProperty<string>(c => c.Name);
        public string Name
        {
            get => GetProperty(NameProperty);
            set => SetProperty(NameProperty, value);
        }
        protected override void AddBusinessRules()
        {
            // Add validation rules
            BusinessRules.AddRule(new Csla.Rules.CommonRules.Required(NameProperty));
        }
        // Data access methods
        [Fetch]
        private void DataPortal_Fetch(int id)
        {
            // Simulate data fetch
            Id = id;
            Name = "John Doe";
        }
        [Create]
        private void DataPortal_Create()
        {
            // Initialize default values
            Id = -1;
            Name = "New Person";
        }
    }
}

using Csla;
namespace CslaDemo
{
    [Serializable]
    public class Person : BusinessBase<Person>
    {
        public static readonly PropertyInfo<int> IdProperty = RegisterProperty<int>(c => c.Id);
        public int Id
        {
            get => GetProperty(IdProperty);
            set => SetProperty(IdProperty, value);
        }
        public static readonly PropertyInfo<string> NameProperty = RegisterProperty<string>(c => c.Name);
        public string Name
        {
            get => GetProperty(NameProperty);
            set => SetProperty(NameProperty, value);
        }
        protected override void AddBusinessRules()
        {
            // Add validation rules
            BusinessRules.AddRule(new Csla.Rules.CommonRules.Required(NameProperty));
        }
        // Data access methods
        [Fetch]
        private void DataPortal_Fetch(int id)
        {
            // Simulate data fetch
            Id = id;
            Name = "John Doe";
        }
        [Create]
        private void DataPortal_Create()
        {
            // Initialize default values
            Id = -1;
            Name = "New Person";
        }
    }
}

Imports Csla
Namespace CslaDemo
	<Serializable>
	Public Class Person
		Inherits BusinessBase(Of Person)

		Public Shared ReadOnly IdProperty As PropertyInfo(Of Integer) = RegisterProperty(Of Integer)(Function(c) c.Id)
		Public Property Id() As Integer
			Get
				Return GetProperty(IdProperty)
			End Get
			Set(ByVal value As Integer)
				SetProperty(IdProperty, value)
			End Set
		End Property
		Public Shared ReadOnly NameProperty As PropertyInfo(Of String) = RegisterProperty(Of String)(Function(c) c.Name)
		Public Property Name() As String
			Get
				Return GetProperty(NameProperty)
			End Get
			Set(ByVal value As String)
				SetProperty(NameProperty, value)
			End Set
		End Property
		Protected Overrides Sub AddBusinessRules()
			' Add validation rules
			BusinessRules.AddRule(New Csla.Rules.CommonRules.Required(NameProperty))
		End Sub
		' Data access methods
		<Fetch>
		Private Sub DataPortal_Fetch(ByVal id As Integer)
			' Simulate data fetch
			Me.Id = id
			Name = "John Doe"
		End Sub
		<Create>
		Private Sub DataPortal_Create()
			' Initialize default values
			Id = -1
			Name = "New Person"
		End Sub
	End Class
End Namespace

using System;
using Csla;
using Microsoft.Extensions.DependencyInjection;
namespace CslaDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Initialize CSLA .NET
            var services = new ServiceCollection();
            services.AddCsla();
            var provider = services.BuildServiceProvider();
            var applicationContext = provider.GetService<ApplicationContext>();
            var db = provider.GetRequiredService<IDataPortal<Person>>();
            // Create a new person
            var newPerson = db.Create();
            Console.WriteLine($"New Person: {newPerson.Name}");
            // Fetch an existing person
            var existingPerson = db.Fetch(1);
            Console.WriteLine($"Fetched Person: {existingPerson.Name}");
        }
    }
}

using System;
using Csla;
using Microsoft.Extensions.DependencyInjection;
namespace CslaDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Initialize CSLA .NET
            var services = new ServiceCollection();
            services.AddCsla();
            var provider = services.BuildServiceProvider();
            var applicationContext = provider.GetService<ApplicationContext>();
            var db = provider.GetRequiredService<IDataPortal<Person>>();
            // Create a new person
            var newPerson = db.Create();
            Console.WriteLine($"New Person: {newPerson.Name}");
            // Fetch an existing person
            var existingPerson = db.Fetch(1);
            Console.WriteLine($"Fetched Person: {existingPerson.Name}");
        }
    }
}

Imports System
Imports Csla
Imports Microsoft.Extensions.DependencyInjection
Namespace CslaDemo
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Initialize CSLA .NET
			Dim services = New ServiceCollection()
			services.AddCsla()
			Dim provider = services.BuildServiceProvider()
			Dim applicationContext = provider.GetService(Of ApplicationContext)()
			Dim db = provider.GetRequiredService(Of IDataPortal(Of Person))()
			' Create a new person
			Dim newPerson = db.Create()
			Console.WriteLine($"New Person: {newPerson.Name}")
			' Fetch an existing person
			Dim existingPerson = db.Fetch(1)
			Console.WriteLine($"Fetched Person: {existingPerson.Name}")
		End Sub
	End Class
End Namespace

Commencer

Vous devez d'abord configurer votre projet, utiliser CSLA pour construire des objets métier, et IronPDF pour créer des PDF afin de commencer à utiliser CSLA et IronPDF dans un projet C#. Voici un mode d'emploi détaillé pour accomplir cela.

Install-Package IronPdf

Initialiser CSLA .NET et Générer un PDF avec IronPDF

Utilisez l'objet métier Person créé précédemment et initialisez le .NET Framework CSLA dans votre fichier Program.cs. Ensuite, utilisez IronPDF pour créer un PDF.

using Csla;
using IronPdf;
using Microsoft.Extensions.DependencyInjection;
using System;
using System.Text;
namespace CslaIronPdfDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Setup dependency injection
            var services = new ServiceCollection();
            services.AddCsla();
            var provider = services.BuildServiceProvider();
            var applicationContext = provider.GetRequiredService<ApplicationContext>();
            var db = provider.GetRequiredService<IDataPortal<Person>>();
            // Create a new person
            var newPerson = db.Create();
            // Display the new person
            Console.WriteLine($"New Person: {newPerson.Name}");
            // Fetch an existing person
            var existingPerson = db.Fetch(1);
            // Display the fetched person
            Console.WriteLine($"Fetched Person: {existingPerson.Name}");
            // Generate PDF
            var htmlContent = new StringBuilder();
            htmlContent.Append("<h1>Person Details</h1>");
            htmlContent.Append($"<p><strong>New Person:</strong> {newPerson.Name}</p>");
            htmlContent.Append($"<p><strong>Fetched Person:</strong> {existingPerson.Name}</p>");
            // Create PDF
            var Renderer = new HtmlToPdf();
            var pdfDocument = Renderer.RenderHtmlAsPdf(htmlContent.ToString());
            // Save PDF
            var outputPath = "PersonDetails.pdf";
            pdfDocument.SaveAs(outputPath);
            Console.WriteLine($"PDF generated and saved to {outputPath}");
        }
    }
}

using Csla;
using IronPdf;
using Microsoft.Extensions.DependencyInjection;
using System;
using System.Text;
namespace CslaIronPdfDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Setup dependency injection
            var services = new ServiceCollection();
            services.AddCsla();
            var provider = services.BuildServiceProvider();
            var applicationContext = provider.GetRequiredService<ApplicationContext>();
            var db = provider.GetRequiredService<IDataPortal<Person>>();
            // Create a new person
            var newPerson = db.Create();
            // Display the new person
            Console.WriteLine($"New Person: {newPerson.Name}");
            // Fetch an existing person
            var existingPerson = db.Fetch(1);
            // Display the fetched person
            Console.WriteLine($"Fetched Person: {existingPerson.Name}");
            // Generate PDF
            var htmlContent = new StringBuilder();
            htmlContent.Append("<h1>Person Details</h1>");
            htmlContent.Append($"<p><strong>New Person:</strong> {newPerson.Name}</p>");
            htmlContent.Append($"<p><strong>Fetched Person:</strong> {existingPerson.Name}</p>");
            // Create PDF
            var Renderer = new HtmlToPdf();
            var pdfDocument = Renderer.RenderHtmlAsPdf(htmlContent.ToString());
            // Save PDF
            var outputPath = "PersonDetails.pdf";
            pdfDocument.SaveAs(outputPath);
            Console.WriteLine($"PDF generated and saved to {outputPath}");
        }
    }
}

Imports Csla
Imports IronPdf
Imports Microsoft.Extensions.DependencyInjection
Imports System
Imports System.Text
Namespace CslaIronPdfDemo
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Setup dependency injection
			Dim services = New ServiceCollection()
			services.AddCsla()
			Dim provider = services.BuildServiceProvider()
			Dim applicationContext = provider.GetRequiredService(Of ApplicationContext)()
			Dim db = provider.GetRequiredService(Of IDataPortal(Of Person))()
			' Create a new person
			Dim newPerson = db.Create()
			' Display the new person
			Console.WriteLine($"New Person: {newPerson.Name}")
			' Fetch an existing person
			Dim existingPerson = db.Fetch(1)
			' Display the fetched person
			Console.WriteLine($"Fetched Person: {existingPerson.Name}")
			' Generate PDF
			Dim htmlContent = New StringBuilder()
			htmlContent.Append("<h1>Person Details</h1>")
			htmlContent.Append($"<p><strong>New Person:</strong> {newPerson.Name}</p>")
			htmlContent.Append($"<p><strong>Fetched Person:</strong> {existingPerson.Name}</p>")
			' Create PDF
			Dim Renderer = New HtmlToPdf()
			Dim pdfDocument = Renderer.RenderHtmlAsPdf(htmlContent.ToString())
			' Save PDF
			Dim outputPath = "PersonDetails.pdf"
			pdfDocument.SaveAs(outputPath)
			Console.WriteLine($"PDF generated and saved to {outputPath}")
		End Sub
	End Class
End Namespace

L'exemple offert montre comment créer, valider, et générer des PDFs à partir d'objets métier en utilisant une application console .NET 6 qui combine CSLA.NET avec IronPDF. L'installation des packages IronPDF et CSLA.NET nécessaires à l'aide de NuGet est la première étape pour configurer le projet. La BusinessBase de CSLA est utilisée pour décrire le foyer principal de votre objet métier, Person.

Il encapsule des caractéristiques comme le nom et l'identifiant et inclut des règles métier pour valider ces propriétés. La mise en œuvre de méthodes de fabrication et d'accès aux données prend en charge la génération d'objets et la récupération de données. L'injection de dépendances est utilisée pour initialiser le contexte de l'application CSLA dans le fichier Program.cs. Le code montre ensuite comment utiliser les fonctions DataPortal de CSLA pour créer un nouvel objet Person et en récupérer un existant.

Enfin, en utilisant la fonction HtmlToPdf d'IronPDF, les informations HTML incluant les détails de la personne sont créées et transformées en un PDF pour la conversion HTML en PDF, démontrant une méthode utile de création de rapports d'entreprise au format PDF. Cet exemple démontre comment la génération de documents dans une application .NET peut être intégrée de manière transparente avec la gestion des données et la logique métier.

Conclusion

En résumé, l'intégration d'IronPDF et de CSLA .NET dans une application C# montre comment ils fonctionnent bien ensemble pour gérer la logique métier et produire des documents soignés. Un cadre puissant pour gérer l'accès aux données, établir et appliquer des règles métier, et garantir la cohérence des objets métier est offert par CSLA .NET. Ce cadre améliore la maintenabilité du code et rationalise la logique métier complexe.

En outre, IronPDF offre une interface facile à utiliser pour créer et modifier des documents PDF, rendant possible la création de rapports complets avec formatage directement à partir des données de l'application. En combinant ces technologies, les développeurs peuvent créer des applications d'entreprise complexes qui produisent des documents de haute qualité tout en respectant les exigences commerciales, optimisant les flux de travail, et augmentant les niveaux de productivité.

Votre ensemble d'outils pour le développement .NET est complété par IronPDF et les options de licence d'Iron Software qui combinent les systèmes et la Suite extrêmement polyvalents d'Iron Software avec son support de base pour fournir plus d'applications et de fonctionnalités en ligne, ainsi qu'un développement plus efficace, pour un prix de départ de $999.

Les développeurs peuvent plus facilement décider quel modèle est la meilleure pratique si les choix de licences sont spécifiques au projet et faciles à comprendre. Les développeurs peuvent désormais traiter une variété de problèmes de manière simple, efficace, et parfaitement connectée grâce à ces avantages.