در این مثال ما یک domain ساده را برای یک کمپانی خرده‌فروشی در نظرگرفته‌ایم. فروشگاه کارمند و کالا دارد که هر کدام با یکدیگر ارتباط دارند. برای روشن شدن مسئله شکل زیر را ملاحظه کنید.

ابتدا یک console Application ایجاد کنید و fluent NHibernate.dll را به آن ارجاع دهید. و هر کدام از نسخه‌های NHibernate را که تمایل داشتید در آن قرار دهید. برای این مثال ما از دیتابیس SQLite استفاده می‌کنیم. همچنین شما به کتابخانهٔ  System.Data.SQLite که با fluent NHibernate ساخته شده است نیز نیاز دارید.

شما می‌توانید ساختار پروژه را در شکل روبرو ببینید. پوشهٔ Entities بخش واقعی آبجکت‌هاست و پوشهٔ mappings محل قرارگیری کلاس‌های mapping شما است.

پوشه Enteties :

اجازه دهید با ساخت entity ها شروع کنیم. ما سه جدول داریم که با هم ارتباط دارند و باید مپ شوند. برای هر کدام، کلاسی جداگانه و مخصوص به خود را در پوشهٔ Enteties می‌سازیم.

ابتدا با کلاس employee کارمان را آغاز می‌کنیم.

public class Employee
{
public virtual int Id { get; private set; }
public virtual string FirstName { get; set;}
public virtual string LastName { get; set; }
public virtual Store Store { get; set; }
}

همانطور که ملاحظه می‌کنید به ازای تمام فیلدهای جدول موجود در پایگاه داده، در این فایل یک صفت (property) داریم.

اگر شما با NHibernate ناآشنا هستید باید بدانید که دو چیز مهم و برجسته در اینجا وجود دارد. اول اینکه مشخصهٔ id به صورت private ، set شده است و این به این خاطر است که فقط NHibernate است که می‌تواند این مقدار را set کند. دوم اینکه همهٔ property ها virtual هستند، بخاطر اینکه NHibernate در حین اجرا از موجودیت‌ها proxy هایی می‌سازد که اجازه می‌دهد Lazy load باشد، یعنی اینکه قابلیت override را برای property ها داشته باشد.

دو کلاس دیگر را هم به صورت زیر می‌سازیم. (توجه کنید که به ازای فیلدهای جدول خودشان و با Type های صحیح اقدام به ایجاد صفت کنید، درغیر این صورت شما با مشکل روبرو خواهید شد. )

پیاده سازی کلاس محصول

