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

ORM'nin Veritabanı Etkileşimlerini Basitleştirmedeki Rolü

NHibernate gibi ORM framework'leri, geliştiricilerin verilerle SQL ifadeleri yerine nesnelerin ve özelliklerinin terimleriyle çalışmasına olanak tanıyarak ilişkisel veritabanları ile etkileşimleri basitleştirir. Bu soyutlama, geliştiricilerin uygulamalarının iş mantığına daha fazla odaklanmasına ve altta yatan SQL komutları ve veritabanı şemasından daha az etkilenmesine yardımcı olur. Örneğin, NHibernate tüm SQL oluşturma ve yürütme işlemlerini yönetir ve nesne dönüştürme ve nesne manipülasyonu ile ekleme, silme ve güncellemeleri basit bir şekilde gerçekleştirilmesini sağlar.

Bir .NET Projesinde NHibernate Kurulumu

.NET projenizde NHibernate ile çalışmaya başlamak için ilk adım, NHibernate paketini kurmaktır. Bu, Visual Studio'nun NuGet Paket Yöneticisi üzerinden aşağıdaki komut kullanılarak kolayca yapılabilir:

Install-Package NHibernate

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2">
  <session-factory>
    <property name="connection.provider">
      NHibernate.Connection.DriverConnectionProvider
    </property>
    <property name="connection.driver_class">
      NHibernate.Driver.SqlClientDriver
    </property>
    <property name="connection.connection_string">
      Server=myServerAddress;Database=myDataBase;User Id=myUsername;Password=myPassword;
    </property>
    <property name="dialect">
      NHibernate.Dialect.MsSql2012Dialect
    </property>
    <property name="show_sql">true</property>
    <mapping resource="Employee.hbm.xml"/>
  </session-factory>
</hibernate-configuration>

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2">
  <session-factory>
    <property name="connection.provider">
      NHibernate.Connection.DriverConnectionProvider
    </property>
    <property name="connection.driver_class">
      NHibernate.Driver.SqlClientDriver
    </property>
    <property name="connection.connection_string">
      Server=myServerAddress;Database=myDataBase;User Id=myUsername;Password=myPassword;
    </property>
    <property name="dialect">
      NHibernate.Dialect.MsSql2012Dialect
    </property>
    <property name="show_sql">true</property>
    <mapping resource="Employee.hbm.xml"/>
  </session-factory>
</hibernate-configuration>

NHibernate'in Temel Bileşenlerini Anlamak

NHibernate'in temel bileşenlerinden biri, fabrika tasarım deseni kullanılarak tasarlanan Oturum Fabrikası'dır. Bu bileşen, veritabanına bağlantıyı yöneten ve işlemsel operasyonları tutan Oturum nesneleri oluşturur. Oturum Fabrikası oluşturulması maliyetli bir bileşendir, bu nedenle genellikle uygulamanın ömrü boyunca bir kez yapılır ve performans optimizasyonu için kritik bir elemandır.

NHibernate ile Varlıkları Veritabanı Tablolarına Eşleme

NHibernate'de varlık eşleştirme, genellikle XML'de yazılan eşleme dosyaları aracılığıyla gerçekleştirilir. Bu dosyalar, genellikle varlık sınıfının adını taşır (örneğin, Employee.hbm.xml), bir varlığın özelliklerinin bir veritabanı tablosunun sütunlarına nasıl eşleneceğini tanımlar. Tipik bir eşleme dosyası, sınıf adı, tablo adı ve her bir özelliğe dair birincil anahtar, sütun adı ve veri türü gibi ayrıntıları içerir.

NHibernate'te SQL Komutlarını ve İşlemleri Gerçekleştirme

NHibernate, alttaki SQL komutlarını soyutlayarak CRUD (Create, Read, Update, Delete) işlemlerini basitleştirir. Geliştiriciler bu işlemleri açıkça SQL kodu yazmadan, ISession arabirimi tarafından sağlanan yöntemleri kullanarak yapabilirler. Örneğin, veritabanına yeni bir varlık eklemek için, basitçe nesnenin yeni bir örneğini oluşturur, özelliklerini ayarlar ve ISession'in Save metodunu kullanırsınız.

Tam Kod Örneği

