वेबिनार "एक डेटा सत्यापन उपकरण के रूप में धाराप्रवाह सत्यापन"

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

---

सत्यापन क्यों आवश्यक है?

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

धाराप्रवाह सत्यापन उपकरण के रूप में, उनका ज्ञान हमें इसकी अनुमति देगा:

• डेटा सत्यापन से संबंधित कार्यों को हल करते समय समय की बचत करें;
• एक ही रूप में बिखरे हुए घर-निर्मित चेक को लाने के लिए;
• सहकर्मियों को कॉफी सत्यापन का अपना ज्ञान दिखाएं :)

लेकिन यह सब सिद्धांत है, चलो अभ्यास करने के लिए बेहतर है।

केस स्टडी वैलिडेशन: इंटरएक्टिव

तो, C # में सत्यापन का व्यावहारिक कार्यान्वयन निम्नानुसार है:



हमारे पास एक वर्ग ग्राहक है, जिसके पास खेतों का सबसे सरल सेट है: FirstName - नाम, LastName - अंतिम नाम, आयु - आयु। और एक निश्चित CustomerManager वर्ग है जो बचाता है, जैसा कि हम देखते हैं, एक नया उपयोगकर्ता (खरीदार) CustomerRepository में है और ग्राहक को सफलतापूर्वक जोड़े गए कंसोल के लिए जानकारी प्रदर्शित करता है।

आइए एक कस्टम जोड़ने का प्रयास करें और एक प्रबंधक जो कस्टम का प्रबंधन करेगा:

void Main() { var customer = new Customer { FirstName = " ", LastName = "", Age = 57, }; var manager = new CustomerManager(); manager.Add(customer); } 

निष्पादन का परिणाम निम्न पाठ के कंसोल में आउटपुट होगा:

.

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

 { FirstName = "+79123456789", LastName = "valde@mar.ru", Age = -14, }; 

नतीजतन, हम देखेंगे कि एक अनौपचारिक डेटा सेट के साथ एक कस्टम मीटर भी जोड़ा जाएगा:

+79123456789 valde@mar.ru .

स्वाभाविक रूप से, हम अपने रिपॉजिटरी में ऐसा डेटा नहीं रखना चाहते हैं। हम अपनी रक्षा कैसे करें? सबसे आसान विकल्प एक त्रुटि वापस करना है यदि, उदाहरण के लिए, हमारे पास सभी वर्ण - अक्षर नहीं हैं। ऐसा करने के लिए, हम अगर का उपयोग करके FirstName के लिए शर्त निर्धारित करते हैं, और यदि शर्त पूरी नहीं होती है, तो हम फ़ंक्शन का उपयोग रोक देते हैं और कंसोल पर "नाम में त्रुटि" संदेश प्रदर्शित करते हैं। हम लास्टनेम के साथ भी ऐसा ही करते हैं। आयु के अनुसार, यहां हम संख्याओं की श्रेणी की जाँच करते हैं, उदाहरण के लिए:

if (customer.Age < 14 || customer.Age > 180)

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

वैसे भी, उपरोक्त संचालन करने के बाद, हमें ifs का एक गुच्छा और कोड की एक बड़ी शीट मिलती है। बाहरी डेवलपर के लिए ऐसे कोड को समझना आसान नहीं होगा। क्या करें?

जोड़ने धाराप्रवाह मान्यता है

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

परिणामस्वरूप, हमारा अंतिम कोड इस तरह दिखाई देगा:

 void Main() { var customer = new Customer { FirstName = "Alex2", LastName = "Petrov1", Age = 10, Phone = "+791234567893", Email = "adsf@fadsf3.com" }; var manager = new CustomerManager(); manager.Add(customer); } class Customer { public string FirstName { get; set; } public string LastName { get; set; } public int Age { get; set; } public string Phone { get; set; } public string Email { get; set; } } class CustomerManager { CustomerRepository _repository; CustomerValidator _validator; public CustomerManager() { _repository = new CustomerRepository(); _validator = new CustomerValidator(); } public void Add(Customer customer) { if (!ValidateCustomer(customer)) { return; } _repository.Add(customer); Console.WriteLine($" {customer.FirstName} {customer.LastName}  ."); } private bool ValidateCustomer(Customer customer) { var result = _validator.Validate(customer); if (result.IsValid) { return true; } foreach(var error in result.Errors) { Console.WriteLine(error.ErrorMessage); } return false; } } class CustomerValidator : AbstractValidator<Customer> { public CustomerValidator() { var msg = "   {PropertyName}:  {PropertyValue}"; RuleFor(c => c.FirstName) .Must(c => c.All(Char.IsLetter)).WithMessage(msg); RuleFor(c => c.LastName) .Must(c => c.All(Char.IsLetter)).WithMessage(msg); RuleFor(c => c.Age) .GreaterThan(14).WithMessage(msg) .LessThan(180).WithMessage(msg); RuleFor(c => c.Phone) .Must(IsPhoneValid).WithMessage(msg) .Length(12).WithMessage("    {MinLength}  {MaxLength}.  : {TotalLength}"); RuleFor(c => c.Email) .NotNull().WithMessage(msg) .EmailAddress(); } private bool IsPhoneValid(string phone) { return !(!phone.StartsWith("+79") || !phone.Substring(1).All(c => Char.IsDigit(c))); } } class CustomerRepository { Random _random; public CustomerRepository() { _random = new Random(); } public void Add(Customer customer) { var sleepInSeconds = _random.Next(2, 7); Thread.Sleep(1000 * sleepInSeconds); } } 

और थोड़ा और सिद्धांत

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

"एक द्रव इंटरफ़ेस एक वस्तु-उन्मुख एपीआई को लागू करने का एक तरीका है जिसमें विधियाँ उसी इंटरफ़ेस को वापस करती हैं जिस पर उन्हें बुलाया गया था।"
एलेक्सी यागुर

पुस्तकालय के लिए ही, इसमें निम्नलिखित घटक शामिल हैं :

1. मूल तर्क । यहाँ GitHub का लिंक दिया गया है जहाँ आप मुख्य तर्क देख सकते हैं।
2. सहायक तर्क । FluentValidation.ValidatorAttribute इस तर्क के लिए जिम्मेदार है।
3. प्रसंग संवेदनशील अंग । FluentValidation.AspNetCore , FluentValidation.Mvc5 और FluentValidation.WebApi देखें ।
4. टेस्ट । तदनुसार, हम FluentValidation.Tests.AspNetCore , FluentValidation.Tests.Mvc5 , FluentValidation.Tests.WebApi और FluentValidation.Tests में रुचि रखते हैं।

यह सब, कोड लिखने में कदम दर कदम, वीडियो देखें। इसके अलावा, आपको "त्रुटि ग्रंथों में चर" विषय पर अतिरिक्त इंटरैक्टिव में दिलचस्पी हो सकती है, जिसे शिक्षक ने वेबिनार के अंत के पास रखा था।

सी # डेवलपर कोर्स में मिलते हैं!