public class Product
{
 public virtual int Id { get; private set; }
 public virtual string Name { get; set; }
 public virtual double Price { get; set; }
 public virtual IList<Store> StoresStockedIn { get; private set;{
 public Product()   //constructor
 {
 StoresStockedIn = new List<Store>();
 }
}
public class Store
{
 public virtual int Id { get; private set; }
 public virtual string Name { get; set; }
 public virtual IList<Product> Products { get; set; }
 public virtual IList<Employee> Staff { get; set; }
<pre>

پیاده سازی کلاس خرده‌فروشی (مغازه)

</pre>
public Store()
 {
 Products = new List<Product>();
 Staff = new List<Employee>();
 }
public virtual void AddProduct(Product product)
 {
 product.StoresStockedIn.Add(this);
 Products.Add(product);
 }

 public virtual void AddEmployee(Employee employee)
 {
 employee.Store = this;
 Staff.Add(employee);
 }
}

متدهای add employee و add product کمی به ساده‌تر شددن کد ما کمک می‌کنند. این متدها برای اضافه کردن یک item به collection و تنظیم کردن سمت دیگر رابطه استفاده می‌شوند. (برای اضافه کردن کالا و کارمند به فروشگاه)
پوشه Mappings :
حالا که entity ها را ساختیم وقت آن رسیده که آنها را با استفاده از fluent NHibernate مپ کنیم. با یک کلاس ساده مثل employee شروع می‌کنیم. Mapper های زیر باید در پوشهٔ mappings ساخته شوند.
برای مپ کردن هر entity شما باید یک کلاس مپ اختصاصی برایش ایجاد کنید. این کلاس مپینگ‌ها از ClassMapp<T> به ارث می‌روند و T ، درواقع نام entity ی ورودی شما است.

public class EmployeeMap : ClassMap<Employee>
{
 public EmployeeMap()
 {
 Id(x => x.Id);
 Map(x => x.FirstName);
 Map(x => x.LastName);
 References(x => x.Store);
 }
}

ستون id یک شناسه برای fluent NHibernate است و x مثالی از یک نمونه از employee است که fluent NHibernate از آن برای بدست آوردن جزئیات property ها استفاده می‌کند.

public class StoreMap : ClassMap<Store>
{
 public StoreMap()
 {
 Id(x => x.Id);
 Map(x => x.Name);
 HasMany(x => x.Staff).Inverse().Cascade.All();
 HasManyToMany(x => x.Products).Cascade.All().WithTableName("StoreProduct");
 }
}

همان طور که ملاحضه می‌کنید در اینجا فراخوان‌های دیگری نیز به چشم می‌خورد. اگر employee را بخاطر بیاورید در آنجا یک ارتباط یک به چند با store داشتیم. حالا هم در مپ کردن store باید این ارتباط را نیز در نظر بگیریم. HasMany یک ارتباط یک به چند را با employee برقرار می‌کند. در اینجا یک متد جدید HasManyToMany وجود دارد که ارتباط چند به چند با product را ایجاد می‌نماید.
Inverse در HasMany یک عبارت (کلمه کلیدی) در NHibernate است و در پایان ارتباط مسئولیت save را به عهده دارد.
CascadeAll در HasManyToMany به NHibernate می‌گوید که در سلسلهٔ آبشاری عمل save را انجام دهد.
WithTableName نام طرف دیگر ارتباط را در چند به چند مشخص می‌کند. برای سایر ارتباطات به وجود این قسمت نیاز نمی‌باشد.

public class ProductMap : ClassMap<Product>
{
 public ProductMap()
 {
 Id(x => x.Id);
 Map(x => x.Name);
 Map(x => x.Price);
 HasManyToMany(x => x.StoresStockedIn).Cascade.All().Inverse().WithTableName("StoreProduct");
 }
}

Application :
در این بخش data ها مقداردهی اولیه می‌شوند.

static void Main()
{
 var sessionFactory = CreateSessionFactory();

 using (var session = sessionFactory.OpenSession())
 {
 using (var transaction = session.BeginTransaction())
 {
 // create a couple of Stores each with some Products and Employees
 var barginBasin = new Store { Name = "Bargin Basin" };
 var superMart = new Store { Name = "SuperMart" };

 var potatoes = new Product { Name = "Potatoes", Price = 3.60 };
 var fish = new Product { Name = "Fish", Price = 4.49 };
 var milk = new Product { Name = "Milk", Price = 0.79 };
 var bread = new Product { Name = "Bread", Price = 1.29 };
 var cheese = new Product { Name = "Cheese", Price = 2.10 };
 var waffles = new Product { Name = "Waffles", Price = 2.41 };

 var daisy = new Employee { FirstName = "Daisy", LastName = "Harrison" };
 var jack = new Employee { FirstName = "Jack", LastName = "Torrance" };
 var sue = new Employee { FirstName = "Sue", LastName = "Walkters" };
 var bill = new Employee { FirstName = "Bill", LastName = "Taft" };
 var joan = new Employee { FirstName = "Joan", LastName = "Pope" };

 // add products to the stores, there's some crossover in the products in each
 // store, because the store-product relationship is many-to-many
 AddProductsToStore(barginBasin, potatoes, fish, milk, bread, cheese);
 AddProductsToStore(superMart, bread, cheese, waffles);

 // add employees to the stores, this relationship is a one-to-many, so one
 // employee can only work at one store at a time
 AddEmployeesToStore(barginBasin, daisy, jack, sue);
 AddEmployeesToStore(superMart, bill, joan);

 // save both stores, this saves everything else via cascading
 session.SaveOrUpdate(barginBasin);
 session.SaveOrUpdate(superMart);

 transaction.Commit();
 }

 // retreive all stores and display them
 using (session.BeginTransaction())
 {
 var stores = session.CreateCriteria(typeof(Store))
 .List<Store>();

 foreach (var store in stores)
 {
 WriteStorePretty(store);
 }
 }

 Console.ReadKey();
 }
}

public static void AddProductToStore(Store store, params Product[] products)
{
 foreach (var product in products)
 {
 store.AddProduct(product);
 }
}

public static void AddEmployeeToStore(Store store, params Employee[] employees)
{
 foreach (var employee in employees)
 {
 store.AddEmployee(employee);
 }
}

اما شما الان قادر به run  کردن برنامه نیستید زیرا ما نیاز داریم متد CreateSessionFactory را پیاده سازی کنیم.

private static ISessionFactory CreateSessionFactory()
{
 return Fluently.Configure()
.Database(
 SQLiteConfiguration.Standard
 .UsingFile("firstProject.db")
 )
 .Mappings(m =>
 m.FluentMappings.AddFromAssemblyOf<Program>())
 .BuildSessionFactory();
}

اگر شما برای برنامه نمی‌خواهید که Schema را دستی تهیه کنید، اجرای دفعهٔ اول fail می‌شود. و آن به این خاطر است که یک چیز دیگر در آبجکت NHibernate configuration نیاز دارید و آن متد expose configuration  است . با استفاده از آن شما قادرید در زمان اجرا (Run Time) Schema را بسازید. (اگر مایلید که این کار را انجام دهید) کد را به صورت زیر تغییر بدهید.

private static ISessionFactory CreateSessionFactory()
{
 return Fluently.Configure()
 .Database(
 SQLiteConfiguration.Standard
 .UsingFile("firstProject.db")
 )
 .Mappings(m =>
 m.FluentMappings.AddFromAssemblyOf<Program>())
 .ExposeConfiguration(BuildSchema)
 .BuildSessionFactory();
}

private static void BuildSchema(Configuration config)
{
 // delete the existing db on each run
 if (File.Exists(DbFile))
 File.Delete(DbFile);
 // this NHibernate tool takes a configuration (with mapping info in)
 // and exports a database schema from it
 new SchemaExport(config)
 .Create(false, true);
}

با استفاده از کد بالا Schema شما بصورت RunTime ایجاد می‌شود و شما لازم نیست که بصورت دستی Schema را ایجاد نمایید.
شما میتوانید نمونه‌های بیشتری از fluent configuration  را در این لینک مشاهده کنید.
لینک‌های استفاده شده برای تهیهٔ این مطلب :

http://wiki.fluentnhibernate.org/show/HomePage

http://wiki.fluentnhibernate.org/show/GettingStarted:+First+Project

http://wiki.fluentnhibernate.org/show/FluentConfiguration

Fluent NHibernate Logo

Fluent NHibernate نیز مانند NHibernate یک برنامۀ open source است که برای map کردن کلاس ها به جداول database مورد استفاده قرار می‌گیرد.

FluentNHibernate پیشنهاد می‌کندکه بجای نوشتن کد xml تحت عنوان (.hbm.xml files) از کدC# استفاده کنید.این باعث می‌شود کدنویسی ساده‌تر شده و قابلیت خواندن کدها بهبود یابد و البته کد کوتاه‌تر شود.

همانطور که می‌دانید در استفاده از NHibernate به عنوان یک OR Mapper برای مپ کردن کلاسها به جداول از فایل‌های xml استفاده می‌شود.اما Fluent NHibernate چیز دیگری را پیشنهاد می‌کند.اما چرا؟

فایل xml خوب است اما چند مورد نامطلوب در مورد آن وجود دارد:

1. به علت اینکه xml بوسیله‌ٔ کامپایلر ارزیابی نمی‌شود‌،شما می‌توانید در کلاسهایتان نام property ها را تغییر دهید ولی آنها در فایل‌های mapping ، update نمی‌شوند. و شما این تغییر را تا زمان اجرا متوجه نمی‌شوید.
2. فایل xml زیادی طولانی است.گرچه NHibernate به تدریج از element های اجباریxml کاسته اما شما هنوز از این درازنویسی رها نشده‌اید.
3. Mapping های تکراری-فایل‌های hbm در NHibernate می‌توانند کاملاً طولانی شوند اگر شما برای هر یک قوانینی تعین کنید.مثل اینکه بخواهید همهٔ string ها not-null باشند.

حالا Fluent NHibernate چگونه با این مسا‌ئل برخورد می‌کند:

می‌توانید mapping هاتان را به سمت کد واقعی حرکت دهید پس آنها در تمام application کامپایل می‌شوند و اگر تغییراتی را اعمال کنید کامپایلر در لحظه اخطار می‌دهد و یا با refactory تغییرات را اعمال می‌کند. و برای بازنویسی قوانین نحوه‌ای را پیشنهاد می‌کند که یک بار این قوانین نوشته شوند.

به نمونه کد زیر توجه کنید.

public class CatMap : ClassMap
{
public CatMap()
{
Id(x => x.Id);
Map(x => x.Name).WithLengthOf(16).Not.Nullable();
Map(x => x.Sex);
References(x => x.Mate);
HasMany(x => x.Kittens);
}
}

Fluent NHibernate را می‌توانید از سایت رسمی‌اش به این آدرس

و یا از سرورهای گوگل کد در این آدرس دریافت نمایید.

اگر شما تا حالا با NHibernate 2.0 کار می‌کردید و حالا می‌خواهید آن را به نسخه جدید upgrade  کنید. اگر برای این کار فقط فایل‌های dll را تغییر دهید و برنامه را اجرا کنید به error زیر برمی‌خورید.

The ProxyFactoryFactory was not configured.

برای رفع این مشکل باید صفت ‘proxyfactory.factory_class’ را از بخش session-factory   در Web.Config برنامه با یک NHibernate.ByteCode مقدار دهی اولیه کنید.

برای این کار به روش زیر عمل کنید:

فایل Web.Config را باز کرده

بخش مربوط به NHibernate را در آن پیدا کنید و صفت زیر را به آن اضافه کنید.

<property name=’proxyfactory.factory_class’>NHibernate.ByteCode.LinFu.ProxyFactoryFactory, NHibernate.ByteCode.LinFu</property>

همچنین می‌توانید بصورت زیر نیز عمل کنید:

<property name=’proxyfactory.factory_class’>NHibernate.ByteCode.Castle.ProxyFactoryFactory, NHibernate.ByteCode.Castle</property>

همانطور که ملاحظه کردید . پیش از این NHibernate  بطور پیش فرض از Castles Dynamic proxy برای generate ، proxy های runtime استفاده می‌کرد اما در نسخه جدید شما می‌توانید از هر نمونه دلخواهی استفاده کنید و به همین دلیل باید آن را در تنظیمات برنامه اضافه کنید.

<property name=”proxyfactory.factory_class”>NHibernate.ByteCode.Castle.ProxyFactoryFactory, NHibernate.ByteCode.Castle</property>

اگر هم می‌خواهید از proxy factory دیگری استفاده کنید، دقت کنید که آن را به صورت صحیح اضافه کنید.

لینک‌های مرتبط و منابع

دانلود فایلها و سورس Nhibernate از سرور SourceForge

رفع مشکل بروزرسانی NHibernate از نسخه ۲.۰ به نسخه ۲.۱

که ارتباطاتشان به صورت زیر تعریف شده است :

تمرین یک : روابط بین کلاس‌ها

توضیحات :
یک دانشگاه دارای یک یا چند استاد است و یک استاد در یک یا چند دانشگاه مشغول به کار است، یک دانشگاه یک یا چند کلاس دارد و کلاس‌ها متعلق به یک دانشگاه هستند ، کلاس را یک استاد اداره می‌کند و هر استاد می‌تواند چند کلاس را اداره کند ، دانشجویان می‌توانند یک یا چند کلاس داشته باشند و هر کلاس می‌تواند یک یا چند دانشجو داشته باشد .
تعریف کلاس‌ها به صورت زیر می‌باشد :

public class Department
{
private int id;
private string name;
private IDictionary classes;
private IDictionary professors;
}

public class Professor : Person
{
private int id;
private string firstname;
private string lastname;
private string id;
private IDictionary departments;
private IDictionary classes;
}

public class UniversityClass
{
private int id;
private string name;
private string number;
private string syllabus;
private DateTime startDate;
private Professor professor;
private IDictionary students;
private Department department;
}

public class Student : Person
{
private int id;
private string firstname;
private string lastname;
private string ssn;
private IDictionary classes;
}

public interface Person
{
public int Id;
public string FirstName;
public string LastName;
}

و نهایتا ساختار Database بدین شکل خواهد بود:

تمرین یک : روابط بین جداول پایگاه داده

فایل‌های map شده

مرحلهٔ بعد فراهم کردن فایل‌های مپ شده است که با اطلاعات موجود در جداول در ارتباط هستند. هر کلاس، فایل‌های مپ شدهٔ خود را نیاز دارد. این فایل‌ها می‌توانند هرجا که شما بخواهید ذخیره شوند. اما بهتر است برای سادگی کار یک library به پروژه add کنید و این فایل‌ها را در آنجا ذخیره کنید. توجه داشته باشید که فایل‌های مپ شده برای ویژگی‌هایی که قرار است ماندگار (Persistence) باشند (ذخیره شوند) تهیه می‌شوند.

گام نخست: ایجاد جداول در پایگاه داده

برای شروع کار ابتدا در DataBase، جداول مربوطه را تشکیل می‌دهیم. (درست مانند شکل بالا، به این معنی که باتوجه به تصویر جداول پایگاه داده، این جداول را در Database ایجاد کنید).

گام دوم: ایجاد فایل‌های Map

س‍پس اقدام به ایجاد فایل‌های مپ شده می‌کنیم. (توجه داشده باشید که این کلاس‌ها باید با پسوند .xml ذخیره شوند). برای مثال باتوجه به موارد بالا، اگر بخواهیم برای کلاس Department فایل مپ ایجاد کنیم، باید بصورت زیر عمل کنیم. بدین منظور ابتدا تگ شناسایی xml را در ابتدای فایل بصورت زیر قرار می‌دهیم.

<?xml version=“1.0“ encoding=“utf-8“ ?>

بعد باید مشخص کنیم که این فایل یک فایل مپ شده برای NHibernate است. بدین منظور به شکل زیر NameSpace مورد استفاده را به فایل اضافه می‌کنیم.

<!–[if gte mso 9]> Normal 0 false false false EN-US X-NONE AR-SA <![endif]–><!–[if gte mso 9]> <![endif]–>

<hibernate-mapping xmlns=“urn:nhibernate-mapping-2.0“>

سپس به جمع‌آوری property ها می‌پردازیم (هر کدام که بخصوص باشند). بیایید به اولین کلاس‌مان نگاهی بیاندازیم که مجموعه‌ای از کلاس‌ها در دانشگاه است. نیازها و مدل‌ها را به خاطر داریم: یک دانشگاه می‌تواند چندین کلاس داشته باشد اما کلاس متعلق به یک دانشگاه است. این یک ارتباط یک به چند است. برای مدل کردن آن نیاز به element های <set> داریم که نشان دهیم که مجموعه‌ای را مپ می‌کنیم.

به عبارت ساده‌تر با کد بالا، مقادیر کلید DeptID که در جدول خودش PrimaryKey است، به ستون مشخص شده‌اش Map می‌شود. نشانهٔ name در <set> نام یک فیلد است که مجموعه را نگه می‌دارد. در اینجا column در <key>  نام یک ستون در مجموعه‌ای است که به مشخصهٔ id کلاس والد مپ می‌شود و <one_to_many> نوع کلاس گردآوری شده است. به این معنی که رابطه این ستون (فیلد) با ستون دیگر به چه صورتی است ( پایین‌تر به انواع دیگری هم اشاره می‌کنیم)
بنابراین جدولuniversity یک فیلد به نام deptid دارد که به id در کلاس university ی ما مپ می‌شود.
سرانجام ما باید فیلد professors را مپ کنیم. مدلمان را به خاطر بیاورید، دانشگاه می‌تواند چندین استاد داشته باشد و اساتید نیز می‌توانند در چندین دانشگاه مشغول به کار باشند. این یک ارتباط چند به چند است. که در زیر نمونه‌ای از آن را مشاهده می‌کنید، در پیاده سازی صرفا کلمه کلیدی one-to-many و many-to-many تفاوت می‌کند.

<set name=“Professors“ table=“departmentprofessor“>

<key column=“DeptID“/>

<many-to-many class=“nhRegistration.Person,nhRegistration” column=“Personid“/>

</set>

حال مپینگ کامل زیر را بخوانید

<?xml version=“1.0“ encoding=“utf-8“ ?>

<hibernate-mapping xmlns=“urn:nhibernate-mapping-2.0“>

<class name=“nhRegistration.Department, nhRegistration“

table=“Department“>

<id name=“Id“ column=“DeptID“ type=“Int32“>

<generator class=“assigned“ />

</id>

<property name=“Name“ column=“DeptName“ type=“String(50)“/>

<set name=“Classes“ cascade=“all“>

<key column=“DeptID“/>

<one-to-many class=“nhRegistration.UniversityClass,nhRegistration“/>

</set>

<set name=“Professors“ table=“departmentprofessor“>

<key column=“DeptID“/>

<many-to-many class=“nhRegistration.Person,nhRegistration“ column=“Personid“/>

</set>

</class>

</hibernate-mapping>

اگر ما با استفاده از این مپینگ‌ها سعی کنیم که پروژه را load کنیم، موفق نمی‌شویم. NHibernate یک exception را گزارش می‌دهد زیرا ارتباطات یک به چند و چند به چند داریم. وقتی ارتباطاتی شبیه این داریم که NH هر دو طرف آن است باید نوع آنها را هم مپ کنیم.

تنها element جدید در این فایل <many_to_one> است که نمایندهٔ طرف دیگر <one_to_many>  در Department.hbm.xml است.

نوبت به professor می‌رسد که از همه جالب‌تر است، زیرا هم از interface ای بنام person به ارث رفته و هم یک جدول مشترک با دانشجو دارد. برای تشخیص professor و student باید به NH بگوییم که نوع موجودیت چیست و در  <discriminator> آن را مشخص می‌کنیم.

اگر نگاهی به مدل بیاندازید person ،3 فیلد را مشخص می‌کند: id ، person و lastname. student و professor هر دو این نمایندهٔ این فیلدها هستند اما آنه اتفاوت دارند. Student ، ssn دارد در حالی که professor ، identifier دارد. Professor مجموعه‌ای از دانشگاه‌ها و کلاسها را دارد در حالی که student فقط مجموعه‌ای از کلاس‌ها (ی درس) را دارد. شما می‌توانید فیلدها را در کلاس person مپ کنید اما فیلدهایی را که خاص هستند به عنوان subtype در <subclass> مپ کنید.

در حقیقت برای ثبت فضا‌، مجموعه مختلفی از فایل‌های مپ شده را برای پر‌رنگ کردن feature‌های polymorphism related ادغام می‌کنیم. این مجموعه به نظر می‌رسد شبیه مثال‌های بالا باشد.

با انجام کارهای بالا شما یک پروژه را با موفقیت به پایگاه داده مپ کرده‌اید. در مطالب بعدی نحوه استفاده از این کلاس‌ها را مرور خواهیم کرد.
منابعی که در نگارش این مطلب بکار رفته است.

برای استفاده از NHibernate مراحل مخنلفی را باید سپری کرد که در زیر به آنها اشاره می‌شود. توجه داشته باشید که برای استفاده از ان.هایبرنیت باید کارهای دیگری انجام داد که در آینده به آنها خواهیم پرداخت، در این مطلب قصد داریم نحوه نصب و پیکربندی NHibernate را در یک سیستم تشریح کنیم .

گام اول . دانلود و نصب ان.هایبرنیت .

در ابتدا NHibernate را از اینجا در سورس فورگ دانلود کزده و نصب کنید.

گام دوم . اضافه کردن DLL های ان.هایبرنیت به پروژه.

پروژه‌ای ایجاد کنید و فایل اسمبلی داخل پوشه BIN را که از آدرس بالا دانلود کردید به پروژه اضافه کنید.

گام سوم . تنظیمات مورد نیاز در Web.Config .

در ادامه تنظیمات زیر در فایل web.config برنامه اضافه می‌کنیم.

چند نکته که باید در ادامه به آنها توجه داشت.

وقتی برای تشخیص Data Store ، FrameWork تان را پیکربندی کردید، باید فضای مدل (ModelSpace) و همچنین پایگاه داده‌تان را معرفی و مشخص کنید.

نکته دیگری هم وجود دارد و آن map کردن فایل‌ها و توضیح روابط (Relations) بین کلاس‌ها و جداول است.

‫امروزه NHibernate ابزاری را فراهم کرده که می‌تواند DLL هایی را از فایل‌های map شده تولید کند. و اضافه کردن یک شیء جدید به برنامه، درواقع یک NAnt task است که بطور خودکار توسط ‏‏ #C از فایل‌های مپ شده تولید می‌شود.

با انجام تنظیمات بالا باید براحتی از NHibernate در برنامه‌تان استفاده کنید. در مطلب بعدی یک مثال کاملا عملی برای کار با NHibernate می‌آورم.

منابعی که برای نگارش این مطلب از آنها استفاده شده است

The Server Side .net

NHibernate on SourceForge
نوشته شده در Programming, معرفی Tagged: Configuration, NHibernate, ORM ]]> http://nhibernate.wordpress.com/2009/03/11/installing-configuring-nhibernate/feed/ 1 nhibernate http://nhibernate.wordpress.com/2009/02/23/hibernate-specifications/ http://nhibernate.wordpress.com/2009/02/23/hibernate-specifications/#comments Mon, 23 Feb 2009 08:00:23 +0000 nhibernate http://nhibernate.wordpress.com/?p=21 ]]> از آنجا که برای شروع به کار با یک برنامه، کسب اطلاع از نقاط ضعف و قوت آن از ملزومات است و از آنجا که برنامه NHibernate در یکی از حساس ترین و مهمترین لایه های برنامه نهایی اجرا می شود، دانستن مطالب زیر را الزامی می‌دانم، همچنین لازم بذکر است که مطالب زیر شامل مباحث فنی مختلفی است که از حوصله این مطلب خارج است به همین دلیل توضیحات مربوط به اصطلاحات ذکر شده را به عهده خواننده مطلب می‌گذارم.

