NHibernate - płynna hibernacja

W tym rozdziale zajmiemy się płynnym NHibernate. Fluent NHibernate to inny sposób mapowania lub można powiedzieć, że jest alternatywą dla standardowych plików mapowania XML NHibernate. Zamiast pisać XML(.hbm.xml files)dokumenty. Z pomocą Fluent NHibernate możesz pisać mapowania w silnie wpisanym kodzie C #.

  • W Fluent NHibernate mapowania są kompilowane wraz z resztą aplikacji.

  • Możesz łatwo zmienić swoje mapowania, tak jak kod aplikacji, a kompilator nie powiedzie się w przypadku jakichkolwiek literówek.

  • Ma konwencjonalny system konfiguracji, w którym można określić wzorce zastępowania konwencji nazewnictwa i wiele innych rzeczy.

  • Możesz także ustawić jednorazowe nazewnictwo, a Fluent NHibernate zrobi resztę.

Rzućmy okiem na prosty przykład, tworząc nowy projekt konsoli. W tym rozdziale użyjemy prostej bazy danych, w której mamy prostą tabelę klientów, jak pokazano na poniższym obrazku.

Zainstaluj Fluent NHibernate

Pierwszym krokiem do uruchomienia Fluent NHibernate jest instalacja pakietu Fluent NHibernate. Więc otwórzNuGet Package Manager Console i wprowadź następujące polecenie.

PM> install-package FluentNHibernate

Po pomyślnym zainstalowaniu zostanie wyświetlony następujący komunikat.

Dodajmy prostą klasę modelu Customer, a poniższy program przedstawia implementację klasy Customer.

using System; 
using System.Collections.Generic; 
using System.Linq;
using System.Text; 
using System.Threading.Tasks;

namespace FluentNHibernateDemo { 
   class Customer { 
      public virtual int Id { get; set; } 
      public virtual string FirstName { get; set; } 
      public virtual string LastName { get; set; } 
   } 
}

Teraz musimy stworzyć mapowania używając płynnego NHibernate, więc dodaj jeszcze jedną klasę CustomerMapw swoim projekcie. Oto implementacja klasy CustomerMap.

using FluentNHibernate.Mapping; 
using System; 
using System.Collections.Generic; 
using System.Linq; using System.Text; 
using System.Threading.Tasks;

namespace FluentNHibernateDemo { 
   class CustomerMap : ClassMap<Customer> { 
      public CustomerMap() { 
         Id(x => x.Id); 
         Map(x => x.FirstName); 
         Map(x => x.LastName); 
         Table("Customer"); 
      } 
   }
}

Dodajmy kolejną klasę NHibernateHelper w którym ustawimy różne ustawienia konfiguracyjne.

using FluentNHibernate.Cfg; 
using FluentNHibernate.Cfg.Db; 
using NHibernate; 
using NHibernate.Tool.hbm2ddl;

namespace FluentNHibernateDemo { 

   public class NHibernateHelper { 
	
      private static ISessionFactory _sessionFactory;
		
      private static ISessionFactory SessionFactory { 
         get { 
            if (_sessionFactory == null)
            InitializeSessionFactory(); return _sessionFactory; 
         } 
      }
   
      private static void InitializeSessionFactory() { 
         _sessionFactory = Fluently.Configure() 
			
         String Data Source = asia13797\\sqlexpress;
         String Initial Catalog = NHibernateDemoDB;
         String Integrated Security = True;
         String Connect Timeout = 15;
         String Encrypt = False;
         String TrustServerCertificate = False;
         String ApplicationIntent = ReadWrite;
         String MultiSubnetFailover = False;
			
         .Database(MsSqlConfiguration.MsSql2008 .ConnectionString( 
            @"Data Source + Initial Catalog + Integrated Security + Connect Timeout
            + Encrypt + TrustServerCertificate + ApplicationIntent + 
            MultiSubnetFailover") .ShowSql() ) 
				
         .Mappings(m => m.FluentMappings
         .AddFromAssemblyOf<Program>()) 
         .ExposeConfiguration(cfg => new SchemaExport(cfg) 
         .Create(true, true)) 
         .BuildSessionFactory(); 
      }
		
      public static ISession OpenSession() { 
         return SessionFactory.OpenSession(); 
      } 
   }
}

Teraz przejdźmy do Program.cs plik, w którym rozpoczniemy sesję, a następnie utworzymy nowego klienta i zapiszemy go w bazie danych, jak pokazano poniżej.

using System; 
using System.Collections.Generic; 
using System.Linq; 
using System.Text; 
using System.Threading.Tasks;

namespace FluentNHibernateDemo { 
   class Program { 
	
      static void Main(string[] args) { 
		
         using (var session = NHibernateHelper.OpenSession()) { 
			
            using (var transaction = session.BeginTransaction()) { 
               var customer = new Customer { 
                  FirstName = "Allan", 
                  LastName = "Bomer" 
               }; 
					
               session.Save(customer); 
               transaction.Commit();
               Console.WriteLine("Customer Created: " + customer.FirstName + "\t" +
                  customer.LastName); 
            } 
				
            Console.ReadKey(); 
         } 
      } 
   } 
}

Uruchommy Twoją aplikację, a zobaczysz następujące dane wyjściowe.

if exists (select * from dbo.sysobjects where id = object_id(N'Customer') and
   OBJECTPROPERTY(id, N'IsUserTable') = 1) drop table Customer

create table Customer (
   Id INT IDENTITY NOT NULL,
   FirstName NVARCHAR(255) null,
   LastName NVARCHAR(255) null,
   primary key (Id)
)

NHibernate: INSERT INTO Customer (FirstName, LastName) VALUES (@p0, @p1); 
   select SCOPE_IDENTITY();@p0 = 'Allan' [Type: String (4000)], 
   @p1 = 'Bomer' [Type: String (4000)]
   Customer Created: Allan Bomer

Jak widać, tworzony jest nowy klient. Aby zobaczyć rekord klienta, przejdźmy do bazy danych i przejrzyj dane, a zobaczysz, że dodano 1 klienta.