👩🏾‍💻 👈🏼 🕵🏽 EasyMapping, या JSON यात्रा 👶🏼 🚤 ⛎

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

डगलस क्रॉकफोर्ड, जेन्सन विनिर्देश के लेखक

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

JSON को ऑब्जेक्टिव-सी ऑब्जेक्ट में बदलने के कई तरीके हैं, लेकिन उनमें से कई में उनकी कमियां हैं जो उन्हें काम करने से रोकती हैं। कई RestKit द्वारा एक प्रसिद्ध और प्रिय है, हालांकि, दुर्भाग्य से, यह केवल तभी प्रभावी रूप से काम करता है जब एक आदर्श REST API हो। पक्ष के लिए एक कदम - और आप सूक्ष्मदर्शी के साथ नाखूनों में हथौड़ा लेंगे, समझ में नहीं आता कि आपको काफी सरल चीजों के लिए इस तरह की जटिल संरचनाएं लिखने की आवश्यकता क्यों है। GitHub डेवलपर्स - मेंटल से एक समाधान है, लेकिन इसके साथ आपको मेंटल बेस क्लास से विरासत में प्राप्त करने के लिए मजबूर किया जाएगा और लगातार NSValueTransformer का उपयोग करेंगे - आईओएस / मैक ओएस के विकास में सबसे लोकप्रिय तकनीक नहीं।

मैं उस ढांचे के बारे में बात करना चाहता हूं जो हाल ही में गीथहब के विस्तार पर पाया गया था, और जो आपको आसानी से और खूबसूरती से JSON को ऑब्जेक्टिव-सी ऑब्जेक्ट - ईजीएमपिंग में बदलने की अनुमति देता है।

यदि आप रुचि रखते हैं, कैट में आपका स्वागत है!

कार्य

उदाहरण के लिए निम्नलिखित JSON लें:

{ "name": "Lucas", "email": "notexisting@gmail.com", "gender" : "male", "car": { "model": "i30", "year": "2013" }, "phones": [ { "ddi": "55", "ddd": "85", "number": "1111-1111" }, { "ddi": "55", "ddd": "11", "number": "2222-222" } ] }

उद्देश्य-सी में, हम निम्नलिखित वर्गों का उपयोग करेंगे:

 typedef enum { GenderMale, GenderFemale } Gender; @interface Person : NSObject @property (nonatomic, copy) NSString *name; @property (nonatomic, copy) NSString *email; @property (nonatomic, assign) Gender gender; @property (nonatomic, strong) Car *car; @property (nonatomic, strong) NSArray *phones; @end @interface Car : NSObject @property (nonatomic, copy) NSString *model; @property (nonatomic, copy) NSString *year; @end @interface Phone : NSObject @property (nonatomic, copy) NSString *DDI; @property (nonatomic, copy) NSString *DDD; @property (nonatomic, copy) NSString *number; @end

कार्यान्वयन

प्रत्येक वर्ग के लिए, आपको एक मैपिंग (EKObjectMapping) बनाने की आवश्यकता है, उदाहरण के लिए:

 EKObjectMapping * mapping = [[EKObjectMapping alloc] initWithObjectClass:[Person class]];

फिर आपको संचार के लिए कुंजी-मूल्य संबंध जोड़ना होगा <JSON में कुंजी> -> <ऑब्जेक्ट प्रॉपर्टी का नाम>। मैपिंग के दौरान इन स्थितियों का सबसे आम परिस्थितियों पर विचार करें और ईजीएमपिंग के साथ इन परिस्थितियों को संभालें।

1. JSON में ऑब्जेक्ट्स गुण नाम से मेल खाते हैं

उदाहरण, वर्ग व्यक्ति:

 [mapping mapFieldsFromArray:@[@"name",@"email"]];

2. JSON में कुंजियाँ ऑब्जेक्ट प्रॉपर्टी के नामों से भिन्न होती हैं

उदाहरण, फ़ोन वर्ग:

 [mapping mapFieldsFromDictionary:@{@"ddi":@"DDI", @"ddd":@"DDD"}];

3. मान के लिए अतिरिक्त प्रसंस्करण की आवश्यकता होती है