1.     Natural programming model : بدین معنا که NHibernate ، OO را پشتیبانی می‌کند . یعنی ارث‌بری (Inheritance) ، چند‌ریختی (Polymorphism) ، ترکیب (Composition) ، Collection در .NET که شامل Generic collection ها هم می‌شود .

2.     Native .net ‏: API های NHibernate بر مبنای زبان‌های .NET و استانداردهای آن ایجاد شده است .

3.     Support for fine-grained object models : پشتیبانی از مدل‌های آبجکتی، از طریق مدل‌های مختلف غنی شده از مپینگ‌ها، برای Collection ها و Object  های وابسته .

4.     No build time byte code enhancement : در روند بیلد شدن، پردازش بر اساس بایت‌کدها و ایحاد کدهای اضافی وحود ندارد . در حقیقت در زمان بیلد شدن هیچ بهبودی در بایت‌کدها داده نمی‌شود .

5.     The query options : از بدست آوردن آبجکت‌های دیتابیس گرفته تا بدست آوردن خروجی‌های آنها . به هر دوی این مسائل می‌پردازد .

6.     Custom SQL : تصحیح کامل SQL که NHibernate باید برای آبحکت‌هایش از آنها استفاده کند .

7.     Support for “conversations” : ان.هایبرنیت از ماندگاری بالای مفاهیم ، سوا و سر‌هم‌بندی آبحکت‌ها پشتیبانی می‌کند و همچنین از optimistic locking به صورت خودکار مراقبت می‌کند .

