ट्यूटोरियल: सी # 8.0 में डिफ़ॉल्ट इंटरफ़ेस सदस्यों के साथ अपडेट इंटरफेस

.NET कोर 3.0 पर C # 8.0 के साथ शुरू, आप एक इंटरफ़ेस को सदस्य घोषित करते समय एक कार्यान्वयन को परिभाषित कर सकते हैं। सबसे आम परिदृश्य सुरक्षित रूप से पहले से ही जारी किए गए और उपयोग किए जाने वाले इंटरफ़ेस के सदस्यों को सुरक्षित रूप से जोड़ना है।

इस ट्यूटोरियल में, आप सीखेंगे कि कैसे:

• कार्यान्वयन के साथ तरीकों को जोड़कर इंटरफेस को सुरक्षित रूप से बढ़ाएं।
• अधिक से अधिक लचीलापन प्रदान करने के लिए मानकीकृत कार्यान्वयन बनाएँ।
• ओवरराइड के रूप में अधिक विशिष्ट कार्यान्वयन प्रदान करने के लिए कार्यान्वयनकर्ताओं को सक्षम करें।

आवश्यक शर्तें

आपको C # 8.0 पूर्वावलोकन संकलक सहित .NET कोर को चलाने के लिए अपनी मशीन स्थापित करने की आवश्यकता होगी। C # 8.0 पूर्वावलोकन कंपाइलर विजुअल स्टूडियो 2019 , या नवीनतम .NET कोर 3.0 पूर्वावलोकन एसडीके के साथ उपलब्ध है । डिफ़ॉल्ट इंटरफ़ेस सदस्य .NET कोर 3.0 पूर्वावलोकन 4 के साथ शुरुआत में उपलब्ध हैं।

परिदृश्य अवलोकन

यह ट्यूटोरियल ग्राहक संबंध लाइब्रेरी के संस्करण 1 से शुरू होता है। आप GitHub पर हमारे नमूने रेपो पर स्टार्टर आवेदन प्राप्त कर सकते हैं। इस लाइब्रेरी का निर्माण करने वाली कंपनी ने मौजूदा एप्लिकेशन वाले ग्राहकों को अपनी लाइब्रेरी को अपनाने का लक्ष्य दिया था। उन्होंने अपने लाइब्रेरी के उपयोगकर्ताओं को कार्यान्वित करने के लिए न्यूनतम इंटरफ़ेस परिभाषाएँ प्रदान कीं।

public interface ICustomer { IEnumerable<IOrder> PreviousOrders { get; } DateTime DateJoined { get; } DateTime? LastOrder { get; } string Name { get; } IDictionary<DateTime, string> Reminders { get; } } 

उन्होंने एक दूसरे इंटरफ़ेस को परिभाषित किया जो एक आदेश का प्रतिनिधित्व करता है:

 public interface IOrder { DateTime Purchased { get; } decimal Cost { get; } } 

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

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

इस कार्यक्षमता को जोड़ने का सबसे प्राकृतिक तरीका है किसी भी वफादारी छूट को लागू करने के लिए एक विधि के साथ ICustomer इंटरफ़ेस को बढ़ाना। इस डिज़ाइन सुझाव ने अनुभवी डेवलपर्स के बीच चिंता पैदा कर दी: "एक बार रिलीज़ होने के बाद इंटरफेस अपरिवर्तनीय हैं! यह एक ब्रेकिंग चेंज है! ” इंटरफ़ेस को अपग्रेड करने के लिए C # 8.0 डिफ़ॉल्ट इंटरफ़ेस कार्यान्वयन जोड़ता है। लाइब्रेरी लेखक इंटरफ़ेस में नए सदस्य जोड़ सकते हैं और उन सदस्यों के लिए एक डिफ़ॉल्ट कार्यान्वयन प्रदान कर सकते हैं।

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

डिफ़ॉल्ट इंटरफ़ेस सदस्यों के साथ अपग्रेड करें

टीम सबसे संभावित डिफ़ॉल्ट कार्यान्वयन पर सहमत हुई: ग्राहकों के लिए एक वफादारी छूट।

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

सबसे पहले, कार्यान्वयन के लिए नई विधि जोड़ें:

 // Version 1: public decimal ComputeLoyaltyDiscount() { DateTime TwoYearsAgo = DateTime.Now.AddYears(-2); if ((DateJoined < TwoYearsAgo) && (PreviousOrders.Count() > 10)) { return 0.10m; } return 0; } 

पुस्तकालय लेखक ने कार्यान्वयन की जांच करने के लिए पहला परीक्षण लिखा:

 SampleCustomer c = new SampleCustomer("customer one", new DateTime(2010, 5, 31)) { Reminders = { { new DateTime(2010, 08, 12), "childs's birthday" }, { new DateTime(1012, 11, 15), "anniversary" } } }; SampleOrder o = new SampleOrder(new DateTime(2012, 6, 1), 5m); c.AddOrder(o); o = new SampleOrder(new DateTime(2103, 7, 4), 25m); c.AddOrder(o); // Check the discount: ICustomer theCustomer = c; Console.WriteLine($"Current discount: {theCustomer.ComputeLoyaltyDiscount()}"); 

