धाराप्रवाह NHibernate और Oracle

इस विषय में, मैं ओरेकल के साथ धाराप्रवाह NHibernate पुस्तकालय पर प्रकाश डालना और एक छोटा सा उदाहरण देना चाहूंगा। इस विषय पर अब कुछ लेख हैं ( हब पर उल्लेख), यहां तक ​​कि ओरेकल के साथ बातचीत का वर्णन भी कम है। स्वाभाविक रूप से, अधिकांश रूसी में नहीं हैं। हालांकि, पुस्तकालय ध्यान देने योग्य है।

लेखकों ने खुद को XML के NHibernate (तो xmlless बोलने के लिए) से छुटकारा देने का कार्य निर्धारित किया है। इसलिए, हमारी परियोजना में यह नहीं होगा। निश्चित रूप से। इसके बजाय, एक धाराप्रवाह ("द्रव" या "लचीला") इंटरफ़ेस प्रदान किया जाता है जो डेटाबेस और मानचित्र संस्थाओं को ट्यून करने के लिए लैम्ब्डा अभिव्यक्तियों और विधि श्रृंखलाओं का उपयोग करता है।

आवश्यक वस्तुएँ

हमें आवश्यकता होगी:

• Oracle सर्वर (मेरे मामले में 11.2.0.1.0)
• Oracle DAC (डेटा एक्सेस कंपोनेंट्स, मेरे मामले में 11.2.0.2.1), Oracle क्लाइंट या Oracle डेटाबेस तक आपकी पहुंच का कोई अन्य प्रदाता।

भविष्य में समस्याओं से बचने के लिए, सुनिश्चित करें कि आप डेटाबेस से जुड़ सकते हैं, उदाहरण के लिए, तृतीय-पक्ष उपयोगिताओं का उपयोग कर। क्लाइंट सेटिंग्स यहां स्थित हैं:

%Oracle DAC/Client%\product\11.2.0\client_1\Network\Admin\tnsnames.ora

मेरे मामले में, फाइल इस तरह दिखती है:
ORCL =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = orasrvxp)(PORT = 1521))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SERVICE_NAME = orcl)
)
)


एक प्रोजेक्ट बनाएं

Visual Studio 2010 में एक नया कंसोल प्रोजेक्ट बनाएँ और इसे FluentExample नाम दें। मैं आवश्यक पैकेजों को जल्दी से खोजने, प्राप्त करने और स्थापित करने के लिए NuGet Package Manager का उपयोग करता हूं। आप स्वयं भी पुस्तकालय स्थापित कर सकते हैं।

प्रोजेक्ट फ़ाइल पर राइट-क्लिक करें और "लाइब्रेरी पैकेज संदर्भ जोड़ें ..." पर क्लिक करें। खोज फ़ील्ड में ऑनलाइन टैब में, "धाराप्रवाह" दर्ज करें:



धाराप्रवाह NHibernate के अलावा, सभी निर्भरताएं लोड की जाएंगी (Castle.ore, Iesi.Collections, NHibernate, NHibernate.Castle)।

मैं पुस्तकालय की वेबसाइट से एक मूल उदाहरण पर आधारित होगा, यह बस और पर्याप्त रूप से पूरी तरह से पुस्तकालय की क्षमताओं को दिखाता है। योजना का रूप है:

प्रोजेक्ट में, दो सबफ़ोल्डर बनाएं: एंटिटीज़ और मैपिंग, जिसमें इकाइयाँ और, तदनुसार, मैपिंग स्थित होंगे।

संस्थाओं का वर्णन करना

प्रथम इकाई, कर्मचारी। कर्मचारी का एक नाम, उपनाम और काम का स्थान है - स्टोर। Entities फ़ोल्डर में, निम्न कोड के साथ एक नया वर्ग जोड़ें:

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 ; }
}

* This source code was highlighted with Source Code Highlighter .

मैं आपका ध्यान दो बातों की ओर आकर्षित करता हूं:

• इसके बाद, निजी संपत्ति के साथ Id संपत्ति और एक-से-कई सूची संपत्तियां घोषित की जाती हैं। केवल NHibernate Id (प्रतिबिंब के माध्यम से) के लिए मान निर्धारित करेगा, और हम निर्माणकर्ता में सूचियों को आरंभ करते हैं।
• सभी गुणों को virtual संशोधक के साथ घोषित किया जाता है, क्योंकि NHibernate हमारी संस्थाओं के लिए प्रॉक्सी कक्षाएं बनाएगा, और आपको संपत्ति अधिभार सक्षम करना होगा।

अगली पंक्ति में एक ऐसा उत्पाद है जिसका नाम, मूल्य और उन्हें बेचने वाले स्टोरों की सूची है:

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()
{
StoresStockedIn = new List <Store>();
}
}

