xNet - C # वेब लाइब्रेरी

धीरे-धीरे, C # और .NET फ्रेमवर्क के अध्ययन के साथ , मैंने विभिन्न सहायकों को लिखना शुरू किया जो सिर्फ एक विधि के कॉल के पीछे रूट कोड छिपाते थे। उसके बाद, यह एक पूर्ण पुस्तकालय के विकास में बदल गया, जिसे मैं आपसे परिचित कराना चाहता हूं। यह पुस्तकालय पूरी तरह से खरोंच से लिखा गया है।

तो xNet क्या है?

.NET फ्रेमवर्क के लिए xNet एक क्लास लाइब्रेरी है, जिसमें शामिल हैं:

• प्रॉक्सी सर्वर के साथ काम करने के लिए कक्षाएं: HTTP, Socks4 (a), Socks5, चेन ।
• एचटीटीपी 1.0 / 1.1 प्रोटोकॉल के साथ काम करने के लिए कक्षाएं: रख-रखाव, गज़िप, अपस्फीति, chunked, SSL, परदे के पीछे और बहुत कुछ ।

डाउनलोड: विज्ञप्ति
स्रोत: github.com/X-rus/xNet

पुस्तकालय के एक नए संस्करण को जारी करने के संबंध में लेख को फिर से लिखा गया था। अंतिम अद्यतन 09/12/2015

मूल बातें

HttpRequest का उपयोग अनुरोध भेजने के लिए किया जाता है। इसमें, आप विभिन्न सेटिंग्स सेट कर सकते हैं: हेडर, टाइमआउट, फ़ॉरवर्डिंग का पालन करना है या नहीं, स्थायी कनेक्शन और अन्य को रखना है या नहीं। जब आप एक अनुरोध सबमिट करते हैं, तो वह पहले HttpResponse का उपयोग करके प्रतिक्रिया शीर्षकों को स्वीकार करता है, और फिर इस ऑब्जेक्ट के लिए एक लिंक देता है ताकि आप संदेश बॉडी को लोड कर सकें। आप एक विशेष विधि का उपयोग करके संदेश निकाय डाउनलोड कर सकते हैं।

अनुरोध उदाहरण:

