👼🏾 🤵🏽 🤦🏼 क्यों NSURLSession NSURLConnection से बेहतर है 👋🏼 🎚️ ⏩

iOS 7 को आधिकारिक तौर पर सितंबर में जारी किया गया था, तब Apple ने नेटवर्क के साथ काम करने के लिए डेवलपर्स को एक नया तरीका प्रदान किया - NSURLSession। यह एक काफी मौलिक बात है, क्योंकि अगर आपको आईओएस 6 और नीचे का समर्थन करने की आवश्यकता है, तो सिस्टम संस्करण के संबंध में कोड को समानांतर करना बहुत समस्याग्रस्त होगा। लेकिन फिर भी, समय समाप्त हो रहा है, और अब विभिन्न स्रोतों के अनुसार, 75 से 85 प्रतिशत उपयोगकर्ताओं ने नवीनतम आईओएस पर स्विच किया है, इसलिए मैं अगले प्रोजेक्ट में NSURLSession की कोशिश करने की सलाह दूंगा।

Apple के अनुसार, NSURLSession को NSURLConnection को प्रतिस्थापित करना चाहिए, और यहां यह प्रश्न वास्तव में उठता है: "यह सब क्यों आवश्यक है?" इसलिए, तुरंत NSURLConnection की तुलना में लाभ:

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

मैं दिखाऊंगा कि नया तरीका बिल्कुल भी डरावना नहीं है और यह वास्तव में उपयोग करने लायक है। तो, चलिए शुरू करते हैं, प्रमुख वर्ग है NSURLSession, जैसा कि नाम से ही स्पष्ट है, यह HTTP के माध्यम से डेटा लोड / अनलोड करने के लिए एक निश्चित सत्र बनाता है। तीन प्रकार के सत्र हैं: डिफ़ॉल्ट - यह वही है जो NSURLConnection ने पहले किया था, अल्पकालिक - इसमें कुछ भी कैश नहीं किया गया है और सब कुछ रैम में संग्रहीत है (यह एक ब्राउज़र में निजी मोड जैसा दिखता है), डाउनलोड - परिणाम फ़ाइलों के रूप में प्रस्तुत किया गया है।

NSURLSessionConfiguration

सत्र के गुणों को NSURLSessionConfiguration क्लास द्वारा नियंत्रित किया जाता है, जिसमें सत्र का प्रकार चुनने के अलावा, विभिन्न प्रकार के पैरामीटर होते हैं: मोबाइल नेटवर्क, कुकीज़, कैश, प्रॉक्सी और सुरक्षा के माध्यम से डाउनलोड करने की क्षमता। एक दिलचस्प विवेकाधीन संपत्ति है - यह आपको सिस्टम के विवेक (जब वाई-फाई और बहुत अधिक बैटरी शक्ति है) को डाउनलोड करने की अनुमति देता है।

NSURLSession

सत्र कॉन्फ़िगरेशन सेट करने के बाद, सत्र को स्वयं बनाएँ, कॉन्फ़िगरेशन को कंस्ट्रक्टर में स्वीकार करते हुए। हम डेटा को सामान्य दो तरीकों से प्राप्त करते हैं: हम प्रतिनिधि को सेट करते हैं या हम डेटा को पूरा होने वाले ब्लॉक (उनके बारे में थोड़ी देर बाद) में पकड़ते हैं।

NSURLTask

न्यूनतम कार्य यह है कि इससे पहले यह NSURLConnection था। वर्ग ही सार है, लेकिन इसके 3 उपवर्ग हैं: NSURLSessionDataTask, NSURLSessionUploadTask (पहले का एक उपवर्ग) और NSURLSessionDownloadTask, हालाँकि, और उनके पास अपना स्वयं का निर्माता नहीं है। उन सभी को सत्र के साथ या एक पूर्ण ब्लॉक के बिना बनाया जाता है (यह तर्कसंगत है कि पहले मामले में सत्र प्रतिनिधि की आवश्यकता नहीं है)। यह सब कुछ विदेशी लगता है:

NSURLSessionDownloadTask *downloadTask = [ourSession downloadTaskWithRequest:simpleNSURLRequest];

ब्लॉक और प्रतिनिधि

