एक वास्तविक उदाहरण के साथ Newtonsoft.Json पुस्तकालय के साथ काम करना। भाग 1

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



मैं यह नोट करना चाहता हूं कि यह नोट विषय के पूर्ण प्रकटीकरण का ढोंग नहीं करता है। इस पाठ का उद्देश्य उन विकासों की संरचना करना और उनका संरक्षण करना है, जिनका उपयोग मैंने न्यूटनसॉफ्ट के साथ काम करते समय किया था। जैसन पुस्तकालय।

समस्या का बयान

लेख के ढांचे के भीतर, बड़े और, यह महत्वपूर्ण नहीं है कि पार्सिंग के लिए प्रारंभिक डेटा कैसे प्राप्त किया गया था, हालांकि, यह स्पष्टीकरण निश्चित रूप से सामग्री की धारणा को सुविधाजनक बनाएगा। तो, मुख्य कार्य EXMO क्रिप्टोकरंसी एपीआई के कार्यों को लागू करना है। सरलता के लिए, हम मुख्य रूप से पब्लिक इंटरफेस (सार्वजनिक एपीआई) के साथ काम करेंगे। इस मामले में, जानकारी के लिए अनुरोध किसी साइट के नियमित पृष्ठ पते की तरह दिखाई देगा। अनुरोध भेजने के लिए, System.Net.Http नामस्थान के HttpClient वर्ग का उपयोग किया जाता है:

HttpClient httpClient = new HttpClient(); string request = "https://api.exmo.com/v1/trades/?pair=BTC_USD"; HttpResponseMessage response = (await httpClient.GetAsync(request)).EnsureSuccessStatusCode(); string responseBody = await response.Content.ReadAsStringAsync(); 

इस कार्यक्रम का परिणाम https://api.exmo.com/v1/trades/?pair=BTC_USD के लिंक पर क्लिक करके देखा जा सकता है। यदि आप इस डेटा को JSON C # क्लास जेनरेटर में लोड करते हैं, तो हमें डिसेरलाइज़ेशन के लिए निम्न वर्ग संरचना की पेशकश की जाएगी:

  public class BTCUSD { public int trade_id { get; set; } public string type { get; set; } public string quantity { get; set; } public string price { get; set; } public string amount { get; set; } public int date { get; set; } } public class RootObject { public List<BTCUSD> BTC_USD { get; set; } } 

यह ध्यान दिया जाना चाहिए कि क्रिप्टो-एक्सचेंज "ट्रेड्स" फ़ंक्शन स्वयं आपको एक बार में कई मुद्रा जोड़े के बारे में जानकारी का अनुरोध करने की अनुमति देता है। और अनुरोध के मामले में

 string request = "https://api.exmo.com/v1/trades/?pair=BTC_USD,ETH_USD"; 

वर्ग संरचना पहले से ही इस तरह दिखेगी:

  public class BTCUSD { public int trade_id { get; set; } public string type { get; set; } public string quantity { get; set; } public string price { get; set; } public string amount { get; set; } public int date { get; set; } } public class ETHUSD { public int trade_id { get; set; } public string type { get; set; } public string quantity { get; set; } public string price { get; set; } public string amount { get; set; } public int date { get; set; } } public class RootObject { public List<BTCUSD> BTC_USD { get; set; } public List<ETHUSD> ETH_USD { get; set; } } 

जाहिर है, आप मुद्रा जोड़े के प्रत्येक संयोजन के लिए कक्षाएं तैयार नहीं कर सकते हैं, जिसका अर्थ है कि आपको किसी तरह बाहर निकलने की आवश्यकता है।

JSON ऑब्जेक्ट्स (जोबजेक्ट क्लास)

JSON ऑब्जेक्ट कुंजी / मान जोड़े का एक अनियंत्रित सेट है। एक वस्तु '{' (एक घुंघराले ब्रेस) के साथ शुरू होती है और '}' (एक समापन घुंघराले ब्रेस) के साथ समाप्त होती है। प्रत्येक नाम के बाद है: (एक बृहदान्त्र), कुंजी / मूल्य जोड़े अल्पविराम द्वारा अलग किए जाते हैं।



JSON C # क्लास जेनरेटर द्वारा हमें पहले प्रस्तावित संरचना से, हम देखते हैं कि प्रत्येक मुद्रा जोड़ी के लिए हमारे पास 6 निरंतर क्षेत्र हैं। उन्हें एक अलग कक्षा में लपेटें और इसे ऑर्डर करें।

  class Order { public int trade_id { get; set; } public string type { get; set; } public double quantity { get; set; } public double price { get; set; } public double amount { get; set; } public int date { get; set; } } 