8.     Free/open source : ان هاببرنیت، تحت مجوز LGPL (Lesser GNU Public License) است و سورس پروژه ان.هایبرنیت را از سایت SourceForge از اینجا می توانید دانلود کنید .

منابعی که در نگارش این مطلب از آنها استفاده شده است
     سایت رسمی NHibernate
     توضیحات ویکی پدیا در مورد NHibernate

یک ORM است که تحت پلت فرم دات نت مایکروسافت کار می‌کند ، و یک FrameWork را برای  کار راحت‌تر و با پیچیدگی کمتر با database پیشنهاد می‌کند. در این مدل فیلدهای Database به آبجکت‌های معادلی، برای استفاده در محیط دات نت تبدیل (map) می‌شوند . و با این کار برنامه‌نویسان از پیچیدگی‌های ارتباطی DataBase ای خلاص می‌شوند.

 NH (NHibernate) یک نرم‌افزار کدباز ( OpenSource ) رایگان است. و قسمتی از java ORMapper Hibernate است که کدی در قالب  XML  از موجودیت‌ها (Entity) و روابط (Relation) ارائه می‌کند. و به صورت اتوماتیک برای ذخیره و بازیابی Data ها کد Sql تولید می‌کند، و شما می‌توانید با متادیتاهای (meta data) ذخیره شده در source code کار کنید.

