सुपर सरल iOS JSON मैपर

हर कोई जो कम से कम एक बार आईओएस के लिए एक क्लाइंट-सर्वर एप्लिकेशन लिखता है, एक तरह से या किसी अन्य, वस्तुओं में मैपिंग जोंस / एक्सएमएल / अन्य के साथ सामना किया गया था। कभी-कभी यह मुश्किल हो सकता है, कभी-कभी आप सिर्फ शब्दकोशों के साथ काम करना चाहते हैं, रेस्टकिट जैसे पहले से ही कई तैयार समाधान हैं, जो सामान्य रूप से सभी अवसरों के लिए एक सार्वभौमिक संयोजन है, इसलिए दूसरी बाइक क्यों लिखें?

इसके कई कारण हो सकते हैं, उनमें से कई, जिन्होंने मुझे अपना खुद का मिनी-मैपर लिखा है:

• मैं कुछ बड़े और जटिल काम नहीं करना चाहता;
• मुझे केवल एक मैपर की आवश्यकता है, बिना अतिरिक्त माल के जैसे कि नेटवर्क के साथ काम करना या कोर डेटा के साथ एकीकरण करना;
• यदि फ्रेमवर्क मेरे इच्छित तरीके से काम नहीं करता है, तो अक्सर इसे समझने और ठीक करने के लिए एक वास्तविक सिरदर्द बन जाता है, खासकर यदि परियोजना का चरण प्रारंभिक एक से दूर है और यह फ्रेमवर्क को छोड़ने के लिए समस्याग्रस्त है;
• मुझे परियोजना में 3 स्क्रीन के लिए एक और 50 वर्गों और 4 एमबी वजन के लिए एक फ्रेमवर्क की आवश्यकता नहीं है;
• हमेशा उसका प्रिय।

सबसे पहले, गिटहब का एक लिंक , जहां हमारे भविष्य के मॉडल के लिए आधार वर्ग का स्रोत कोड है और मैपर का उपयोग करके एक उदाहरण परियोजना है।

प्रशंसा करने से पहले या कुछ और, मैं विपक्ष का वर्णन करूंगा:

• हर json ऑब्जेक्ट के लिए, कोई फर्क नहीं पड़ता कि यह कितना छोटा है, आपको एक ऑब्जेक्टिव-सी क्लास बनाना होगा (हालाँकि शायद एक प्लस है?);
• कोई इनपुट चेक नहीं हैं;
• डेवलपर की चौकसी, कुछ चीज़ों की जाँच नहीं की जाती है (आपको कस्टम ऑब्जेक्ट्स की एक सरणी को मैप करने की आवश्यकता है, लेकिन यह संकेत नहीं दिया जाता है कि यह किस वर्ग के लिए मैप करेगा);
• कुछ और साबित करता है कि मैपर बिल्कुल गलत है और आप इसे किसी भी मामले में उपयोग नहीं कर सकते हैं, जो निश्चित रूप से टिप्पणियों में उचित होगा।

प्लसस में से - उपयोग में आसान, आकार में छोटा और कक्षाओं की संख्या में, जिस स्थिति में आपको इसे समझना है, वह अपना काम करता है।

उसके साथ कैसे काम करना है? मैपर में एक वर्ग होता है - टाइनीमैपिंगमॉडल, यह मॉडल के सभी बाद के वर्गों के लिए आधार वर्ग है। प्रत्येक json ऑब्जेक्ट के लिए, एक TinyMappingModel वंशज बनाया जाता है, जिसमें आवश्यक डेटा संग्रहीत करने के लिए गुण होने चाहिए। आदर्श मामले में, आपको उन्हें उसी तरह से कॉल करना चाहिए जैसे कि जोन में संबंधित फ़ील्ड्स को कहा जाता है - फिर मैपिंग स्वयं से होगी, जैसे कि जादू (केवीसी) द्वारा, ऐसे मामलों के बारे में जब यह असंभव है (उदाहरण के लिए, नाम im, नाम, आईडी, 1 कार्य के साथ एक फ़ील्ड) ), मैं नीचे लिखूंगा।

TinyMappingModel में 4 विधियाँ शामिल हैं:

//public + (instancetype)mapObjectFromDictionary:(NSDictionary *)data; + (NSArray *)mapArrayOfObjects:(NSArray *)data; //protected methods - (NSDictionary *)keyToClassMappingRules; - (NSDictionary *)keyToPropertyNameReplacementRules; 

यदि आवश्यक हो तो वारिस अंतिम दो को फिर से परिभाषित करना चाहिए।

- (NS सहारे *) keyToClassMappingRules; - यदि हमें कुछ कस्टम वर्ग (TinyMappingModel वंशज) या एक सरणी के लिए jSON ऑब्जेक्ट को मैप करने की आवश्यकता है तो इसे फिर से परिभाषित किया जाए। विधि को कुंजी-फ़ील्ड नाम जोड़ी के साथ शब्दकोष में वापस करना चाहिए, मान वह वर्ग है जिसमें ऑब्जेक्ट मैप करेगा, या, एक संग्रह के मामले में, संग्रह में किन वस्तुओं का समावेश होगा। उदाहरण के लिए:

 - (NSDictionary *)keyToClassMappingRules { return @{@"im:name":[TitleModel class], @"im:image":[ImageModel class]}; } 