Bu örnek, NHibernate yapılandırmasının ve eşleme dosyalarının kurulumunu içerir ve NHibernate kullanarak Oluşturma, Okuma, Güncelleme ve Silme işlemlerinin nasıl gerçekleştirileceğini gösterir.

using NHibernate;
using NHibernate.Cfg;
using System;

// Define the Employee class with virtual properties
public class Employee
{
    public virtual int Id { get; set; }
    public virtual string FirstName { get; set; }
    public virtual string LastName { get; set; }
}

class Program
{
    private static ISessionFactory sessionFactory;

    static void Main()
    {
        // Initialize the SessionFactory using NHibernate configuration
        sessionFactory = new Configuration().Configure().BuildSessionFactory();

        // Perform database operations
        CreateEmployee();
        ReadEmployee(1);
        UpdateEmployee(1, "UpdatedName");
        DeleteEmployee(1);
    }

    static void CreateEmployee()
    {
        using (var session = sessionFactory.OpenSession())
        using (var transaction = session.BeginTransaction())
        {
            var newEmployee = new Employee
            {
                FirstName = "Iron",
                LastName = "Software"
            };
            session.Save(newEmployee); // Save the new Employee object to the database
            transaction.Commit(); // Commit the transaction to finalize the insertion
            Console.WriteLine("Employee created: " + newEmployee.Id);
        }
    }

    static void ReadEmployee(int id)
    {
        using (var session = sessionFactory.OpenSession())
        {
            // Retrieve the Employee object by its Id
            var employee = session.Get<Employee>(id);
            Console.WriteLine("Read Employee: " + employee.FirstName + " " + employee.LastName);
        }
    }

    static void UpdateEmployee(int id, string newFirstName)
    {
        using (var session = sessionFactory.OpenSession())
        using (var transaction = session.BeginTransaction())
        {
            // Get the Employee object by its Id
            var employee = session.Get<Employee>(id);
            employee.FirstName = newFirstName; // Update the employee's first name
            session.Update(employee); // Update the Employee object in the database
            transaction.Commit(); // Commit the transaction to save changes
            Console.WriteLine("Employee updated: " + employee.FirstName);
        }
    }

    static void DeleteEmployee(int id)
    {
        using (var session = sessionFactory.OpenSession())
        using (var transaction = session.BeginTransaction())
        {
            // Retrieve the Employee object to be deleted
            var employee = session.Get<Employee>(id);
            session.Delete(employee); // Delete the Employee from the database
            transaction.Commit(); // Commit the transaction to finalize the deletion
            Console.WriteLine("Employee deleted");
        }
    }
}

using NHibernate;
using NHibernate.Cfg;
using System;

// Define the Employee class with virtual properties
public class Employee
{
    public virtual int Id { get; set; }
    public virtual string FirstName { get; set; }
    public virtual string LastName { get; set; }
}

class Program
{
    private static ISessionFactory sessionFactory;

    static void Main()
    {
        // Initialize the SessionFactory using NHibernate configuration
        sessionFactory = new Configuration().Configure().BuildSessionFactory();

        // Perform database operations
        CreateEmployee();
        ReadEmployee(1);
        UpdateEmployee(1, "UpdatedName");
        DeleteEmployee(1);
    }

    static void CreateEmployee()
    {
        using (var session = sessionFactory.OpenSession())
        using (var transaction = session.BeginTransaction())
        {
            var newEmployee = new Employee
            {
                FirstName = "Iron",
                LastName = "Software"
            };
            session.Save(newEmployee); // Save the new Employee object to the database
            transaction.Commit(); // Commit the transaction to finalize the insertion
            Console.WriteLine("Employee created: " + newEmployee.Id);
        }
    }

    static void ReadEmployee(int id)
    {
        using (var session = sessionFactory.OpenSession())
        {
            // Retrieve the Employee object by its Id
            var employee = session.Get<Employee>(id);
            Console.WriteLine("Read Employee: " + employee.FirstName + " " + employee.LastName);
        }
    }

    static void UpdateEmployee(int id, string newFirstName)
    {
        using (var session = sessionFactory.OpenSession())
        using (var transaction = session.BeginTransaction())
        {
            // Get the Employee object by its Id
            var employee = session.Get<Employee>(id);
            employee.FirstName = newFirstName; // Update the employee's first name
            session.Update(employee); // Update the Employee object in the database
            transaction.Commit(); // Commit the transaction to save changes
            Console.WriteLine("Employee updated: " + employee.FirstName);
        }
    }

