डेटा मैपिंग एप्लीकेशन कोड को लेयर्स में अलग करने का एक तरीका है। एंड्रॉइड एप्लिकेशन में मैपिंग का व्यापक रूप से उपयोग किया जाता है। मोबाइल एप्लिकेशन Android- CleanArchitecture की वास्तुकला का एक लोकप्रिय उदाहरण मूल संस्करण ( CleanArchitecture से मैपर का उदाहरण ) और नए Kotlin संस्करण ( एक मैपर का उदाहरण ) दोनों में मैपिंग का उपयोग करता है।

मैपिंग से आप एप्लिकेशन की परतों को खोल सकते हैं (उदाहरण के लिए, एपीआई से छुटकारा पा सकते हैं), सरल करें और कोड को अधिक दृश्य बनाएं।

चित्र में उपयोगी मानचित्रण का एक उदाहरण दिखाया गया है:

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

चलो Source परत से Destination परत मॉडल तक दो Person और Salary मॉडल को परिवर्तित करने के उदाहरण का उपयोग करके डेटा मैपिंग के सुविधाजनक और व्यावहारिक तरीकों पर विचार करें।

उदाहरण के लिए, मॉडल सरल किए जाते हैं। Person के आवेदन की दोनों परतों में Salary शामिल है।

इस कोड में, यदि आपके पास एक ही मॉडल है, तो यह एप्लिकेशन की परतों को संशोधित करने और मैपिंग का उपयोग न करने के लायक हो सकता है।

विधि # 1: मैपर तरीके

