NHibernate - Componente di mappatura
In questo capitolo parleremo dei componenti di mappatura. In NHibernate,component is a value object. Non ha un'identità propria.
Un esempio di questo potrebbe essere un oggetto denaro, una borsa o un portafoglio potrebbe contenere denaro, ma l'identità esatta di quel denaro è irrilevante.
Non dispone di una propria chiave primaria, ma i componenti stessi sono persistenti nella stessa tabella dell'oggetto proprietario.
Diamo un'occhiata a un semplice esempio in cui uno studente ha un indirizzo, che è un oggetto di Location class associati ad esso.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
namespace NHibernateDemoApp {
class Student {
public virtual int ID { get; set; }
public virtual string LastName { get; set; }
public virtual string FirstName { get; set; }
public virtual StudentAcademicStanding AcademicStanding { get; set; }
public virtual Location Address { get; set; }
}
public class Location {
public virtual string Street { get; set; }
public virtual string City { get; set; }
public virtual string Province { get; set; }
public virtual string Country { get; set; }
}
public enum StudentAcademicStanding {
Excellent,
Good,
Fair,
Poor,
Terrible
}
}Ora, dobbiamo anche aggiornare il database eseguendo la seguente query, che prima eliminerà la tabella Student e quindi creerà una nuova tabella che conterrà anche una colonna per la classe Location.
DROP TABLE [dbo].[Student]
CREATE TABLE [dbo].[Student] (
[ID] INT IDENTITY (1, 1) NOT NULL,
[LastName] NVARCHAR (MAX) NULL,
[FirstMidName] NVARCHAR (MAX) NULL,
[AcademicStanding] NCHAR(10) NULL,
[Street] NVARCHAR (100) NULL,
[City] NVARCHAR (100) NULL,
[Province] NVARCHAR (100) NULL,
[Country] NVARCHAR (100) NULL,
CONSTRAINT [PK_dbo.Student] PRIMARY KEY CLUSTERED ([ID] ASC)
);Ora per mappare quelle colonne che non fanno parte direttamente della classe Student, ma sono proprietà della classe Location e l'oggetto della classe Location è definito nella classe student. Abbiamo bisogno di un componente per mapparlo correttamente. Creiamo un componente instudent.hbm.xml file come mostrato nel codice seguente.
<?xml version = "1.0" encoding = "utf-8" ?>
<hibernate-mapping xmlns = "urn:nhibernate-mapping-2.2"
assembly = "NHibernateDemoApp" namespace = "NHibernateDemoApp">
<class name = "Student">
<id name = "ID">
<generator class = "native"/>
</id>
<property name = "LastName"/>
<property name = "FirstName" column = "FirstMidName" type = "String"/>
<property name = "AcademicStanding"/>
<component name = "Address">
<property name = "Street"/>
<property name = "City"/>
<property name = "Province"/>
<property name = "Country"/>
</component>
</class>
</hibernate-mapping>Questo componente è l'indirizzo e ha queste diverse proprietà su di esso. Con queste informazioni, NHibernate ora ha abbastanza per poterlo mappare effettivamente.
Ora ecco il file Program.cs in cui viene creato e inizializzato un nuovo oggetto studente e quindi salvato nel database. Quindi recupererà l'elenco dal database.
using HibernatingRhinos.Profiler.Appender.NHibernate;
using NHibernate.Cache;
using NHibernate.Caches.SysCache;
using NHibernate.Cfg;
using NHibernate.Dialect;
using NHibernate.Driver;
using NHibernate.Linq;
using System;
using System.Linq;
using System.Reflection;
namespace NHibernateDemoApp {
class Program {
static void Main(string[] args) {
NHibernateProfiler.Initialize();
var cfg = new Configuration();
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;
cfg.DataBaseIntegration(x = > { x.ConnectionString = "Data Source +
Initial Catalog + Integrated Security + Connect Timeout + Encrypt +
TrustServerCertificate + ApplicationIntent + MultiSubnetFailover";
x.Driver<SqlClientDriver>();
x.Dialect<MsSql2008Dialect>();
});
cfg.AddAssembly(Assembly.GetExecutingAssembly());
var sefact = cfg.BuildSessionFactory();
using (var session = sefact.OpenSession()) {
using (var tx = session.BeginTransaction()) {
var student1 = new Student {
ID = 1,
FirstName = "Allan",
LastName = "Bommer",
AcademicStanding = StudentAcademicStanding.Poor,
Address = new Location {
Street = "123 Street",
City = "Lahore",
Province = "Punjab",
Country = "Pakistan"
}
};
session.Save(student1);
tx.Commit();
var students = session.Query<Student>().ToList<Student>();
Console.WriteLine("\nFetch the complete list again\n");
foreach (var student in students) {
Console.WriteLine("{0} \t{1} \t{2} \t{3} \t{4} \t{5} \t{6} \t{7}",
student.ID,
student.FirstName,
student.LastName,
student.AcademicStanding,
student.Address.Street,
student.Address.City,
student.Address.Province,
student.Address.Country
);
}
}
Console.ReadLine();
}
}
}
}Ora possiamo eseguire questa applicazione e NHibernate può salvare quei valori nel database. Quando esegui l'applicazione, vedrai il seguente output.
Fetch the complete list again
2 Allan Bommer Poor 123 Street Lahore Punjab PakistanEcco i valori nel database.
I componenti ci consentono di separare le colonne che si trovano in una tabella di database nella loro classe separata.
L'altra cosa da notare qui è perché Location è una classe, non è un'entità.
È un oggetto di tipo valore e non ha una propria chiave primaria.
Viene salvato nella stessa tabella dello Studente che lo contiene.
Ecco perché stiamo usando il componente qui.
Ciò consente molta flessibilità per cambiare il nostro livello di classe, come sono definite le nostre classi rispetto a come è strutturato il nostro database.