उदाहरण, वर्ग व्यक्ति

 NSDictionary *genders = @{ @"male": @(GenderMale), @"female": @(GenderFemale) }; [mapping mapKey:@"gender" toField:@"gender" withValueBlock:^(NSString *key, id value) { return genders[value]; }];

4. एक वस्तु में दूसरे वर्ग की वस्तु होती है।

उदाहरण, वर्ग व्यक्ति

 [mapping hasOneMapping:[Car objectMapping] forKey:@"car"];

5. एक वस्तु में किसी अन्य वर्ग की वस्तुओं की एक सरणी होती है।

एक उदाहरण है। व्यक्ति वर्ग

 [mapping hasManyMapping:[Phone objectMapping] forKey:@"phones"];

परिणाम

हमारी कक्षाओं के लिए पूरी तरह से मैपिंग:

 // Car mapping + (EKObjectMapping *)objectMapping { EKObjectMapping * mapping = [[EKObjectMapping alloc] initWithObjectClass:[Car class]]; [mapping mapFieldsFromArray:@[@"model", @"year"]]; return mapping; } // Phone mapping + (EKObjectMapping *)objectMapping { EKObjectMapping * mapping = [[EKObjectMapping alloc] initWithObjectClass:[Phone class]]; [mapping mapFieldsFromArray:@[@"number"]]; [mapping mapFieldsFromDictionary:@{ @"ddi" : @"DDI", @"ddd" : @"DDD" }]; return mapping; } // Person mapping + (EKObjectMapping *)objectMapping { EKObjectMapping * mapping = [[EKObjectMapping alloc] initWithObjectClass:[Person class]]; NSDictionary *genders = @{ @"male": @(GenderMale), @"female": @(GenderFemale) }; [mapping mapFieldsFromArray:@[@"name", @"email"]]; [mapping mapKey:@"gender" toField:@"gender" withValueBlock:^(NSString *key, id value) { return genders[value]; }]; [mapping hasOneMapping:[Car objectMapping] forKey:@"car"]; [mapping hasManyMapping:[Phone objectMapping] forKey:@"phones"]; return mapping; }

अब मैपिंग तैयार है, व्यक्ति वस्तु का निर्माण निम्नानुसार है:

 NSDictionary * personProperties = ...; // JSON  Person,  ,   . Person * person = [[Person alloc] init]; [EKMapper fillObject:person fromExternalRepresentation:personProperties withMapping:mapping];

इस प्रकार, जब कोई ऑब्जेक्ट बनाते हैं, तो कोई if-else निर्माण का उपयोग नहीं किया जाता है; NSNull के लिए कोई चेक नहीं हैं। इसके अलावा, मौजूदा वस्तुओं को नए डेटा के साथ आसानी से अपडेट किया जा सकता है यदि ऐसी आवश्यकता उत्पन्न होती है।

अतिरिक्त आसान मानचित्रण बन्स

1. कोरडाटा का समर्थन करें
2. NSNull के लिए अंतर्निहित चेक - NSNull स्वचालित रूप से nil के साथ बदल दिया जाता है।
3. NS सहार / NSArray में वस्तुओं को क्रमबद्ध करने की क्षमता
4. CocoaPods के माध्यम से स्थापना का समर्थन
5. पूरी तरह से परीक्षण में शामिल किया गया।

कार्यान्वयन में अच्छा व्यवहार

EKMapper के साथ एक ऑब्जेक्ट भरना बेस क्लास में सबसे अच्छा किया जाता है, बेसमॉडल कहते हैं, निम्नानुसार है:

 - (id)initWithProperties:(NSDictionary *)properties { if (self = [super init]) { [EKMapper fillObject:self fromExternalRepresentation:properties withMapping:[[self class] objectMapping]; } return self; } + (EKObjectMapping *)objectMapping { //Do nothing. Implement in subclass if you want to initialize object //via object mapping return nil; }

इस प्रकार, वस्तु का निर्माण इस तरह दिखेगा:

 Person * person = [[Person alloc] initWithProperties:personProperties];

निष्कर्ष

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

संदर्भ

1. गितूब पर ईजीएमपिंग
2. कोकोपोड्स

वैकल्पिक समाधान

1. रेस्टकट
2. मेंटल

EasyMapping, या JSON यात्रा