कोड पहले धाराप्रवाह एपीआई का उपयोग कर रिश्तों का विवरण

ASP.NET MVC 4 मैनुअल को और अधिक विस्तार से समझने की कोशिश कर रहा हूं, मुझे धाराप्रवाह एपीआई, कोड फर्स्ट, एनोटेशन और कई अन्य जैसे अवधारणाएं आईं। धाराप्रवाह एपीआई पर ज्यादा जानकारी नहीं थी। खासकर रूसी में। हम देखते हैं।

एंटिटी फ्रेमवर्क में कोड फर्स्ट एप्रोच आपको अपने स्वयं के डोमेन वर्गों का उपयोग उस मॉडल का प्रतिनिधित्व करने के लिए करता है जिसका उपयोग ईएफ प्रश्नों का निर्माण, परिवर्तन और अद्यतन करने के लिए करता है। कोड पहले एक प्रोग्रामिंग पैटर्न का उपयोग करता है जिसे कॉन्फ़िगरेशन कन्वेंशन कहा जाता है। इसका मतलब यह है कि कोड फर्स्ट का मानना ​​है कि आपकी कक्षाएं स्कीमा के सम्मेलनों का पालन करती हैं जो ईएफ वैचारिक मॉडल के लिए उपयोग करता है। इस मामले में, ईएफ अपने कार्यों को करने के लिए आवश्यक भागों का उपयोग करने में सक्षम होगा। हालांकि, यदि आपकी कक्षाएं सही तरीके से सम्मेलनों का उपयोग नहीं करती हैं, तो आप आवश्यक कॉन्फ़िगरेशन को मैन्युअल रूप से जोड़ सकते हैं ताकि ईएफ उन्हें सही ढंग से समझ सके।

कोड Firs दृष्टिकोण का उपयोग करके, आप इन कॉन्फ़िगरेशन को दो तरीकों से परिभाषित कर सकते हैं। सबसे पहले DataAnnotations नामक सरल विशेषताओं का उपयोग करना है। दूसरा धाराप्रवाह एपीआई का उपयोग करने के लिए है, जो आपको कोड में अनिवार्य रूप से कॉन्फ़िगरेशन का वर्णन करने की अनुमति देता है।

यह लेख धाराप्रवाह एपीआई का उपयोग करके अनुकूलन पर केंद्रित है। वंशों या अलग-अलग वर्गों की ओर इशारा करने वाले गुणों के आधार पर वर्गों के बीच संबंधों का वर्णन करने के लिए कोड फ़ेयर कन्वेंशन बहुत उपयोगी होते हैं। यदि आपकी कक्षाओं में विदेशी कुंजी नहीं है, तो कोड फ़िर उन्हें स्वयं बना सकते हैं। लेकिन ऐसे समय होते हैं जब वर्ग विवरण रिश्ते के बारे में पर्याप्त जानकारी प्रदान नहीं करता है, ताकि कोड फ़िर सब कुछ सही ढंग से समझ सकें और "लापता" भागों को सही ढंग से जोड़ सकें।

मॉडल पर विचार करें

चलो दो सरल वर्गों, "ब्लॉग" और "पोस्ट" से शुरू करते हैं, जहां ब्लॉग का पोस्ट के साथ एक-से-कई संबंध हैं।

public class Blog { public int Id { get; set; } public string Title { get; set; } public string BloggerName { get; set; } public virtual ICollection<Post> Posts { get; set; } } public class Post { public int Id { get; set; } public string Title { get; set; } public DateTime DateCreated { get; set; } public string Content { get; set; } public int BlogId { get; set; } public Blog Blog { get; set; } } 

एक-से-कई संबंध सम्मेलन को समझना

एक कक्षा में एक से कई संबंधों को परिभाषित करने का एक सामान्य तरीका है, एक कक्षा में एक बाल संग्रह और एक विदेशी कुंजी बनाने के लिए, साथ ही बाल वर्ग में नेविगेशन संपत्ति के साथ। उपरोक्त उदाहरण में, ब्लॉग के पास एक पोस्ट प्रॉपर्टी है, जो टाइप पोस्ट के ICollection का एक संग्रह है। और पोस्ट, बदले में, एक विदेशी कुंजी है, BlogID, जिसे ब्लॉग नेविगेशन संपत्ति के रूप में भी जाना जाता है, जो अपने ब्लॉग पूर्वज को वापस इंगित करता है।