सामान्य तौर पर, बूट प्रक्रिया स्वयं NSURLConnection के साथ काम करने के समान है, जल्दी से सत्रों के साथ काम करने के दो तरीकों पर विचार करें।

प्रतिनिधियों के माध्यम से:
सृजन के समय सत्रों ने प्रतिनिधि को निर्धारित किया।

 [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:nil];

उसके बाद, सभी प्रतिनिधि विधियों (कार्यों सहित) को प्रतिनिधि में बुलाया जाता है।

ब्लॉकों के माध्यम से:
इसके साथ कार्य बनाना पर्याप्त है

  -(NSURLSessionDownloadTask *)downloadTaskWithRequest:(NSURLRequest *)request completionHandler:(void (^)(NSURL *location, NSURLResponse *response, NSError *error))completionHandler

फिर से, कुछ भी नया नहीं है, यह सब हमें NSURLConnection -sendAsynchronousRequest से परिचित है: कतार: पूर्णहैंडलर:
इस मामले में, हम आवश्यक होने पर प्रमाणीकरण के लिए एक प्रतिनिधि विधि जोड़ सकते हैं।

उदाहरण

हमने सामान्य योजना बनाई, सिद्धांत को स्थगित कर दिया, उदाहरण देखने के लिए समय!

रोकना / लोड करना जारी रखें।

पूरी योजना NSURLConnection के माध्यम से काम करने के समान है, लेकिन, उसके विपरीत, हम बस किसी भी डाउनलोड कार्य को रद्द कर सकते हैं। रद्द करते समय, प्रतिनिधि विधि URLSession: कार्य: didCompleteWithError: कहा जाएगा, ताकि वहां आप UI के साथ सभी आवश्यक जोड़तोड़ कर सकें। और आप न केवल रद्द कर सकते हैं, बल्कि बस रोक सकते हैं।

  [self.resumableTask cancelByProducingResumeData:^(NSData *resumeData) { partialDownload = resumeData; self.resumableTask = nil; }]; //        if(partialDownload) { self.resumableTask = [inProcessSession downloadTaskWithResumeData:partialDownload]; } else { ... } [self.resumableTask resume];

कार्य को रोककर, आप प्राप्त सभी डेटा को सहेज सकते हैं, और उसके बाद इसे नए डाउनलोड कार्य को दे सकते हैं।

फाइल पर अपलोड करें

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