using (var request = new HttpRequest()) { request.UserAgent = Http.ChromeUserAgent(); //  . HttpResponse response = request.Get("habrahabr.ru"); //      . string content = response.ToString(); } 

सर्वर का कनेक्शन बंद करने के लिए, स्टेटमेंट का उपयोग किया जाता है। आप HttpRequest.Close विधि को कॉल करके भी ऐसा कर सकते हैं।

आप HttpRequest.Response प्रॉपर्टी का उपयोग करके HttpResponse का लिंक भी प्राप्त कर सकते हैं। लौटे HttpResponse अद्वितीय नहीं है। प्रत्येक HttpRequest के लिए, केवल एक HttpResponse है (यह प्रत्येक अनुरोध के साथ पुन: उपयोग किया जाता है)।

सरल अनुरोध भेजना और संदेश निकाय लोड करना

अनुरोध का उदाहरण प्राप्त करें:

 using (var request = new HttpRequest()) { var urlParams = new RequestParams(); urlParams["param1"] = "val1"; urlParams["param2"] = "val2"; string content = request.Get("habrahabr.ru", urlParams).ToString(); } 

URL पैरामीटर सेट करने के लिए RequestParams का उपयोग किया जाता है। इस स्थिति में, यह निम्नलिखित प्रविष्टि के बराबर है:

 Get("habrahabr.ru/?param1=val1&param2=val2") 

आप HttpRequest.AddUrlParam विधि का उपयोग करके URL पैरामीटर सेट कर सकते हैं। पहले अनुरोध के बाद इन मापदंडों को मिटा दिया जाएगा।

अस्थायी URL मापदंडों के साथ उदाहरण प्राप्त करें:

 using (var request = new HttpRequest()) { request.AddUrlParam("param1", "val1").AddUrlParam("param2", "val2"); string content = request.Get("habrahabr.ru").ToString(); } 

POST अनुरोध का एक उदाहरण:

 using (var request = new HttpRequest()) { var reqParams = new RequestParams(); reqParams["login"] = "neo"; reqParams["password"] = "knockknock"; string content = request.Post( "www.whitehouse.gov", reqParams).ToString(); } 

आप HttpRequest.AddParam का उपयोग करके अनुरोध पैरामीटर सेट कर सकते हैं। पहले अनुरोध के बाद इन मापदंडों को मिटा दिया जाएगा।

अस्थायी मापदंडों के साथ POST अनुरोध का एक उदाहरण:

 using (var request = new HttpRequest()) { request.AddParam("login", "neo").AddParam("password", "knockknock"); string content = request.Post("www.whitehouse.gov").ToString(); } 

तुम भी एक स्ट्रिंग, बाइट्स की एक सरणी, एक फ़ाइल, या HttpContent से विरासत में मिली किसी भी वस्तु भेज सकते हैं।

पांच HttpResponse विधियों में से एक का उपयोग संदेश शरीर को लोड करने के लिए किया जाता है: ToString , ToBytes , ToFile , ToStream या ToMemoryStream । यदि संदेश निकाय की आवश्यकता नहीं है, तो किसी भी विधि को नहीं बुलाया जाना चाहिए।

यदि आप चाहते हैं कि अनुरोध पैरामीटर एनकोडिंग हो, तो, 1251 एन्कोडिंग में कहें, तो आपको संपत्ति सेट करने की आवश्यकता है HttpRequest.CharacterSet = Encoding.GetEncoding (1251)

मल्टीपार्ट / फॉर्म डेटा भेजना

मल्टीपार्ट / फॉर्म डेटा के बारे में। उनके साथ काम करने के लिए, MultipartContent वर्ग का उपयोग किया जाता है।

मल्टीपार्ट / फॉर्म अनुरोध उदाहरण:

 using (var request = new HttpRequest()) { var multipartContent = new MultipartContent() { {new StringContent("Bill Gates"), "login"}, {new StringContent("qwerthahaha"), "password"}, {new FileContent(@"C:\windows_9_alpha.rar"), "file1", "1.rar"} }; request.Post("www.microsoft.com", multipartContent).None(); } 

स्वयं MultipartContent वर्ग का ऑब्जेक्ट नहीं बनाने के लिए, आप दो विशेष HttpRequest विधियों का उपयोग कर सकते हैं: AddField और AddFile । पहले अनुरोध के बाद इन मापदंडों को मिटा दिया जाएगा।

समय मापदंडों के साथ एक मल्टीपार्ट / फॉर्म अनुरोध का उदाहरण:

 using (var request = new HttpRequest()) { request .AddField("login", "Bill Gates") .AddField("password", "qwerthahaha") .AddFile("file1", @"C:\windows_9_alpha.rar"); request.Post("www.microsoft.com").None(); } 

स्थायी संबंध और सामंजस्य

HttpRequest लगातार कनेक्शन का समर्थन करता है। उन्हें HttpRequest.KeepAlive संपत्ति का उपयोग करके अक्षम किया जा सकता है।

एक उदाहरण:

 using (var request = new HttpRequest("habrahabr.ru")) { request.Get("/").None(); request.Get("/feed").None(); request.Get("/feed/posts"); } 

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

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

ध्यान रखें कि लगातार कनेक्शन के साथ काम करते समय, सर्वर से डिस्कनेक्ट हो सकता है। ऐसा हो सकता है क्योंकि सर्वर एक कनेक्शन के लिए अनुरोधों की सीमा तक पहुंच गया है, या अगले अनुरोध के लिए समय समाप्त हो गया है। HttpRequest पुन: कनेक्ट करने का प्रयास करके ऐसी स्थितियों को संभाल सकता है (यह व्यवहार रीकनेक्ट से संबंधित नहीं है)। यदि यह कनेक्ट करने में विफल रहता है, तो यह एक अपवाद फेंक देगा। लगातार कनेक्शन की महीन ट्यूनिंग के लिए, आप KeepAliveTimeout और मैक्सिमकक्लाइवैलरिसेप्स गुणों का उपयोग कर सकते हैं।

इसके अतिरिक्त, आप Reconnect , ReconnectLimit और ReconnectDelay गुणों का उपयोग करके पुन: कनेक्ट कर सकते हैं। डिफ़ॉल्ट रूप से, यह व्यवहार अक्षम है। यदि सर्वर से कनेक्ट करते समय कोई त्रुटि होती है, या डेटा अपलोड / डाउनलोड के दौरान कोई त्रुटि होती है, तो HttpRequest पुन: कनेक्ट करने का प्रयास करेगा। लेकिन संदेश बॉडी को लोड करते समय (ToString () विधि में, उदाहरण के लिए) यदि कोई त्रुटि होती है, तो पुनरावर्तन कार्य नहीं करेगा। प्रॉक्सी के साथ काम करते समय या यदि आपके पास अस्थिर इंटरनेट कनेक्शन है, तो यह व्यवहार काम आ सकता है।

कुकीज़, हेडर और अधिक सेट करें

अतिरिक्त हेडर एक विशेष अनुक्रमणिका का उपयोग करके निर्धारित किए जाते हैं। ध्यान रखें कि कुछ हेडर केवल विशेष गुणों का उपयोग करके सेट किए जा सकते हैं। उनकी सूची प्रलेखन में पाई जा सकती है। अनुक्रमणिका के माध्यम से निर्दिष्ट हेडर सभी अनुरोधों में भेजे जाते हैं। यदि आपको एक अनुरोध के लिए एक अस्थायी शीर्ष लेख सेट करने की आवश्यकता है, तो HttpRequest.AddHeader विधि का उपयोग करें। ऐसे हेडर इंडेक्सर के माध्यम से निर्दिष्ट हेडर को ओवरलैप करते हैं।

कुकीज़ HttpRequest.Cookies गुण का उपयोग करके सेट की गई हैं। सर्वर की प्रतिक्रिया के आधार पर कुकीज़ भिन्न हो सकती हैं। इसे रोकने के लिए, कुकीकी कीमत मान लें ।

एक उदाहरण:

 using (var request = new HttpRequest("habrahabr.ru")) { request.Cookies = new CookieDictionary() { {"hash", "yrttsumi"}, {"super-hash", "df56ghd"} }; request[HttpHeader.DNT] = "1"; request["X-Secret-Param"] = "UFO"; request.AddHeader("X-Tmp-Secret-Param", "42"); request.AddHeader(HttpHeader.Referer, "http://site.com"); request.Get("/"); } 

HttpRequest और HttpResponse में कुकीज़ और हेडर के साथ काम करने के लिए अतिरिक्त तरीके हैं: ContainsHeader , EnumerateHeaders , ClearAllHeaders , ContainsCookie , ContainsRawCookie और अन्य।

अनुरोध भेजने के लिए, आपको उपयोगकर्ता-एजेंट सेट करना होगा। यह Http विधियों में से एक द्वारा उत्पन्न किया जा सकता है: IEUserAgent , OperaUserAgent , ChromeUserAgent , FirefoxUserAgent या OperaMiniUserAgent ।
और इस तरह से पूछें:

 request.UserAgent = Http.ChromeUserAgent(); 

एक रैंडमयूजरएजेंट विधि हुआ करती थी, लेकिन मैंने इसे डिलीट कर दिया, क्योंकि इसका उपयोग करने से कुछ समस्याएं हो सकती हैं। मान लें कि Google Chrome के लिए एक साइट एक सामग्री का उत्पादन करती है, लेकिन IE के लिए यह थोड़ा अलग है, या पूरी तरह से अलग है। इसलिए, सावधानी के साथ विभिन्न ब्राउज़रों से उपयोगकर्ता एजेंटों का उपयोग करें।

HttpRequest में कई और गुण हैं जिनका उपयोग आप भेजे जाने वाले शीर्ष लेखों में हेरफेर करने के लिए कर सकते हैं। दस्तावेज देखें।

प्रॉक्सी कनेक्शन

xNet निम्नलिखित प्रकार के परदे के पीछे का समर्थन करता है:

• HTTP - श्रेणी HttpProxyClient
• Socks4 (ए) - वर्ग Socks4ProxyClient (ए)
• Socks5 - वर्ग Socks5ProxyClient

इन सभी वर्गों को ProxyClient वर्ग से विरासत में मिला है । एक अतिरिक्त वर्ग ChainProxyClient है , जो आपको प्रॉक्सी की श्रृंखला के माध्यम से एक कनेक्शन बनाने की अनुमति देता है।

एक उदाहरण:

 var proxyClient = HttpProxyClient.Parse("127.0.0.1:8080"); var tcpClient = proxyClient.CreateConnection("habrahabr.ru", 80); //    . 

HttpRequest प्रॉक्सी सर्वर के माध्यम से काम का समर्थन करता है। ऐसा करने के लिए, HttpRequest.Proxy गुण सेट करें।

हैंडलिंग में त्रुटि

यदि HTTP प्रोटोकॉल के साथ काम करते समय कोई त्रुटि होती है, तो एक HttpException को फेंक दिया जाएगा, और यदि प्रॉक्सी सर्वर के साथ काम करते समय कोई त्रुटि होती है, तो प्रॉक्सी प्रॉक्सी को फेंक दिया जाएगा। इन दोनों अपवादों को NetException वर्ग से विरासत में मिला है ।

एक उदाहरण:

 try { using (var request = new HttpRequest()) { request.Proxy = Socks5ProxyClient.Parse("127.0.0.1:1080"); request.Get("habrahabr.ru"); } } catch (HttpException ex) { Console.WriteLine("     HTTP-: {0}", ex.Message); switch (ex.Status) { case HttpExceptionStatus.Other: Console.WriteLine(" "); break; case HttpExceptionStatus.ProtocolError: Console.WriteLine(" : {0}", (int)ex.HttpStatusCode); break; case HttpExceptionStatus.ConnectFailure: Console.WriteLine("    HTTP-."); break; case HttpExceptionStatus.SendFailure: Console.WriteLine("    HTTP-."); break; case HttpExceptionStatus.ReceiveFailure: Console.WriteLine("     HTTP-."); break; } } 

अतिरिक्त कक्षाएं

WinInet वर्ग आपको विंडोज ऑपरेटिंग सिस्टम की नेटवर्क सेटिंग्स के साथ बातचीत करने की अनुमति देता है। इसके साथ, आप पता लगा सकते हैं कि कंप्यूटर इंटरनेट से जुड़ा है या इंटरनेट एक्सप्लोरर प्रॉक्सी सर्वर का मूल्य प्राप्त कर सकता है।

एचटीएमएल क्लास को HTML और अन्य टेक्स्ट डेटा की सहायता के लिए डिज़ाइन किया गया है। इसमें एक विधि शामिल है जो पाठ में HTML संस्थाओं को उन वर्णों से प्रतिस्थापित करती है जो उनका प्रतिनिधित्व करते हैं। उदाहरण: & _quot; परीक्षण & _quot; "परीक्षण" में। एक विधि जो यूनिकोड संस्थाओं को उन वर्णों से प्रतिस्थापित करती है जो उनका प्रतिनिधित्व करते हैं। उदाहरण: \ u2320 या \ U044F। और स्ट्रिंग्स निकालने के तरीके: सबस्ट्रिंग, लास्टसुबस्ट्रिंग, सबस्ट्रिंग।

संबंधित लिंक

• HTTP
• RFC2616 - HTTP / 1.1
• HTTP हेडर
• HTTP कुकी
• मल्टीपार्ट / फॉर्म-डेटा
• प्रॉक्सी सर्वर