यह डेटा कोड प्रथम के लिए पर्याप्त है ताकि अधिवेशन के आधार पर डेटाबेस में निम्नलिखित तालिकाएँ बनाई जा सकें:



ध्यान दें कि कोड फर्स्ट ने BlogId फ़ील्ड को एक विदेशी कुंजी बनाया (प्राथमिक कुंजी / पोस्ट की विदेशी कुंजी के बीच प्रतिबंध ।BlogId और Blogs.Id निर्धारित किया गया है) और यह गैर-अशक्त है। कोड प्रथम ने कक्षा में वर्णित सम्मेलन के आधार पर इन निष्कर्षों को आकर्षित किया।

जब एक विदेशी कुंजी संपत्ति निर्दिष्ट न हो तो HasRequired का उपयोग करना

यदि आप BlogId प्रॉपर्टी को पोस्ट क्लास में सेट नहीं करते हैं, लेकिन ब्लॉग नेविगेशन प्रॉपर्टी सेट करते हैं। कोड पहले अभी भी आवश्यक संबंध बनाएगा, क्योंकि यह जानता है कि ब्लॉग संपत्ति ब्लॉग इकाई पर वापस इंगित करता है। वह Posts.Blog_Id विदेशी कुंजी बनाएगा, जैसा कि चित्र 2 में दिखाया गया है, और इसे Blog.Id के साथ संबद्ध करें।



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

