उद्देश्य-सी के लिए सरल JSON स्कीमा सत्यापनकर्ता

या JSON सत्यापनकर्ता का विकास एक अन्य JSON बाइंडिंग में कैसे बदल गया, इसके बारे में एक कहानी

जबकि सामान्य डेवलपर आवेदन लिखते हैं, मैं साइकिल का आविष्कार करता हूं।

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


समाधानों में से एक JSON योजना ( JSON योजनाओं पर एक अवलोकन लेख ) के अनुसार भेजे गए JSON का सत्यापन है।

उदाहरण के लिए, यदि JSON ने हमें भेजा है

{ "numberKey" : 100500, "arrayKey" : [ { "number" : 1 , "string" : "1" }, { "number" : 2 , "string" : "2" }, { "number" : 3 , "string" : "3" } ] } 

यह वर्णन करने वाला न्यूनतम JSON स्कीमा होगा

 { "type" : "object", "properties" : { "numberKey" : { "type" : "number" }, "arrayKey" : { "type" : "array", "items" : { "type" : "object", "properties" : { "number" : { "type" : "number" }, "string" : { "type" : "string" } } } } } } 

हमें आदर्श रूप से भेजे गए JSON को लेना है और सर्किट का उपयोग करके इसे सत्यापित करना है। ऐसा लगता है कि समस्या हल हो गई है। JSON- स्कीमा JSON का वर्णन करने के लिए एक मानक तरीका है, और कई प्रोग्रामिंग भाषाओं के लिए सत्यापनकर्ता हैं। लेकिन ऑब्जेक्टिव-सी भाषा के लिए एक सत्यापनकर्ता की खोज ने कोई भी परिणाम नहीं दिया, इसलिए साइकिल निर्माण के रास्ते पर जाने का निर्णय लिया गया।

नतीजतन, JsonSchemaValidator ( बिटबकेट ) नामक एक टुकड़ा पैदा हुआ था। उन लोगों के लिए जो कोशिश करना चाहते हैं:

 pod 'SVJsonSchemaValidator' 

इसलिए, इस लाइब्रेरी की मदद से, हम एक आरेख बना सकते हैं:

आईडी स्कीमा = [ [ SVType ऑब्जेक्ट ] गुण : @ {
@ "नंबरकी" : [ SVType नंबर ] ,
@ "arrayKey" : [ [ SVType array ] आइटम : [ [ SVType ऑब्जेक्ट ] गुण : @ {
@ "संख्या" : [ SVType संख्या ] ,
@ "स्ट्रिंग" : [ SVType string ]
} ] ]
} ] ;

जैसा कि आप देख सकते हैं, लगभग एक से एक योजना JSON को ही दोहराती है। अब इसे सत्यापित करें:

NSError * error = nil ;
id validatedJson = [ स्कीमा validateJson : json error : & error ] ;

यहाँ चर हैं:
json किसी भी पार्सर (जैसे NSJSONSerialization का उपयोग करके) द्वारा पार्स किया गया JSON है।
validatedJson - केवल उन वस्तुओं को जो सत्यापन से गुजर चुके हैं।
त्रुटि - अधिक या कम समझदार विवरण जिसमें से ऑब्जेक्ट्स को मान्य करने में विफल रहा। nil - अगर सब कुछ ठीक है।

मान लीजिए कि आपके पास पहले से ही एक मॉडल वर्ग है

@ इंटरफ़ेस MyModelObject : NSObject

@property ( मजबूत, गैर-परमाणु ) NSString * स्ट्रिंग ;
@property ( मजबूत, गैर-परमाणु ) NSNumber * संख्या;

@ अंत

मैं आरेख में दोतरफा काम करना और मौजूदा कक्षाओं का वर्णन नहीं करना चाहता। आप इस वर्ग से सीधे एक स्कीमा बना सकते हैं:

आईडी स्कीमा = [ [ SVType ऑब्जेक्ट ] गुण : @ {
@ "नंबरकी" : [ SVType नंबर ] ,
@ "arrayKey" : [ [ SVType array ] आइटम : [ MyModelObject jsonSchema ] ]
} ] ;

Objc-runtime का उपयोग करते हुए, MyModelObject क्लास के लिए -jsonSchema विधि उन सभी गुणों से गुज़रेगी, जो JSON में दर्शाए जा सकते हैं और बिल्कुल उसी योजना को उत्पन्न कर सकते हैं। उसी स्कीम का उपयोग करके, आप MyModelObject प्रकार की वस्तुओं को इंस्टेंट कर सकते हैं और KVC के माध्यम से उपयुक्त मानों के साथ उनके गुणों को भर सकते हैं:

NS मंदार * instanciated = [ schema InstantiateValidatedJson : validated ] ;

( lldb ) पोए इंस्टिंक्टेड
$ 1 = 0x0755fe70 {
नंबरकी = 100500 ,
सरणी = (
"<MyModelObject: 0x7554a30>" ,
"<MyModelObject: 0x7554610>" ,
"<MyModelObject: 0x75543b0>" ,
"<MyModelObject: 0x75619b0>"
) ;
}

फिलहाल यह सब लागू है।
और अब सवाल, जिसके लिए यह छोटा विषय लिखा गया था: क्या किसी को इस बाइक की आवश्यकता है, और यदि हां, तो इसके लिए और क्या आवश्यक है? Kamenty में उत्तर की प्रतीक्षा कर रहा है।