* This source code was highlighted with Source Code Highlighter .

सूची में एक निजी सेटर है और निर्माण को प्रारंभिक रूप में वर्णित किया गया है, जैसा कि ऊपर वर्णित है।

नाम के साथ स्टोर की श्रेणी, साथ ही सामान और कर्मियों की सूची:

public class Store
{
public virtual int Id { get ; private set ; }
public virtual string Name { get ; set ; }
public virtual IList<Product> Products { get ; private set ; }
public virtual IList<Employee> Staff { get ; private set ; }

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);
}
}

* This source code was highlighted with Source Code Highlighter .

इस वर्ग में, हम थोड़ा तर्क का वर्णन करते हैं, क्योंकि NHibernate को संबंधित संस्थाओं को संग्रहीत करने से पहले संबंध के दोनों पक्षों को परिभाषित करने की आवश्यकता होती है।

यहीं पर हमारी संस्थाओं का वर्णन समाप्त होता है। उत्पाद और स्टोर के बीच कई-से-कई संबंधों के कार्यान्वयन के लिए लिंकिंग तालिका नीचे चर्चा की जाएगी।

Mappim संस्थाओं

इसके अलावा, क्लासिक NHibernate का उपयोग करते समय, आपको xml मैपिंग फ़ाइलों और डेटाबेस कॉन्फ़िगरेशन लिखना शुरू करना चाहिए। लेकिन यह वह जगह है जहां धाराप्रवाह NHibernate लागू होता है।

नीचे वर्णित सभी मैपिंग कक्षाएं मैपिंग फ़ोल्डर में स्थित हैं। आइए Employee वर्ग को प्रदर्शित करके शुरू करें।

using FluentExample.Entities;
using FluentNHibernate.Mapping;

namespace FluentExample.Mappings
{
public class EmployeeMap : ClassMap<Employee>
{
public EmployeeMap()
{

}
}
}

* This source code was highlighted with Source Code Highlighter .

प्रदर्शन कोड को ही FluentNHibernate पुस्तकालय से ClassMap से विरासत में प्राप्त वर्ग के कंस्ट्रक्टर में रखा जाएगा। मैपिंग खोजने के लिए धाराप्रवाह NHibernate के लिए, आपको public संशोधक के साथ कक्षाएं घोषित करनी चाहिए। तुरंत पूर्ण मानचित्रण पर विचार करें:

public EmployeeMap()
{
Table( "Employee" );
Id(e => e.Id)
.GeneratedBy.Sequence( "Employee_seq" );
Map(e => e.FirstName);
Map(e => e.LastName);
References(e => e.Store);
}

* This source code was highlighted with Source Code Highlighter .

पहली पंक्ति, Table() , तालिका के नक्शे के नाम के लिए जिम्मेदार है। नीचे हम देखेंगे कि नाम स्पष्ट रूप से क्यों निर्दिष्ट करें।

Id() विधि में, हम इंगित करते हैं कि ऑब्जेक्ट किस क्षेत्र की पहचान करता है (NHibernate: <id> )। यदि हमने ऑटो-इंक्रीमेंट के साथ एक डेटाबेस का उपयोग किया है, तो धाराप्रवाह NHibernate स्वचालित रूप से पहचान करेगा और एक पहचान जनरेटर (NHibernate: <generator> ) असाइन करेगा। लेकिन, चूंकि ओरेकल में कोई ऑटो-इन्क्रीमेंट नहीं है, हम एक सीक्वेंस का उपयोग करेंगे, जो बाद में तरीकों की श्रृंखला में इंगित किया गया है।

अगली दो पंक्तियाँ स्केलर गुण (NHibernate: <property> ) के प्रदर्शन को दर्शाती <property> , जहाँ प्रकार और नाम स्वतः निर्धारित होते हैं। यह एक संपत्ति नामकरण सम्मेलन का उपयोग करके कार्यान्वित किया जाता है। कॉलम नाम को Column() विधि का उपयोग करके मैन्युअल रूप से निर्दिष्ट किया जा सकता है, लेकिन फिर भी मैं डिफ़ॉल्ट सम्मेलनों का उपयोग करने या अपना स्वयं का सेट करने की सलाह देता हूं। समझौतों पर अधिक ।

अगली पंक्ति से पता चलता है कि हमारी वस्तु एकवचन में Store वर्ग को संदर्भित करती है, अर्थात यह कई पक्षों को कई-से-एक के लिए लागू करती है। निम्नलिखित सम्मेलनों के बाद विदेशी कुंजी नाम, Store_id माना जाता है। Column() विधि द्वारा विदेशी कुंजी कॉलम को ओवरराइड किया जा सकता है। References() विधि का उपयोग "कई" पक्ष पर किया जाता है, रिश्ते के दूसरी तरफ ("एक"), HasMany() (NHibernate: <bag> ) विधि का उपयोग किया जाएगा, और कुंजी फ़ील्ड का नाम बदलने के लिए संबंधित विधि KeyColumn() ।