نسخه های NHibernate

   1.      NHibernate نسخه 1.2.1 در نوامبر سال 2007 ( مهر ماه ۱۳۸۶ ) به بازار آمد و با .NET 2.0  کار می‌کرد.

   2.      NHibernate نسخه 2.0 در آگوست سال 2008 ( مرداد ماه ۱۳۸۷ ) عرضه شد.

   3.      NHibernate نسخه 2.0.1 در سپتامبر سال 2008 ( شهریور ماه ۱۳۸۷ ) عرضه شد. و با دات نت 1.1 و  2.0 کار می‌کرد

   4.      NHibernate نسخه 2.1 در اواسط سال 2009 ، عرضه خواهد شد.

   5.      NHibernate نسخه 3.0 اولین نسخه ای خواهد بود که از .net 3.5 استفاده خواهد کرد .

توجه داشته باشید که در نسخه های بالا در مورد کارکرد برنامه با .net framework های مختلف ، متن بر اساس نوشته های سایت رسمی  nhibernate و ویکی پدیا آورده شده .  تجربه شخصی نشان می دهد که نسخه‌های پایین تر با framework 3.5 مشکلی ندارند و بخوبی با آن کار می کنند . ( احتمالا منظور از سازگار بودن با فریم ورک های مختلف، استفاده از حداکثر قابلیت های آن فریم ورک است )