- (NS सहारे *) keyToPropertyNameReplacementRules; - यदि हम किसी कारण से क्लास में प्रॉपर्टी का नाम उसी तरह से नहीं रख सकते हैं, जिस तरह से इसे json में कहा जाता है, तो हम इसे फिर से परिभाषित कर सकते हैं। Json में फ़ील्ड का नाम कुंजी है, मूल्य वर्ग में संपत्ति का नाम है, उदाहरण के लिए:

 - (NSDictionary *)keyToPropertyNameReplacementRules { return @{@"im:name":@"name",@"im:image":@"images"}; } 

उदाहरण से दिए गए तरीकों में से दो केवल एक ही होगा जो कार्यान्वयन में लागू करने के लिए न्यूनतम आवश्यक है। हमारी कक्षा के शीर्षक में (जैसे EntryModel) होगा:

 @class TitleModel; @interface EntryModel : TinyMappingModel @property (nonatomic, strong) TitleModel *name; @property (nonatomic, strong) NSArray *images; @end 

नाम के साथ, सब कुछ स्पष्ट है, ImageModel प्रकार की वस्तुओं को चित्र सरणी में संग्रहीत किया जाएगा, और निश्चित रूप से, आपको कार्यान्वयन में आवश्यक कक्षाएं आयात करने की आवश्यकता है (इस मामले में ImageModel और TitleModel), आप निश्चित रूप से, इसे लाइनों पर कर सकते हैं, और फिर NSClassFromString, लेकिन नहीं। ।

अगला, आप कैसे काम करते हैं? जब हमने नेटवर्क से डेटा प्राप्त किया और किसी तरह इसे json में बदल दिया (उदाहरण के लिए, मैं अक्सर छोटी परियोजनाओं में AFNetworking का उपयोग करता हूं), तो यह है:

 //data - NSDictionary c json EntryModel *model= [EntryModel mapObjectFromDictionary:data]; // data - NSArray EntryModel *modelArray= [EntryModel mapArrayOfObjects:data]; 

विविधताएं संभव हैं। मुख्य बात सही वस्तु को सही विधि से पारित करना है, यह इसे पता लगाएगा, कुछ भी जटिल नहीं है।

संक्षेप में, मैं वर्णन करूँगा कि मैपर कैसे काम करता है।
सबसे महत्वपूर्ण विधि + (इंस्टेंटाइप) mapObjectFromDictionary: (NS सहकर्मी *) डेटा, यह अनिवार्य रूप से सभी काम करता है - यह एक भविष्य का मॉडल बनाता है, json कुंजियों पर पुनरावृत्त करता है, यह तय करता है कि हम क्या मैप करेंगे (वर्ग) - जो हमारे पास keyToClassMappingRules में है। और किस नाम की संपत्ति है - यह KeyToPropertyNameReplacementRules पर निर्भर करता है)। इसके अलावा, इस बात पर निर्भर करता है कि वर्तमान कुंजी के लिए डेटा क्या हैं और हम इसमें क्या मैप करेंगे, घटनाओं के विकास के तीन तरीके हैं:

• डेटा सरणी - mapArrayOfObjects को मैपमैप क्लास में बुलाया जाएगा, और परिणाम संबंधित संपत्ति पर सेट किया जाएगा;
• डेटा ऑब्जेक्ट - mapObjectFromDictionary (एक ही विधि, लेकिन एक अलग वर्ग, -TTTClClassMappingRules से वर्ग), जिसमें हम मैप करते हैं, और परिणाम संबंधित संपत्ति पर सेट किया जाएगा;
• आदिम डेटा (NSString, NSNumber etc) और keyToPropertyNameReplacementRules इस कुंजी के लिए कुछ भी वापस नहीं करते थे - KVC इसे बिना किसी प्रश्न के वांछित संपत्ति में सेट कर देगा।

वह मूल रूप से यह है। संक्षेप में, हमारे पास तीन "इकाइयाँ" हैं - क्या नक्शा करना है, किस वर्ग को नक्शा करना है या "आदिम", कौन सी संपत्ति को मैप करना है (या यदि निर्दिष्ट नहीं है, तो json कुंजी नाम के साथ संपत्ति के लिए), और यह निर्भर करता है कि क्या है कोई मान जो मैप या नहीं कहलाता है, क्रमशः mapObjectFromDictionary या mapArrayOfObjects द्वारा कहा जाता है। mapArrayOfObjects अनिवार्य रूप से कोई काम नहीं करता है, एक एरे बनाता है और [self mapArrayOfObjects: value] या [mappedArray addObject: [self mapObjectFr ढाँचा: value] को डालता है, जहाँ वैल्यू वह है जो इनपुट एरे पर पुनरावृत्ति के दौरान प्राप्त किया जाता है। वह सब है।

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