आइए Table() वापस जाएं Table() विधि। यहाँ मुद्दा यह है कि डिफ़ॉल्ट रूप से, तालिका के नाम प्रदर्शित करते समय, धाराप्रवाह NHibernate उन्हें उद्धरण चिह्नों (इस तरह के एक समझौते) के साथ घेरता है, अर्थात, हमारी तालिका में अब "कर्मचारी" नाम होना चाहिए, उद्धरण चिह्नों के साथ। ओरेकल में, केवल उद्धरण चिह्नों से घिरे नाम केस संवेदनशील होते हैं। हमारे उदाहरण में, मैं उद्धरण चिह्नों का उपयोग नहीं करना चाहता हूं और तालिका के नाम मामले को असंवेदनशील और उद्धरण चिह्नों के बिना छोड़ना चाहता हूं, इसलिए मैंने उन्हें स्पष्ट रूप से संकेत दिया।

चलो स्टोर की मैपिंग पर चलते हैं:

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

* This source code was highlighted with Source Code Highlighter .

हम यहां एक सममित HasMany() Employee वर्ग के लिए कॉल करते हैं, जिसकी हमने ऊपर जांच की थी। HasManyToMany() पद्धति का भी उपयोग किया जाता है, जो एक मध्यवर्ती तालिका के माध्यम से स्टोर और उत्पाद के बीच के कई-कई संबंधों को लागू करता है जिसका नाम Table() विधि द्वारा श्रृंखला में निर्दिष्ट किया गया है।

Inverse() विधि से पता चलता है कि संग्रह का स्वामी संबंध का दूसरा छोर है, अर्थात, Employee वर्ग, और इसे पहले सहेजा जाएगा। Cascade.All() संबंधित मदों के लिए घटनाओं को पारित करता है। यही है, अगर, उदाहरण के लिए, हम स्टोर को हटाते हैं, तो इस स्टोर के उत्पादों और सभी कर्मियों के साथ सभी संचार भी हटा दिए जाएंगे। अधिक विवरण के लिए NHibernate प्रलेखन देखें।

अंत में, हमारे उत्पाद को प्रदर्शित करें:

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

* This source code was highlighted with Source Code Highlighter .

मुझे उम्मीद है कि पिछले मैपिंग के अनुभव से आपको यहां कुछ भी नया नहीं मिलेगा। धाराप्रवाह मैपिंग के बारे में अधिक जानें ।

अब यह ओरेकल से कनेक्शन को कॉन्फ़िगर करने का समय है।

ओरेकल से कनेक्ट करें

हम कनेक्शनस्ट्रिंग का उपयोग करके कनेक्ट करेंगे। प्रोजेक्ट के लिए एक नई फ़ाइल जोड़ें, App.config, और वहां मौजूद nberbern पासवर्ड के साथ धाराप्रवाह उपयोगकर्ता के लिए हमारा कनेक्शन स्ट्रिंग दर्ज करें:

Copy Source | Copy HTML

1. <? xml संस्करण = "1.0" एन्कोडिंग = "utf-8" ? >
2. < कॉन्फ़िगरेशन >
3. < कनेक्शनस्ट्रीम >
4. < name = "Oracle" जोड़ें
5. connectionString = "डेटा स्रोत = orcl; PASSWORD = nhibernate; उपयोगकर्ता सुरक्षा जानकारी = सत्य; USER ID = धाराप्रवाह"
6. प्रदाता नाम = "Oracle.DataAccess.Client" />
7. </ कनेक्शनस्ट्रीम >
8. </ कॉन्फ़िगरेशन >

इसके बाद, आपको Oracle.DataAccess असेंबली का एक लिंक जोड़ना होगा जो आपके चुने हुए प्रदाता के साथ आता है:



लिंक जोड़ने के लिए संवाद सबसे अधिक संभावना होगा - मैं उत्पादकता पावर टूल्स का उपयोग करता हूं।

अतिरिक्त लिंक प्रॉपर्टी सेट करें Copy Local = True , यह दर्शाता है कि इस लाइब्रेरी को हमारे प्रोजेक्ट के बाइनरी आउटपुट फ़ाइलों के साथ फ़ोल्डर में कॉपी किया जाना चाहिए:



सुविधा के लिए, हम धाराप्रवाह NHibernate में एक सत्र खोलने के लिए एक छोटे सहायक का उपयोग करेंगे:

using FluentExample.Entities;
using FluentNHibernate.Cfg;
using FluentNHibernate.Cfg.Db;
using NHibernate;
using NHibernate.Driver;

namespace FluentExample
{
public static class FluentNHibernateHelper
{
private static ISessionFactory _sessionFactory;
public static ISessionFactory SessionFactory
{
get
{
if (_sessionFactory == null )
{
var dbConfig = OracleDataClientConfiguration.Oracle10
.ConnectionString(c => c.FromConnectionStringWithKey( "Oracle" ))
.Driver<OracleDataClientDriver>()
.ShowSql();

_sessionFactory = Fluently.Configure()
.Database(dbConfig)
.Mappings(m => m.FluentMappings.AddFromAssemblyOf<Employee>())
.BuildSessionFactory();
}
return _sessionFactory;
}
}

public static ISession OpenSession()
{
return SessionFactory.OpenSession();
}
}
}

* This source code was highlighted with Source Code Highlighter .

डेटाबेस कॉन्फ़िगरेशन में, हम OracleDataClientConfiguration नाम स्थान से पूर्वनिर्धारित वर्ग OracleDataClientConfiguration का उपयोग करते हैं और इसे हमारे द्वारा बनाए गए कनेक्शन स्ट्रिंग और NHibernate ड्राइवर का उपयोग करने के लिए कॉन्फ़िगर करते हैं। आप जनरेट किए गए SQL प्रश्नों को प्रदर्शित करने के विकल्प को भी सक्षम कर सकते हैं। डेटाबेस कॉन्फ़िगरेशन के बारे में अधिक जानें ।

अगला, हम NHibernate के कॉन्फ़िगरेशन को स्वयं करते हैं। हम अपने डेटाबेस कॉन्फ़िगरेशन को प्रतिस्थापित करते हैं, मैपिंग के स्रोत को इंगित करते हैं, और सत्र कारखाने का अनुरोध करते हैं। धाराप्रवाह विन्यास के बारे में अधिक जानें ।

इस स्तर पर, एक सत्र प्राप्त करना सफल होना चाहिए:

class Program
{
static void Main()
{
using (FluentNHibernateHelper.OpenSession())
{

}
}
}

* This source code was highlighted with Source Code Highlighter .

हमारे आधार का परीक्षण

आपकी परियोजना को अब इसी तरह की संरचना करनी चाहिए:



असली परीक्षा चलाने का समय आ गया है:

private static void Main()
{
using ( var session = FluentNHibernateHelper.OpenSession())
{
using ( var transaction = session.BeginTransaction())
{
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" };

// . ,
// many-to-many.
AddProductsToStore(barginBasin, potatoes, fish, milk, bread, cheese);
AddProductsToStore(superMart, bread, cheese, waffles);

//
AddEmployeesToStore(barginBasin, daisy, jack, sue);
AddEmployeesToStore(superMart, bill, joan);

//
session.SaveOrUpdate(barginBasin);
session.SaveOrUpdate(superMart);

transaction.Commit();
}

//
using (session.BeginTransaction())
{
var stores = session.CreateCriteria( typeof (Store)). List <Store>();
foreach ( var store in stores)
WriteStorePretty(store);
}

Console .ReadKey();
}
}

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

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

private static void WriteStorePretty(Store store)
{
Console .WriteLine(store.Name);
Console .WriteLine( " Products:" );

foreach ( var product in store.Products)
Console .WriteLine( " " + product.Name);

Console .WriteLine( " Staff:" );
foreach ( var employee in store.Staff)
Console .WriteLine( " " + employee.FirstName + " " + employee.LastName);

Console .WriteLine();
}

* This source code was highlighted with Source Code Highlighter .

वह सब है।
मैं ओरेकल में एक सर्किट बनाने के लिए एक स्क्रिप्ट भी देता हूं।

आगे क्या है?

अवास्तविक कार्यक्षमता

लेखक मूल पुस्तकालय की क्षमताओं के एक बड़े हिस्से का समर्थन करते हैं, हालांकि, NHibernate की कुछ विशेषताएं अभी तक उपलब्ध नहीं हैं, उदाहरण के लिए, <sql-insert> ।

ऑटो मैपिंग

धाराप्रवाह NHibernate आपको स्वचालित रूप से मैपिंग करने की अनुमति देता है, बस दर्ज किए गए सम्मेलनों का पालन करें या अपने स्वयं के परिभाषित करें।

मानचित्रण परीक्षण

लाइब्रेरी आपको बनाए गए मैपिंग का परीक्षण करने के लिए जल्दी और उसी शैली में अनुमति देता है।

पूर्ण एपीआई प्रलेखन