توانایی اصلی «ان هایبرنیت» در map کردن table های DataBase به کلاس‌های .NET است.

ان.هایبرنیت همچنین DataQuery و امکان بازیابی (retrieval) را فراهم می‌کند ، کدهای SQL تولید می‌کند و طراح را  از هندل کردن دستی DataBase نسبت به تبدیلات آن و نگهداری Application های Sql ، راحت می‌کند.

NH ، ماندگاری مناسبی را برای طرح قدیمی CLR (Compiler Language Runtime) فراهم می‌کند. و آبجکت‌های کلاس شما مجبور نیستند مدل برنامه نویسی محدود کننده‌ای را دنبال کنند.

مزیت مهم استفاده از NHibernate این است که می‌توان برای بانک اطلاعاتی به صورت Object Oriented (OO ) کد نوشت. یعنی عملا DtaBase یک Object است که از آن در قالب Data ی map شده استفاده می‌کنیم.

در صورت استفاده کردن از DataSet به جای NH برنامه سرعت بیشتری دارد؛ اما برای نوشتن کد باید کد Sql بنویسیم، پس درگیر پیچیدگی‌های کار با Sql در محیط .NET خواهیم شد. درضمن اگر قرار به عوض کردن نوع DataBase باشد ، اگر framework ای هم از قبل برای راحتی کار درست کرده باشیم، به صورت کامل باید تغییر کند و دوباره نوشته شود. اما در صورت استفاده از NHibernate در صورت تمایل به تغییر DataBase فقط و فقط در تعریف نام DataBase باید تجدید نظر کرد و تمام تغییرات وابسته به database با تغییر پایگاه داده نهایی خودبخود تغییر می‌کنند و ان هایبرنیت آنها را برای ما ایجاد می‌کند.

منابعی که برای تهیه این مطلب از آنها استفاده شده است

     nHibernate درویکی پدیا

     theserverside.net

     تجارب شخصی

مطلب زیر از اینجا در ویکی پدیا قابل دسترسی می باشد .