ब्लॉक के माध्यम से:

 NSURLSessionConfiguration* sessionConfig = [NSURLSessionConfiguration defaultSessionConfiguration]; NSURLSession *session = [NSURLSession sessionWithConfiguration:sessionConfig]; NSURL* downloadTaskURL = [NSURL URLWithString:@"http://upload.wikimedia.org/wikipedia/commons/1/14/Proton_Zvezda_crop.jpg"]; [[session downloadTaskWithURL: downloadTaskURL completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) { NSFileManager *fileManager = [NSFileManager defaultManager]; NSArray *urls = [fileManager URLsForDirectory:NSDocumentDirectory inDomains:NSUserDomainMask]; NSURL *documentsDirectory = [urls objectAtIndex:0]; NSURL *originalUrl = [NSURL URLWithString:[downloadTaskURL lastPathComponent]]; NSURL *destinationUrl = [documentsDirectory URLByAppendingPathComponent:[originalUrl lastPathComponent]]; NSError *fileManagerError; [fileManager removeItemAtURL:destinationUrl error:NULL]; // ! [fileManager copyItemAtURL:location toURL:destinationUrl error:&fileManagerError]; }] resume];

प्रतिनिधि विधि के माध्यम से:

 NSURLSessionConfiguration* sessionConfig = [NSURLSessionConfiguration defaultSessionConfiguration]; NSURLSession *session = [NSURLSession sessionWithConfiguration:sessionConfig delegate:self delegateQueue:nil]; NSURL* downloadTaskURL = [NSURL URLWithString:@"http://upload.wikimedia.org/wikipedia/commons/1/14/Proton_Zvezda_crop.jpg"]; [[session downloadTaskWithURL:downloadTaskURL] resume]; //    - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location { //  }

मुझे यह कहना चाहिए कि हमें स्थान चर में अपने डिवाइस पर पता मिलता है:
फ़ाइल: /// निजी / var / mobile / Applications / {appUUID} /tmp/CFNetworkDownload_fileID.tmp, जिसके बाद हम फ़ाइल को अधिक सुरक्षित स्थान पर सहेजते हैं, उदाहरण फ़ाइल में: /// var / मोबाइल / एप्लिकेशन / {appUUID} / दस्तावेज़ /Proton_Zvezda_crop.jpg

एक समय में अनुरोधों की एक सीमित संख्या भेजें

कभी-कभी हमें एक साथ अनुरोधों की संख्या को सीमित करने की आवश्यकता होती है, उदाहरण के लिए - 5. इस मामले में, हमें अधिकतम कनेक्शन की संख्या निर्दिष्ट करने की आवश्यकता है:

 sessionConfig.HTTPMaximumConnectionsPerHost = 5;

इसके अलावा एक उदाहरण देने की कोशिश की जाएगी, बड़ी फ़ाइलों को लेने के लिए बेहतर है, मैं 3 जी (सेटिंग्स -> डेवलपर -> नेटवर्क लिंक कंडीशनर -> एक प्रोफ़ाइल चुनें -> 3 जी -> सक्षम) के माध्यम से डाउनलोड करने की सलाह देता हूं।

 - (void) methodForNSURLSession{ NSURLSessionConfiguration *sessionConfig = [NSURLSessionConfiguration defaultSessionConfiguration]; _tasksArray = [[NSMutableArray alloc] init]; sessionConfig.HTTPMaximumConnectionsPerHost = 5; sessionConfig.timeoutIntervalForResource = 0; sessionConfig.timeoutIntervalForRequest = 0; NSURLSession* session = [NSURLSession sessionWithConfiguration:sessionConfig delegate:self delegateQueue:nil]; // download tasks // [self createDataTasksWithSession:session]; // data tasks [self createDownloadTasksWithSession:session]; } - (void) createDownloadTasksWithSession:(NSURLSession *)session{ for (int i = 0; i < 10; i++) { NSURLSessionDownloadTask *sessionDownloadTask = [session downloadTaskWithURL: [NSURL URLWithString:@"https://discussions.apple.com/servlet/JiveServlet/showImage/2-20930244-204399/iPhone%2B5%2BProblem2.jpg"]]; [_tasksArray addObject:sessionDownloadTask]; [sessionDownloadTask addObserver:self forKeyPath:@"countOfBytesReceived" options:NSKeyValueObservingOptionOld context:nil]; [sessionDownloadTask resume]; } } - (void) createDataTasksWithSession:(NSURLSession *)session{ for (int i = 0; i < 10; i++) { NSURLSessionDataTask *sessionDataTask = [session dataTaskWithURL: [NSURL URLWithString:@"https://discussions.apple.com/servlet/JiveServlet/showImage/2-20930244-204399/iPhone%2B5%2BProblem2.jpg"]]; [_tasksArray addObject:sessionDataTask]; [sessionDataTask addObserver:self forKeyPath:@"countOfBytesReceived" options:NSKeyValueObservingOptionOld context:nil]; [sessionDataTask resume]; } } - (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary *)change context:(void *)context{ if([[change objectForKey:@"old"] integerValue] == 0){ NSLog(@"task %d: started", [_tasksArray indexOfObject: object]); } } - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error{ NSLog(@"task %d: finished!", [_tasksArray indexOfObject:task]); }

उदाहरण काफी सरल और पारदर्शी है, लेकिन मैं आपका ध्यान एक बिंदु पर आकर्षित करूंगा:

 sessionConfig.timeoutIntervalForResource = 0; sessionConfig.timeoutIntervalForRequest = 0;

प्रलेखन के अनुसार:
timeoutIntervalForRequest - प्रत्येक कार्य को लोड करने के लिए आवंटित किया गया समय
timeoutIntervalForResource - वह समय जो सभी अनुरोधों को लोड करने के लिए आवंटित किया गया है
और यहाँ हमारे पास एक समस्या है, तथ्य यह है कि जिस समय हम कार्य शुरू करते हैं ([कार्य फिर से शुरू करना)) टाइमआउटIntervalForRequest काउंटर टिक करना शुरू कर देता है, और कोई भी परवाह नहीं करता है कि हमारे पास 100 कार्य हैं, और केवल 5 एक ही समय में काम कर सकते हैं। कारण यह है कि इन मापदंडों का मान समान होना चाहिए, क्योंकि अंतिम रूप से कहे जाने वाले कार्य थोड़ा सा डेटा प्राप्त किए बिना समाप्त हो सकते हैं।

इसलिए, हमारे पास कोई विकल्प नहीं है, लेकिन दोनों चर को समान मानों पर सेट करने के लिए, आप इसे 0 पर भी सेट कर सकते हैं, जिस स्थिति में काउंटर अनंत तक जाएगा।

हां, बेशक आप एक साइकिल का आविष्कार कर सकते हैं और स्वतंत्र रूप से कार्यों की संख्या की निगरानी कर सकते हैं, लेकिन आप वास्तव में "बॉक्स से बाहर" विकल्प चाहते हैं। यहाँ, मेरी राय में, Apple इंजीनियरों ने पूरी तरह से सोचा नहीं था।

ट्रैकिंग डाउनलोड करें

टास्क डाउनलोड के लिए एक विशेष प्रतिनिधि विधि है:

 - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite { double progress = (double)totalBytesWritten / (double)totalBytesExpectedToWrite; NSLog(@"download: %@ progress: %f", downloadTask, progress); dispatch_async(dispatch_get_main_queue(), ^{ self.progressView.progress = progress; }); }

शेष कार्यों के लिए, आप पिछले उदाहरण के रूप में केवीओ का उपयोग कर सकते हैं।

पृष्ठभूमि में डाउनलोड करें

खैर, अंत में, हम पृष्ठभूमि में लोड करने के उदाहरण से निपटेंगे, उदाहरण wwdc'13 705 से डेमो दोहराता है। व्यक्तिगत रूप से, डेमो ने मुझे झटका दिया। हम चित्र डाउनलोड करना शुरू करते हैं, एप्लिकेशन से बाहर निकलते हैं, लौटते हैं - चित्र लोड होता है और पहले से ही बाहर रखा जाता है, और इसे मल्टीटास्क मेनू (होम बटन पर डबल-क्लिक करके) में भी देखा जा सकता है। लेकिन इससे भी अधिक, यदि हम लोडिंग के समय एप्लिकेशन को छोड़ देते हैं, तो डाउनलोड समाप्त हो जाएगा और सब कुछ वापस आ जाएगा जैसे कि कुछ भी नहीं हुआ था! हां, और लोड करने के बाद, हमारे UI को पृष्ठभूमि में सही अपडेट किया गया है, और मल्टीटास्किंग मेनू परिवर्तनों में स्नैपशॉट। एकमात्र मामला जब डाउनलोड समाप्त नहीं होता है जब उपयोगकर्ता स्वयं एप्लिकेशन को मारता है, लेकिन कुछ भी नहीं करना है, तो मास्टर ही मास्टर है।

ऐसा "जादू" क्यों काम करता है? बात यह है कि जब एप्लिकेशन पृष्ठभूमि प्रक्रिया शुरू करता है, तो सिस्टम एक डेमॉन बनाता है जो डेटा को एप्लिकेशन में स्थानांतरित करता है। यह तर्कसंगत है, हमें कुछ ऐसा चाहिए जो कि स्वतंत्र रूप से आवेदन के साथ रहेगा। इस कारण से, हम आवेदन को रोकने या दुर्घटनाग्रस्त होने से डरते नहीं हैं। डाउनलोड पूरा होने के बाद, डेमॉन "उठता है" आवेदन करता है, जिसके बाद हम सत्र को पुनर्स्थापित कर सकते हैं और सभी डेटा प्राप्त कर सकते हैं। पुराने पहचानकर्ता के साथ एक नया सत्र बनाना हमें मौजूदा पृष्ठभूमि सत्र से "कनेक्ट" करेगा।

अब हम मुख्य बिंदुओं का विश्लेषण करेंगे, परीक्षण परियोजना को ही यहां उठाया जा सकता है ।

सबसे पहले, एकल शैली में एक सत्र बनाएं:

 - (NSURLSession *)backgroundSession{ static NSURLSession *session = nil; static dispatch_once_t onceToken; dispatch_once(&onceToken, ^{ //         ,      NSURLSessionConfiguration *config = [NSURLSessionConfiguration backgroundSessionConfiguration:@"com.dev.BackgroundDownloadTest.BackgroundSession"]; [config setAllowsCellularAccess:YES]; session = [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:nil]; }); return session; }

हम डाउनलोड शुरू करते हैं (यहां कोई सवाल नहीं उठना चाहिए):

  self.downloadTask = [[self backgroundSession] downloadTaskWithURL:[NSURL URLWithString:@"https://discussions.apple.com/servlet/JiveServlet/showImage/2-20930244-204399/iPhone%2B5%2BProblem2.jpg"]]; [self.downloadTask resume];

पृष्ठभूमि कार्यों के लिए प्रतिनिधि विधि में, छवि को सहेजें और इसे दिखाएं:

 - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location { // save image //   //... // set image if (success) { dispatch_async(dispatch_get_main_queue(), ^{ self.imageView.image = [UIImage imageWithContentsOfFile:[destinationPath path]]; [self.progressView setHidden:YES]; }); } }

सभी कार्यों के अंत के लिए प्रतिनिधि विधि में, हम डाउनलोड के अंत को पकड़ते हैं (इस मामले में, यह और पिछले तरीकों को प्राप्त किया जाएगा)

 - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error { if (error) { NSLog(@"error: %@ - %@", task, error); } else { NSLog(@"success: %@", task); } self.downloadTask = nil; //  ,     [self callCompletionHandlerIfFinished]; }

अब चलिए AppDelegate.m की ओर बढ़ते हैं
डाउनलोड समाप्त होने पर हमें सिस्टम से संदेशों को पकड़ना होगा:

 - (void)application:(UIApplication *)application handleEventsForBackgroundURLSession:(NSString *)identifier completionHandler:(void (^)())completionHandler { //    ,    UILocalNotification* locNot = [[UILocalNotification alloc] init]; locNot.fireDate = [NSDate dateWithTimeIntervalSinceNow:1]; locNot.alertBody = [NSString stringWithFormat:@"still alive!"]; locNot.timeZone = [NSTimeZone defaultTimeZone]; [[UIApplication sharedApplication] scheduleLocalNotification:locNot]; //     -   ,     , //   UI        . //      self.backgroundSessionCompletionHandler = completionHandler; }

हम मुख्य नियंत्रक पर लौटते हैं।
यदि आवश्यक हो तो हम सत्र को बहाल करेंगे:

 - (void)viewDidLoad { [super viewDidLoad]; [self backgroundSession]; }

विधि जिसे बहुत अंत में कहा जाता है:

 - (void)callCompletionHandlerIfFinished { NSLog(@"call completion handler"); [[self backgroundSession] getTasksWithCompletionHandler:^(NSArray *dataTasks, NSArray *uploadTasks, NSArray *downloadTasks) { NSUInteger count = [dataTasks count] + [uploadTasks count] + [downloadTasks count]; if (count == 0) { //    //       //      UI NSLog(@"all tasks ended"); AppDelegate *appDelegate = [[UIApplication sharedApplication] delegate]; if (appDelegate.backgroundSessionCompletionHandler == nil) return; void (^comletionHandler)() = appDelegate.backgroundSessionCompletionHandler; appDelegate.backgroundSessionCompletionHandler = nil; comletionHandler(); } }]; }

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

 Warning: Application delegate received call to - application:handleEventsForBackgroundURLSession:completionHandler: but the completion handler was never called.

इसके अलावा, यदि हम मल्टीटास्किंग मेनू खोलते हैं, तो हम अपने अपडेट किए गए इंटरफ़ेस को नहीं देखेंगे। वास्तव में, यह उदाहरण मल्टीटास्किंग "यूआई" के एक पक्ष को प्रदर्शित करता है जो कि Apple ने हमें बताया था।

यह सब, मुझे उम्मीद है कि यह लेख आपको आगामी परियोजनाओं में NSURLSession का उपयोग करने के लिए प्रोत्साहित करेगा!

क्यों NSURLSession NSURLConnection से बेहतर है