    static void DeleteEmployee(int id)
    {
        using (var session = sessionFactory.OpenSession())
        using (var transaction = session.BeginTransaction())
        {
            // Retrieve the Employee object to be deleted
            var employee = session.Get<Employee>(id);
            session.Delete(employee); // Delete the Employee from the database
            transaction.Commit(); // Commit the transaction to finalize the deletion
            Console.WriteLine("Employee deleted");
        }
    }
}

Imports NHibernate
Imports NHibernate.Cfg
Imports System

' Define the Employee class with virtual properties
Public Class Employee
	Public Overridable Property Id() As Integer
	Public Overridable Property FirstName() As String
	Public Overridable Property LastName() As String
End Class

Friend Class Program
	Private Shared sessionFactory As ISessionFactory

	Shared Sub Main()
		' Initialize the SessionFactory using NHibernate configuration
		sessionFactory = (New Configuration()).Configure().BuildSessionFactory()

		' Perform database operations
		CreateEmployee()
		ReadEmployee(1)
		UpdateEmployee(1, "UpdatedName")
		DeleteEmployee(1)
	End Sub

	Private Shared Sub CreateEmployee()
		Using session = sessionFactory.OpenSession()
		Using transaction = session.BeginTransaction()
			Dim newEmployee = New Employee With {
				.FirstName = "Iron",
				.LastName = "Software"
			}
			session.Save(newEmployee) ' Save the new Employee object to the database
			transaction.Commit() ' Commit the transaction to finalize the insertion
			Console.WriteLine("Employee created: " & newEmployee.Id)
		End Using
		End Using
	End Sub

	Private Shared Sub ReadEmployee(ByVal id As Integer)
		Using session = sessionFactory.OpenSession()
			' Retrieve the Employee object by its Id
			Dim employee = session.Get(Of Employee)(id)
			Console.WriteLine("Read Employee: " & employee.FirstName & " " & employee.LastName)
		End Using
	End Sub

	Private Shared Sub UpdateEmployee(ByVal id As Integer, ByVal newFirstName As String)
		Using session = sessionFactory.OpenSession()
		Using transaction = session.BeginTransaction()
			' Get the Employee object by its Id
			Dim employee = session.Get(Of Employee)(id)
			employee.FirstName = newFirstName ' Update the employee's first name
			session.Update(employee) ' Update the Employee object in the database
			transaction.Commit() ' Commit the transaction to save changes
			Console.WriteLine("Employee updated: " & employee.FirstName)
		End Using
		End Using
	End Sub

	Private Shared Sub DeleteEmployee(ByVal id As Integer)
		Using session = sessionFactory.OpenSession()
		Using transaction = session.BeginTransaction()
			' Retrieve the Employee object to be deleted
			Dim employee = session.Get(Of Employee)(id)
			session.Delete(employee) ' Delete the Employee from the database
			transaction.Commit() ' Commit the transaction to finalize the deletion
			Console.WriteLine("Employee deleted")
		End Using
		End Using
	End Sub
End Class

Veritabanı Taşınabilirliği ve Birlikte Çalışabilirlik Özellikleri

NHibernate veritabanı taşınabilirliği sağlanarak tasarlanmıştır. Lehçe yapılandırması sayesinde, NHibernate kod tabanında minimal değişikliklerle çoğu SQL veritabanına uyum sağlayabilir. Bu, veri erişim katmanınızı yeniden yazmak zorunda kalmadan bir SQL Sunucusu'ndan MySQL veya Oracle'a geçiş yapabileceğiniz anlamına gelir.

NHibernate'i IronPDF ile Kullanma

NHibernate'i IronPDF ile entegre etmek, .NET uygulamalarınızı güçlendirebilecek güçlü bir kombinasyon oluşturur. Veritabanı işlemlerini NHibernate ile yönetirken IronPDF'yi kullanarak verilerinizden PDF belgeleri üretmenize olanak tanır. Uygulamanızın, çalışana özel raporlar gibi kullanıcılara özel belgeler sağlaması gerektiği bir senaryoyu düşünün; bu belgeler PDF formatında üretilip indirilmelidir. NHibernate, veritabanınızdan veri alma süreçlerini verimli bir şekilde yönetebilirken, IronPDF bu verileri iyi biçimlendirilmiş PDF dosyalarına dönüştürebilir.