परीक्षण के निम्नलिखित भाग पर ध्यान दें:

 // Check the discount: ICustomer theCustomer = c; Console.WriteLine($"Current discount: {theCustomer.ComputeLoyaltyDiscount()}"); 

SampleCustomer से SampleCustomer तक ICustomer करना आवश्यक है। SampleCustomer वर्ग को SampleCustomer लिए एक कार्यान्वयन प्रदान करने की आवश्यकता नहीं है; यह ICustomer इंटरफ़ेस द्वारा प्रदान किया गया है। हालाँकि, SampleCustomer वर्ग अपने इंटरफ़ेस से सदस्यों को इनहेरिट नहीं करता है। वह नियम नहीं बदला है। इंटरफ़ेस में घोषित और कार्यान्वित किसी भी विधि को कॉल करने के लिए, चर को इस उदाहरण में इंटरफ़ेस का प्रकार, ICustomer होना चाहिए।

मानकीकरण प्रदान करें

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

 // Version 2: public static void SetLoyaltyThresholds( TimeSpan ago, int minimumOrders = 10, decimal percentageDiscount = 0.10m) { length = ago; orderCount = minimumOrders; discountPercent = percentageDiscount; } private static TimeSpan length = new TimeSpan(365 * 2, 0,0,0); // two years private static int orderCount = 10; private static decimal discountPercent = 0.10m; public decimal ComputeLoyaltyDiscount() { DateTime start = DateTime.Now - length; if ((DateJoined < start) && (PreviousOrders.Count() > orderCount)) { return discountPercent; } return 0; } 

उस छोटे कोड के टुकड़े में कई नई भाषा क्षमताएं दिखाई गई हैं। इंटरफेस अब स्थिर सदस्यों को शामिल कर सकते हैं, जिसमें फ़ील्ड और विधियाँ शामिल हैं। अलग-अलग एक्सेस मॉडिफायर भी सक्षम हैं। अतिरिक्त क्षेत्र निजी हैं, नई विधि सार्वजनिक है। इंटरफ़ेस सदस्यों में से किसी भी संशोधक की अनुमति है।

वफादारी छूट की गणना के लिए सामान्य सूत्र का उपयोग करने वाले अनुप्रयोग, लेकिन विभिन्न मापदंडों, एक कस्टम कार्यान्वयन प्रदान करने की आवश्यकता नहीं है; वे एक स्थिर विधि के माध्यम से तर्क निर्धारित कर सकते हैं। उदाहरण के लिए, निम्न कोड एक "ग्राहक प्रशंसा" सेट करता है जो किसी भी ग्राहक को एक महीने से अधिक की सदस्यता प्रदान करता है:

 ICustomer.SetLoyaltyThresholds(new TimeSpan(30, 0, 0, 0), 1, 0.25m); Console.WriteLine($"Current discount: {theCustomer.ComputeLoyaltyDiscount()}"); 

डिफ़ॉल्ट कार्यान्वयन बढ़ाएँ

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

एक स्टार्टअप पर विचार करें जो नए ग्राहकों को आकर्षित करना चाहता है। वे नए ग्राहक के पहले ऑर्डर पर 50% की छूट देते हैं। अन्यथा, मौजूदा ग्राहकों को मानक छूट मिलती है। लाइब्रेरी लेखक को डिफ़ॉल्ट कार्यान्वयन को एक protected static विधि में स्थानांतरित करने की आवश्यकता है ताकि इस इंटरफ़ेस को लागू करने वाला कोई भी वर्ग उनके कार्यान्वयन में कोड का पुन: उपयोग कर सके। इंटरफ़ेस सदस्य का डिफ़ॉल्ट कार्यान्वयन इस साझा विधि को भी कॉल करता है:

 public decimal ComputeLoyaltyDiscount() => DefaultLoyaltyDiscount(this); protected static decimal DefaultLoyaltyDiscount(ICustomer c) { DateTime start = DateTime.Now - length; if ((c.DateJoined < start) && (c.PreviousOrders.Count() > orderCount)) { return discountPercent; } return 0; } 

इस इंटरफ़ेस को लागू करने वाले वर्ग के कार्यान्वयन में, ओवरराइड स्थिर सहायक विधि को कॉल कर सकता है, और "नया ग्राहक" छूट प्रदान करने के लिए उस तर्क का विस्तार कर सकता है:

 public decimal ComputeLoyaltyDiscount() { if (PreviousOrders.Any() == false) return 0.50m; else return ICustomer.DefaultLoyaltyDiscount(this); } 

आप हमारे [GitHub पर सैंपल रेपो] में पूरा तैयार कोड देख सकते हैं (आप GitHub पर हमारे सैंपल रेपो पर स्टार्टर एप्लिकेशन प्राप्त कर सकते हैं।

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