क्लास से मॉडल बनाते समय धाराप्रवाह एपीआई कॉन्फ़िगरेशन का उपयोग कोड फर्स्ट में किया जाता है। आप DbContext क्लास के OnModelCreating विधि को ओवरराइड करके कॉन्फ़िगरेशन को एम्बेड कर सकते हैं, जैसा कि नीचे दिखाया गया है:

 public class BlogContext : DbContext { public DbSet<Blog> Blogs { get; set; } public DbSet<Post> Posts { get; set; } protected override void OnModelCreating(DbModelBuilder modelBuilder) { //configure model with fluent API } 

DbModelBuilder आपको सेटिंग्स को अवरोधन करने की क्षमता देता है। हम मॉडल बिल्डर को सूचित करते हैं कि हम किसी एक संस्था को बदलना चाहते हैं। इसके लिए हम जेनेरिक का उपयोग करते हैं, कि हम पोस्ट के सार को बदल देंगे। इस तक पहुंच प्राप्त करने के बाद, यह संभव हो गया है कि हेस्रिस्पर्ड विधि का उपयोग करें, जो रिश्ते का हिस्सा है, यह इंगित करने के लिए कि नेविगेशन संपत्ति की आवश्यकता है - इस मामले में, ब्लॉग संपत्ति।

 modelBuilder.Entity<Post>().HasRequired(p => p.Blog); 

परिणाम दोहरा प्रभाव है। पहला यह है कि Blog_Id फ़ील्ड फिर से रिक्त नहीं होगी। और ईएफ मांग पर या डेटाबेस को बचाने से पहले सत्यापन करेगा, ताकि यह सुनिश्चित हो सके कि सभी निर्दिष्ट शर्तों को पूरा किया गया है।

कस्टम विदेशी कुंजी नाम कस्टमाइज़ करना

यहां तक ​​कि अगर आपने एक विदेशी कुंजी निर्दिष्ट की है, तो इसका नाम हमेशा कोड फर्स्ट सम्मेलनों के साथ मेल नहीं खाता है। कन्वेंशन द्वारा, कुंजी नाम वर्ग या "classname_Id" या "classnameId" के नाम से मेल खाना चाहिए। यही कारण है कि कोड फर्स्ट मूल वर्ग संपत्ति, BlogId के साथ ठीक से काम करने में सक्षम था।

लेकिन अगर नाम सम्मेलन से नहीं हुआ तो क्या होगा? उदाहरण के लिए, "FK" + parent_class_name + "Id"।

 public int FKBlogId { get; set; } 

कोड पहले यह नहीं जानता कि FKBlogId को एक विदेशी कुंजी के रूप में कार्य करना चाहिए। यह FKBlogId के लिए एक मानक कॉलम बनाएगा और Blog_Id, जो विदेशी कुंजी बन जाएगा, क्योंकि यह ब्लॉग संपत्ति को लिंक करने के लिए आवश्यक है।



इसके अलावा, ब्लॉग और पोस्ट के साथ आगे काम करते हुए, FKBlogId को प्रोग्राम द्वारा ब्लॉग पर वापस इंगित करने वाली विदेशी कुंजी के रूप में कभी नहीं माना जाएगा।

धाराप्रवाह एपीआई का उपयोग करके, आप इस समस्या को भी हल कर सकते हैं - ब्लॉग के संबंध में FKBlogId को एक विदेशी कुंजी के रूप में लें।

स्थापित करते समय, आपको रिश्ते के दोनों सिरों को निर्दिष्ट करना होगा - ब्लॉग पर एक संपत्ति जिसमें कई रिश्ते (पोस्ट) और एक पोस्ट संपत्ति है जो उसके माता-पिता (ब्लॉग) को इंगित करती है।

सबसे पहले, आपको WithMany विधि को जोड़ने की आवश्यकता है, जो आपको यह निर्दिष्ट करने की अनुमति देता है कि किस ब्लॉग गुण में एक से अधिक संबंध हैं।

 modelBuilder.Entity<Post>().HasRequired(p => p.Blog) .WithMany(b => b.Posts) 

फिर आप HasForeignKey विधि जोड़ सकते हैं, जो इंगित करता है कि कौन सी पोस्ट संपत्ति विदेशी कुंजी है और ब्लॉग पर वापस इंगित करती है। पूर्ण कोड:

 modelBuilder.Entity<Post>().HasRequired(p => p.Blog) .WithMany(b => b.Posts) .HasForeignKey(p => p.FKBlogId); 

अब कोड फर्स्ट डेटाबेस स्कीमा और रिश्तों के सही निर्माण के लिए सभी आवश्यक डेटा एकत्र कर सकता है, जिसे डेवलपर सुझाव देता है।

एक स्प्रेडशीट स्कीमा और कई-से-कई संबंध परिभाषित करना

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

नया टैग वर्ग:

 public class Tag { public int TagId{ get; set; } public string Name { get; set; } public ICollection<Post> Posts { get; set; } } 

पोस्ट क्लास में जोड़ने के लिए नई संपत्ति:

 public ICollection<Tag> Tags { get; set; } 

कोड पहले मानता है कि फैले टेबल के नाम में दो वर्गों के नामों का एक संयोजन शामिल होगा, और तालिका में विदेशी कुंजी शामिल होगी जिनके नाम वर्ग नाम और कुंजी नाम के संयोजन से मिलकर बने। इस मामले में, हम Post.Id और Tag.TagId के साथ काम कर रहे हैं। यदि आप कोड को पहले स्वयं मिडलवेयर तालिका बनाते हैं, तो यह इस तरह दिखाई देगा:



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

एक उदाहरण पर विचार करें जब आपको तीन नामों को निर्दिष्ट करने की आवश्यकता होती है। तालिका का नाम PostJoinTag और कॉलम का नाम TagId और PostId होना चाहिए।

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

 modelBuilder.Entity<Post>() .HasMany(p => p.Tags) .WithMany(t => t.Posts) .Map(mc => { mc.ToTable("PostJoinTag"); mc.MapLeftKey("PostId"); mc.MapRightKey("TagId"); }); 

बाएं और दाएं मैपिंग कुंजी (MapLeftKey, MapRightKey) का निर्धारण करते समय आपको ध्यान देने की आवश्यकता है। बाईं ओर प्रथम श्रेणी की कुंजी है जिसे आपने इंगित किया है, अर्थात्, पोस्ट, और दाईं दूसरी कक्षा है। यदि आप उन्हें स्वैप करते हैं, तो डेटा को सही ढंग से सहेजा नहीं जाएगा, जिससे ज्ञात नकारात्मक परिणाम होंगे।

निष्कर्ष

आप कोड पहले धाराप्रवाह एपीआई का उपयोग कर रिश्तों का वर्णन करने की कुछ विशेषताओं से परिचित हो जाते हैं। अन्य मैपिंग हैं जिन्हें अलग से या संयोजन में उपयोग किया जा सकता है। कुछ निरर्थक या भ्रामक लग सकते हैं, जैसे कि IsRequired और HasRequired या WithMany और HasMany। हालांकि, आपने उन कार्यों को देखा होगा जिनके लिए उनमें से प्रत्येक जिम्मेदार है, साथ ही साथ उनका उपयोग करने के लाभ भी हैं।

आप MSDN पर या इकाई फ्रेमवर्क टीम ब्लॉग पर इकाई फ़्रेमवर्क के बारे में अधिक पढ़ सकते हैं।