Install-Package IronPdf

using IronPdf;
using NHibernate;

static void CreateEmployeeReport(int employeeId)
{
    // Open a session to interact with the database
    using (var session = OpenSession())
    {
        // Retrieve the employee object based on the provided ID
        var employee = session.Get<Employee>(employeeId);

        // Create an instance of the ChromePdfRenderer class from IronPDF
        var renderer = new ChromePdfRenderer();

        // Create the HTML content for the PDF, embedding employee data into the HTML
        var htmlTemplate = $@"
            <html>
            <head>
                <title>Employee Report</title>
            </head>
            <body>
                <h1>Employee Details</h1>
                <p>Name: {employee.FirstName} {employee.LastName}</p>
                <p>ID: {employee.Id}</p>
            </body>
            </html>";

        // Render the HTML string as a PDF document
        var pdf = renderer.RenderHtmlAsPdf(htmlTemplate);

        // Save the generated PDF to a file
        pdf.SaveAs("EmployeeReport.pdf");
    }
}

using IronPdf;
using NHibernate;

static void CreateEmployeeReport(int employeeId)
{
    // Open a session to interact with the database
    using (var session = OpenSession())
    {
        // Retrieve the employee object based on the provided ID
        var employee = session.Get<Employee>(employeeId);

        // Create an instance of the ChromePdfRenderer class from IronPDF
        var renderer = new ChromePdfRenderer();

        // Create the HTML content for the PDF, embedding employee data into the HTML
        var htmlTemplate = $@"
            <html>
            <head>
                <title>Employee Report</title>
            </head>
            <body>
                <h1>Employee Details</h1>
                <p>Name: {employee.FirstName} {employee.LastName}</p>
                <p>ID: {employee.Id}</p>
            </body>
            </html>";

        // Render the HTML string as a PDF document
        var pdf = renderer.RenderHtmlAsPdf(htmlTemplate);

        // Save the generated PDF to a file
        pdf.SaveAs("EmployeeReport.pdf");
    }
}

Imports IronPdf
Imports NHibernate

Shared Sub CreateEmployeeReport(ByVal employeeId As Integer)
	' Open a session to interact with the database
	Using session = OpenSession()
		' Retrieve the employee object based on the provided ID
		Dim employee = session.Get(Of Employee)(employeeId)

		' Create an instance of the ChromePdfRenderer class from IronPDF
		Dim renderer = New ChromePdfRenderer()

		' Create the HTML content for the PDF, embedding employee data into the HTML
		Dim htmlTemplate = $"
            <html>
            <head>
                <title>Employee Report</title>
            </head>
            <body>
                <h1>Employee Details</h1>
                <p>Name: {employee.FirstName} {employee.LastName}</p>
                <p>ID: {employee.Id}</p>
            </body>
            </html>"

		' Render the HTML string as a PDF document
		Dim pdf = renderer.RenderHtmlAsPdf(htmlTemplate)

		' Save the generated PDF to a file
		pdf.SaveAs("EmployeeReport.pdf")
	End Using
End Sub

Sonuç

Bu öğreticide, NHibernate'in .NET uygulamalarında veritabanı işlemlerini nasıl basitleştirdiğini ve IronPDF ile entegrasyonunun dinamik PDF belgeleri üretimini sağlayarak nasıl işlevselliği artırdığını inceledik. NHibernate, sağlam veri yönetim araçları sunarken, IronPDF tek başına veriyle doldurulmuş HTML şablonlarından profesyonel kalite PDF'ler oluşturmak için kolay bir yol sunar.

IronPDF, uygulamalarınıza güçlü PDF oluşturma işlemlerini entegre etmek için maliyet etkin bir çözüm olarak başlayan bir ücretsiz deneme ve lisanslar sunuyor. Bu araçlar birlikte, veri yönetimi ve belge üretimi için kapsamlı bir çözüm sunarak hem kurumsal düzeyde hem de daha küçük ölçekli projeler için idealdir.