JSON-RPC API टेस्टिंग लाइब्रेरी

जब मैं पहली बार एक microservice के लिए परीक्षण लिखने के लिए आया था, जिसका एपीआई JSON-RPC प्रोटोकॉल के अनुसार लागू किया गया था, मुझे एहसास हुआ कि json तत्वों के लिए गुणवत्ता की जाँच करना पहले से जितना मैंने सोचा था उससे कहीं अधिक मांग है।

निम्नलिखित एक सरल उदाहरण है।

सेवा से जवाब मिला:

{ "result": 12, "id": 46929734, "jsonrpc": "2.0" } 

आपको क्या जांचना है:

1. प्रतिक्रिया में एक jsonrpc तत्व होता है और इसका मान 2.0 होता है
2. प्रतिक्रिया में एक आईडी तत्व होता है और इसका मान अनुरोध में पारित एक समान तत्व के बराबर होता है, फिलहाल बता दें कि यह 46929734 है

उत्तर में तत्व "परिणाम" होता है और इसका मान 12 होता है


Java + TestNG + Gson का उपयोग करके इसे कैसे जांचें:

 Assert.assertTrue(response.has("result")); Assert.assertTrue(response.has("jsonrpc")); Assert.assertTrue(response.has("id")); Assert.assertTrue(response.get("result").isJsonPrimitive()); Assert.assertTrue(response.get("jsonrpc").isJsonPrimitive()); Assert.assertTrue(response.get("id").isJsonPrimitive()); Assert.assertEquals(response.get("result").getAsInt(), 12); Assert.assertEquals(response.get("jsonrpc").getAsString(), "2.0"); Assert.assertEquals(response.get("id").getAsInt(), 46929734); 

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

1. उत्तर ->
   

    { "result": 12, "id": 46929734, "jsonrpc": "1.0" } 

   
   TestNG से त्रुटि -> java.lang.AssertionError: अपेक्षित [2.0] लेकिन पाया गया [1.0]
   उन्होंने "2.0" का इंतजार किया, "1.0" मिला - यहां सब कुछ स्पष्ट है।
   
2. उत्तर ->
   

    { "result": 12, "id": 46929734, "jsonrpc": {} } 

   
   TestNG से त्रुटि -> java.lang.UnsupportedOperationException: JsonObject
   
   उन्होंने एक तत्व को एक स्ट्रिंग के रूप में पार्स करने की कोशिश की, जो एक वस्तु के रूप में प्रतिक्रिया में बिल्कुल अप्रत्याशित रूप से प्राप्त हुई थी।
   
3. उत्तर ->
   
   

    { "result": 12, "id": 46929734 } 

   
   TestNG से त्रुटि -> java.lang.NullPointerException
   हमने एक तत्व को पार्स करने की कोशिश की जो एक स्ट्रिंग के रूप में उत्तर में नहीं है।
   

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

इस तरह के कई चेक, उन्हें लिखने और उन्हें अद्यतित स्थिति में समर्थन देने की आवश्यकता ने मुझे बहुत परेशान किया, इसलिए मैंने एक अलग पुस्तकालय बनाया जिसमें मैंने सभी आवश्यक जांचों को, मेरी राय में, json तत्वों के लिए एकत्र किया। लाइब्रेरी का उपयोग करने वाले उपरोक्त जोंस के लिए आवश्यक कवरेज और डिटेल के समान स्तर को नौ के बजाय तीन लाइनों में प्राप्त किया जाता है।

 Gassert.verifyInteger(response, "result", 12); Gassert.verifyString(response, "jsonrpc", "2.0"); Gassert.verifyInteger(response, "id", 46929734); 

पुस्तकालय जाँच के लिए तरीकों को लागू करता है:

• मूल्य की जाँच के बिना और बिना, सभी आदिम प्रकारों के तत्व, नेस्टेड और नहीं
• JsonObject, नेस्टेड और नहीं, मूल्य जाँच के साथ और बिना
• JsonArray, नेस्टेड और नहीं, मूल्य जाँच के साथ और बिना
• JsonNull तत्वों ने नेस्ट किया और नहीं
• तत्व एक सरणी के अंदर
• अपेक्षित तत्व सरणी की सामग्री
• सरणी आयाम
• वस्तु आयाम

सत्यापन के सभी स्तरों पर, अधिक विस्तृत त्रुटियां उन लोगों के सापेक्ष कार्यान्वित की जाती हैं जो TestNG डिफ़ॉल्ट रूप से प्रदान करता है।

परीक्षण के पतन के संभावित कारणों पर फिर से विचार करें:

1. उत्तर ->
   

    { "result": 12, "id": 46929734, "jsonrpc": "1.0" } 

   
   Gassert से त्रुटि -> java.lang.AssertionError: तत्व [jsonrpc] सत्यापन विफल। अपेक्षित [२.०] लेकिन पाया [१.०]
   
2. उत्तर ->
   
   

    { "result": 12, "id": 46929734, "jsonrpc": {} } 

   
   गैसर्ट से त्रुटि -> java.lang.AssertionError: तत्व [jsonrpc] एक JsonPrimitive नहीं है। [सच] खोजने की उम्मीद नहीं की लेकिन पाया [झूठी]
   
3. उत्तर ->
   
   

    { "result": 12, "id": 46929734 } 

   
   गैसर्ट से त्रुटि -> java.lang.AssertionError: Json में तत्व नहीं है: [json.pc]। [सच] खोजने की उम्मीद नहीं की लेकिन पाया [झूठी]
   

इसके अलावा, चेक के लिए अधिकांश विधियाँ एक अतिरिक्त स्ट्रिंग पैरामीटर के साथ अतिभारित होती हैं, जो कि प्रदर्शन में त्रुटि के पाठ में एक जोरदार गिरावट के मामले में जोड़ा जाएगा। इस सुविधा का उपयोग किया जा सकता है, उदाहरण के लिए, त्रुटि में प्रतिक्रिया या अनुरोध + प्रतिक्रिया का पूरा शरीर प्रदर्शित करने के लिए।

लाइब्रेरी सार्वजनिक गितुब भंडार में है, और मावेन भंडार में भी जोड़ा जाता है।

Maven
Github
APIDocs