विनिमय के गतिशील रूप से बदलती डेटा संरचना से इन क्षेत्रों का एक सेट "हड़पने" करने में सक्षम होने के लिए, आपको न्यूटोसॉफ्ट.जॉन लाइब्रेरी में उपलब्ध डेटा प्रकारों को अधिक विस्तार से समझने की आवश्यकता है। अधिक विशेष रूप से, newtonsoft.json.linq नेमस्पेस में।


पुस्तकालय स्थापित करने के बाद newtosoft.json.linq नाम स्थान, परियोजना से जुड़ने के लिए उपलब्ध हो जाता है:

 using Newtonsoft.Json.Linq; 

Newtosoft.json.linq डेटा का प्रतिनिधित्व करने के लिए अमूर्त JToken वर्ग का उपयोग करता है, जिसमें से JValue (सरल मूल्यों का प्रतिनिधित्व करने के लिए) और JContainer (संरचनाओं का प्रतिनिधित्व करने के लिए) कक्षाएं विरासत में मिली हैं। संरचनाएं, बदले में, एक JArray (सरणी), JConstructor (निर्माता), Jobject (ऑब्जेक्ट), या JProperty (संपत्ति) हो सकती हैं।

JArray और JObject क्लासेस में एक Parse मेथड है जो आपको JSON डेटा को रेग्युलर स्ट्रिंग से संबंधित ऑब्जेक्ट्स में बदलने की अनुमति देता है। तो, अगर हम Exmo ट्रेडों फ़ंक्शन के डेटा संरचना के लिए JObject.Parse (स्ट्रिंग) विधि का उपयोग करते हैं:

 HttpClient httpClient = new HttpClient(); string request = "https://api.exmo.com/v1/trades/?pair=BTC_USD,ETH_USD"; HttpResponseMessage response = (await httpClient.GetAsync(request)).EnsureSuccessStatusCode(); string responseBody = await response.Content.ReadAsStringAsync(); JObject jObject = JObject.Parse(responseBody); 

हम दो तत्वों की एक संरचना देखेंगे, जिनमें से प्रत्येक एक कुंजी-मूल्य जोड़ी का प्रतिनिधित्व करता है। इस मामले में कुंजी मुद्रा जोड़ी (स्ट्रिंग प्रकार) का नाम होगा, और मूल्य लेनदेन की सूची (JToken प्रकार) होगा:



अब, लेन-देन की सूची हमारे पास "BTC_USD" और "USD_ETH" कुंजियों के साथ उपलब्ध है। उदाहरण के लिए, मुद्रा जोड़ी "BTC_USD" पर लेनदेन:



फिर हमें केवल काम के लिए डेटा को सुविधाजनक प्रकार में अनुवाद करने की आवश्यकता है, उदाहरण के लिए सूची <आदेश> ToObject <> () विधि का उपयोग करते हुए:

 HttpClient httpClient = new HttpClient(); string request = "https://api.exmo.com/v1/trades/?pair=BTC_USD,ETH_USD"; HttpResponseMessage response = (await httpClient.GetAsync(request)).EnsureSuccessStatusCode(); string responseBody = await response.Content.ReadAsStringAsync(); JObject jObject = JObject.Parse(responseBody); JToken list = jObject["BTC_USD"]; List<Order> trades = list.ToObject<List<Order>>(); 

या तो पूरी संरचना को टाइप करने के लिए परिवर्तित करें शब्दकोश <स्ट्रिंग, सूची <आदेश >> :

 HttpClient httpClient = new HttpClient(); string request = "https://api.exmo.com/v1/trades/?pair=BTC_USD,ETH_USD"; HttpResponseMessage response = (await httpClient.GetAsync(request)).EnsureSuccessStatusCode(); string responseBody = await response.Content.ReadAsStringAsync(); JObject jObject = JObject.Parse(responseBody); Dictionary<string, List<Order>> trades = new Dictionary<string, List<Order>>(); foreach (KeyValuePair<string, JToken> obj in jObject) trades.Add(obj.Key, obj.Value.ToObject<List<Order>>()); 

JSON Arrays (JArray क्लास)

JSON एरे मूल्यों का एक संग्रहित संग्रह है। एक सरणी '[' (शुरुआती वर्ग ब्रैकेट) से शुरू होती है और ']' (समापन स्क्वायर ब्रैकेट) के साथ समाप्त होती है। मान को अल्पविराम द्वारा अलग किया जाता है।

