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.