एक उदाहरण:

 class PersonSrc( private val name: String, private val salary: SalarySrc ) { fun mapToDestination() = PersonDst( name, salary.mapToDestination() //    Salary ) } class SalarySrc( private val amount: Int ) { fun mapToDestination() = SalaryDst(amount) } 

सबसे तेज और आसान विधि। यह वह है जो CleanArchitecture Kotlin ( मानचित्रण का एक उदाहरण ) में उपयोग किया जाता है।

एक प्लस खेतों को छिपाने की क्षमता है। PersonSrc में फ़ील्ड्स private हो सकते हैं, जो कोड PersonSrc वर्ग का उपयोग करता है, PersonSrc से स्वतंत्र है, जिसका अर्थ है कि कोड जुटना कम हो गया है।

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

हालांकि, यह विकल्प परीक्षण करने के लिए कठिन है। PersonSrc वर्ग के मैपर विधि में मैपर विधि SalarySrc लिए PersonSrc कॉल PersonSrc । इसलिए Salary मैपिंग के बिना केवल Person मैपिंग का परीक्षण कठिन होगा। इसके लिए आपको मोकी का इस्तेमाल करना होगा।

एक और समस्या उत्पन्न हो सकती है, अगर वास्तुकला की आवश्यकताओं के अनुसार, आवेदन परतें एक दूसरे के बारे में नहीं जान सकती हैं: अर्थात्। किसी लेयर के Src वर्ग में, आप Dst लेयर के साथ काम नहीं कर सकते हैं और इसके विपरीत। इस स्थिति में, मैपिंग के इस संस्करण का उपयोग नहीं किया जा सकता है।

माना गया उदाहरण में, Src परत Dst परत पर निर्भर है और इस परत की कक्षाएं बना सकती है। विपरीत परिस्थिति के लिए (जब Dst Src पर निर्भर है), स्थैतिक फैक्टरी विधियों के साथ विकल्प उपयुक्त है:

 class PersonDst( private val name: String, private val salary: SalaryDst ) { companion object { fun fromSource( src: PersonSrc ) = PersonDst(src.name, SalaryDst.fromSource(src.salary)) } } class SalaryDst( private val amount: Int ) { companion object { fun fromSource(src: SalarySrc) = SalaryDst(src.amount) } } 

मैपिंग Dst परत के वर्गों के अंदर है, जिसका अर्थ है कि ये कक्षाएं उनके गुणों और संरचना को उन सभी कोड को प्रकट नहीं करती हैं जो उनका उपयोग करते हैं।

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

मानचित्रण विधि सारांश:

+ जल्दी से कोड लिखें, मैपिंग हमेशा हाथ में है
+ आसान संशोधन
+ कम कोड कनेक्टिविटी
- कठिन इकाई परीक्षण (मोकी आवश्यक)
- वास्तुकला द्वारा हमेशा अनुमति नहीं है

विधि 2: मैपर फ़ंक्शंस

मॉडल:

 class PersonSrc( val name: String, val salary: SalarySrc ) class SalarySrc(val amount: Int) class PersonDst( val name: String, val salary: SalaryDst ) class SalaryDst(val amount: Int) 

मानचित्रकारों:

 fun mapPerson( src: PersonSrc, salaryMapper: (SalarySrc) -> SalaryDst = ::mapSalary //  - ) = PersonDst( src.name, salaryMapper.invoke(src.salary) ) fun mapSalary(src: SalarySrc) = SalaryDst(src.amount) 

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

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

इस मैपिंग विधि के लिए आवश्यक है कि क्लास डेटा वाली सभी प्रॉपर्टी मैपर को दिखाई दे, अर्थात private दृश्यता का उपयोग नहीं किया जा सकता है।

मानचित्रण विधि सारांश:

+ सरल इकाई परीक्षण
- कठिन संशोधन
- डेटा वर्गों के लिए खुले क्षेत्रों की आवश्यकता है

विधि 3: एक्सटेंशन फ़ंक्शंस

मानचित्रकारों:

 fun PersonSrc.toDestination( salaryMapper: (SalarySrc) -> SalaryDst = SalarySrc::toDestination ): PersonDst { return PersonDst(this.name, salaryMapper.invoke(this.salary)) } fun SalarySrc.toDestination(): SalaryDst { return SalaryDst(this.amount) } 

सामान्य तौर पर, मैपर फ़ंक्शन के समान होता है, लेकिन मैपर कॉल का सिंटैक्स सरल होता है: .toDestination() ।

यह ध्यान दिया जाना चाहिए कि विस्तार कार्यों से उनके स्थिर स्वभाव के कारण अप्रत्याशित व्यवहार हो सकता है: https://kotlinlang.org/docs/reference/extensions.html#extensions-are-resolved-stively

मानचित्रण विधि सारांश:

+ सरल इकाई परीक्षण
- कठिन संशोधन
- डेटा वर्गों के लिए खुले क्षेत्रों की आवश्यकता है

विधि 4: इंटरफ़ेस के साथ मैपर क्लासेस

फ़ंक्शन के उदाहरणों में एक खामी है। वे आपको किसी भी फ़ंक्शन का उपयोग एक हस्ताक्षर (SalarySrc) -> SalaryDst साथ करने की अनुमति देते हैं। Mapper<SRC, DST> इंटरफ़ेस की उपस्थिति कोड को अधिक स्पष्ट बनाने में मदद करेगी।

एक उदाहरण:

 interface Mapper<SRC, DST> { fun transform(data: SRC): DST } class PersonMapper( private val salaryMapper: Mapper<SalarySrc, SalaryDst> ) : Mapper<PersonSrc, PersonDst> { override fun transform(src: PersonSrc) = PersonDst( src.name, salaryMapper.transform(src.salary) ) } class SalaryMapper : Mapper<SalarySrc, SalaryDst> { override fun transform(src: SalarrSrc) = SalaryDst( src.amount ) } 

इस उदाहरण में, SalaryMapper एक PersonMapper निर्भरता है। यह आपको यूनिट परीक्षणों के लिए Salary मैपर को आसानी से बदलने की अनुमति देता है।

फ़ंक्शन में मैपिंग के बारे में, इस उदाहरण में केवल एक दोष है - थोड़ा और कोड लिखने की आवश्यकता।

मानचित्रण विधि सारांश:

+ बेहतर टाइपिंग
- अधिक कोड

मैपर कार्यों की तरह:

+ सरल इकाई परीक्षण
- कठिन संशोधन
- डेटा वर्गों के लिए खुले क्षेत्रों की आवश्यकता है

विधि 5: परावर्तन

काले जादू की विधि। अन्य मॉडलों पर इस पद्धति पर विचार करें।

मॉडल:

 data class EmployeeSrc( val firstName: String, val lastName: String, val age: Int //    ) data class EmployeeDst( val name: String, //  ,    val age: Int //    ) 

मैपर:

 fun EmployeeSrc.mapWithRef() = with(::EmployeeDst) { val propertiesByName = EmployeeSrc::class.memberProperties.associateBy { it.name } callBy(parameters.associateWith { parameter -> when (parameter.name) { EmployeeDst::name.name -> "$firstName $lastName" //    name else -> propertiesByName[parameter.name]?.get(this@mapWithRef) //     } }) } 

एक उदाहरण यहाँ जासूसी है ।

इस उदाहरण में, EmployeeSrc और EmployeeDst विभिन्न स्वरूपों में नाम संग्रहीत करते हैं। मैपर को केवल नए मॉडल के लिए एक नाम बनाने की आवश्यकता है। शेष फ़ील्ड स्वचालित रूप से संसाधित किए जाते हैं, कोड लिखे बिना ( else विकल्प when )।

विधि उपयोगी हो सकती है, उदाहरण के लिए, यदि आपके पास खेतों के एक समूह के साथ बड़े मॉडल हैं और फ़ील्ड मूल रूप से विभिन्न परतों के लिए एक ही मॉडल के लिए मेल खाते हैं।

उदाहरण के लिए, एक बड़ी समस्या उत्पन्न होगी, यदि आप Dst में आवश्यक फ़ील्ड जोड़ते हैं और यह Src या दुर्घटना में मैपर में नहीं होता है: क्रम में एक IllegalArgumentException । प्रतिबिंब में प्रदर्शन के मुद्दे भी हैं।

मानचित्रण विधि सारांश:

+ कम कोड
+ सरल इकाई परीक्षण
- खतरनाक
- प्रदर्शन पर प्रतिकूल प्रभाव डाल सकता है

निष्कर्ष

इस तरह के निष्कर्ष हमारे विचार से लिए जा सकते हैं:

मैपर विधियाँ - स्पष्ट कोड, लिखने और बनाए रखने के लिए तेज़

मैपर फ़ंक्शंस और एक्सटेंशन फ़ंक्शंस - बस टेस्ट मैपिंग।

इंटरफ़ेस के साथ मैपर कक्षाएं - बस मैपिंग और क्लियर कोड का परीक्षण करें।

प्रतिबिंब - गैर-मानक स्थितियों के लिए उपयुक्त।