JSON सरणी कैसा दिखता है, इसे https://api.exmo.com/v1/currency लिंक पर जाकर देखा जा सकता है। यदि आप इसे एक जोबजेक्ट में बदलने का प्रयास करते हैं, जैसा कि हमने पिछले अनुरोध के साथ किया था:

 HttpClient httpClient = new HttpClient(); string request = "https://api.exmo.com/v1/currency"; HttpResponseMessage response = (await httpClient.GetAsync(request)).EnsureSuccessStatusCode(); string responseBody = await response.Content.ReadAsStringAsync(); JObject jObject = JObject.Parse(responseBody); 

हमें एक Newtonsoft.Json.JsonReaderException अपवाद मिलेगा जो हमें बता रहा है कि परिवर्तित किया जा रहा डेटा ऑब्जेक्ट नहीं है।



Arrays को एक विशेष JArray प्रकार में परिवर्तित किया जाना चाहिए, जो जोबजेक्ट की तरह, JContainer से विरासत में मिला।

 HttpClient httpClient = new HttpClient(); string request = "https://api.exmo.com/v1/currency"; HttpResponseMessage response = (await httpClient.GetAsync(request)).EnsureSuccessStatusCode(); string responseBody = await response.Content.ReadAsStringAsync(); JObject jObject = JObject.Parse(responseBody); JArray jArray = JArray.Parse(responseBody); 

मामले में जब पार्सिंग करते हैं, तो प्रारंभिक संरचना पहले से ज्ञात नहीं होती है, या दोनों प्रकार के डेटा को संसाधित करने की क्षमता की आवश्यकता होती है - आप JContainer या JToken को परिवर्तित ऑब्जेक्ट के प्रकार के रूप में निर्दिष्ट कर सकते हैं, फिर डेटा को पार्स करने के दौरान वांछित प्रकार में बदल दिया जाएगा।

 HttpClient httpClient = new HttpClient(); string request = "https://api.exmo.com/v1/currency"; HttpResponseMessage response = (await httpClient.GetAsync(request)).EnsureSuccessStatusCode(); string responseBody = await response.Content.ReadAsStringAsync(); JToken jArray = JToken.Parse(responseBody ); //    JArray List<string> list = jArray.ToObject<List<string>>(); request = "https://api.exmo.com/v1/trades/?pair=BTC_USD,ETH_USD"; HttpResponseMessage response = (await httpClient.GetAsync(request)).EnsureSuccessStatusCode(); string responseBody = await response.Content.ReadAsStringAsync(); JToken jObject = JToken.Parse(responseBody ); //    JObject Dictionary<string, List<Order>> dict = jObject.ToObject<Dictionary<string, List<Order>>>(); 

JSON मान (JValue Class)

JSON प्रारूप विवरण के अनुसार, मान एक डबल-उद्धृत स्ट्रिंग, संख्या, सत्य, असत्य, अशक्त, एक वस्तु या एक सरणी हो सकता है । इन संरचनाओं को नस्ट किया जा सकता है। Newotnsoft.json के कार्यान्वयन में, केवल साधारण प्रकार की वस्तुओं का मूल्य हो सकता है। JArray को JValue में बदलने का प्रयास करने पर परिणाम "System.InvalidCastException" अपवाद के रूप में मिलेगा।

Newtonsoft.json पुस्तकालय में विशिष्ट मूल्यों (JValue वर्ग) के साथ काम करने पर एक परिचयात्मक सामग्री के रूप में, एक बार और दो बार प्रलेखन से उदाहरण अच्छी तरह से अनुकूल हैं।

एक्सचेंज से डेटा के लिए उपयोग उदाहरण:

 HttpClient httpClient = new HttpClient(); string request = "https://api.exmo.com/v1/currency"; HttpResponseMessage response = (await httpClient.GetAsync(request)).EnsureSuccessStatusCode(); string responseBody = await response.Content.ReadAsStringAsync(); JArray jArray = JArray.Parse(responseBody ); foreach (JValue value in jArray) { string s = (string)value; } 

लेख के दूसरे भाग में, मैं डेटा को पार्स करने के लिए एक वर्ग तैयार करने की संभावनाओं के बारे में और अधिक विस्तार से वर्णन करूंगा, साथ ही डेटटाइम डेटा प्रकार के साथ काम करने की कुछ विशेषताएं।


पुस्तकालय के बारे में सबसे पूर्ण और विस्तृत जानकारी हमेशा आधिकारिक दस्तावेज में पाई जा सकती है।