स्विफ्ट 3 में iOS में एपीआई के माध्यम से सर्वर के साथ सहभागिता 3. भाग 1

यह लेख लेख का एक अपडेट है iOS में दूरस्थ डेटा प्राप्त करना , नवंबर 2015 में ऑब्जेक्टिव-सी का उपयोग करके लिखा गया और इसलिए नैतिक रूप से अप्रचलित है। अब, कोड दिया जाएगा जो कि स्विफ्ट 3 और आईओएस 10 में फिर से लिखा गया है (नवीनतम संस्करण स्विफ्ट 4.1 और आईओएस 11 है, लेकिन मेरा कंप्यूटर अब उनका समर्थन नहीं करता है)।

संक्षिप्त सिद्धांत

यूआरएल प्रारूप

http://www.google.com/?q=Hello&safe=off 

• http एक प्रोटोकॉल है जो यह निर्धारित करता है कि अनुरोध किस मानक से किया गया है। अधिक विकल्प: https, ftp, file
• www.google.com - डोमेन नाम
• / - निर्देशिका जहां हमें जिन संसाधनों की आवश्यकता होती है वे स्थित हैं।
• प्रश्नवाचक चिह्न (?) के बाद पैरामीटर q = नमस्ते और सुरक्षित = बंद पर जाएं। इनमें की-वैल्यू पेयर होते हैं।
• अनुरोध एक विधि को भी इंगित करता है जो बताता है कि सर्वर को इस अनुरोध को कैसे संभालना चाहिए। डिफ़ॉल्ट रूप से, यह एक GET विधि है।

उदाहरण से इस url को निम्न प्रकार से पढ़ा जा सकता है: GET विधि के साथ एक http अनुरोध google.com को रूट निर्देशिका में, दो q मापदंडों के साथ हैलो और सुरक्षित के साथ भेजा जाता है।

http हैडर

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

 GET /?q=Hello&safe=off HTTP/1.1 Host: google.com Content-Length: 133 //    //     

सर्वर अनुरोध आरेख

सबसे पहले, एक अनुरोध बनाया जाता है, फिर एक कनेक्शन स्थापित किया जाता है, एक अनुरोध भेजा जाता है और एक प्रतिक्रिया प्राप्त होती है।

सत्र प्रतिनिधि

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

जैसा कि मूल पुस्तक में, हम एक प्रतिनिधि का उपयोग करते हैं ताकि संचालन अधिक स्पष्ट रूप से तरीकों के बीच विभाजित हो। हालांकि कोड ब्लॉक के माध्यम से अधिक कॉम्पैक्ट है।

सत्र प्रतिनिधियों के प्रकारों का विवरण

हम NSURLSessionDownloadDelegate का उपयोग करते हैं और इसके तरीके को लागू करते हैं URLSession: downloadTask: didFinishDownloadingToURL ।। यही है, वास्तव में, हम एक मज़ाक के साथ डेटा को एक अस्थायी भंडारण में डाउनलोड करते हैं, और जब डाउनलोड पूरा हो जाता है, तो हम प्रसंस्करण के लिए प्रतिनिधि विधि कहते हैं।

मुख्य धारा में संक्रमण

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

भगोड़ा बंद (@ बच)

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

पुनर्निर्देश (पुनर्निर्देश)

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

सीरियलाइजेशन स्कीम

सीरियलाइज़ेशन सामग्री के नुकसान के बिना डेटा को एक प्रकार के भंडारण से दूसरे में स्थानांतरित करने की प्रक्रिया है। उदाहरण के लिए, डेटा को कम जगह लेने के लिए बाइनरी फॉर्म में संग्रहीत किया जाता है, और जब एक नेटवर्क पर भेजा जाता है, तो इसे एक सार्वभौमिक JSON (जावास्क्रिप्ट ऑब्जेक्ट नोटेशन) प्रारूप में बदल दिया जाता है, जिसे हम पहले से ही अपने प्रोग्रामिंग वातावरण में वस्तुओं में डिक्रिप्ट और अनुवाद करते हैं।

JSON उदाहरण:

 { "name": "Martin Conte Mac Donell", "age": 29, "username": "fz" } 

घुंघराले कोष्ठक एक शब्दकोश को निरूपित करते हैं, और शब्दकोश के अंदर की वस्तुओं को मुख्य-मूल्य वाले जोड़े द्वारा दर्शाया जाता है।

एपीआई (एप्लीकेशन प्रोग्रामिंग इंटरफ़ेस)

हमारे मामले में, एपीआई को उस पते से दर्शाया जाता है जहां से हम यादृच्छिक चुटकुले और JSON प्रतिक्रिया प्रारूप प्राप्त करेंगे, जिसे हमें हेरफेर के लिए सुविधाजनक संरचनाओं में पार्स करना होगा।

 http://api.icndb.com/jokes/random 

उदाहरण icndb एपीआई:

 { "type": "success", "value": { "id": 201, "joke": "Chuck Norris was what Willis was talkin' about" } } 

अब अभ्यास करें

पूरी परियोजना, पिछली बार की तरह, एक स्टोरीबोर्ड का उपयोग किए बिना, कोड में लागू की गई है। सभी कोड 3 फ़ाइलों में लिखे गए हैं: AppDelegate.swift , MainViewController.swift और HTTPCommunication.swift । AppDelegate.swift में एप्लिकेशन का सामान्य कॉन्फ़िगरेशन है। HTTPCommunication.swift कनेक्शन (अनुरोध, सत्र) को कॉन्फ़िगर करता है और डेटा प्राप्त करता है। MainViewController.swift में, यह डेटा आउटपुट के लिए क्रमबद्ध है, और इसमें यूजर इंटरफेस कोड भी है।

एक खाली प्रोजेक्ट बनाएं। सादगी के लिए, हम केवल iPhone के लिए एक आवेदन लिख रहे हैं। हम ViewController.swift , Main.storyboard को हटाते हैं और Info.plist में हम स्टोरीबोर्ड के लिंक को भी हटा देते हैं, जिसका नाम है लाइन मेन स्टोरीबोर्ड फ़ाइल बेस नाम - स्ट्रिंग - मेन ।

डिफ़ॉल्ट रूप से, iOS पर ऐप ट्रांसपोर्ट सिक्योरिटी नियमित http (https नहीं) का उपयोग करके इंटरनेट से डाउनलोड को ब्लॉक करता है, इसलिए हम नीचे दिखाए गए अनुसार Info.plist में परिवर्तन करते हैं। ऐसा करने के लिए, Info.plist को स्रोत कोड के रूप में खोलें, फिर निम्न कोड जोड़ें:

 <key>NSAppTransportSecurity</key> <dict> <key>NSAllowsArbitraryLoads</key> <false/> <key>NSExceptionDomains</key> <dict> <key>api.icndb.com</key> <dict> <key>NSExceptionAllowsInsecureHTTPLoads</key> <true/> <key>NSIncludesSubdomains</key> <true/> </dict> </dict> </dict> 

हम, डिफ़ॉल्ट रूप से, मनमाने डाउनलोड पर रोक लगाते हैं: NSAllowsArbiteathLoads कुंजी गलत है। लेकिन हम एक अपवाद के रूप में हमारे डोमेन को चुटकुले और सभी उप डोमेन के साथ जोड़ते हैं: प्रमुख मान NSExceptionDomains।

अब AppDelegate.swift में हम एप्लिकेशन को फिर से लिखते हैं (_: didFinishLaunchingWithOptions :) जैसे:

 func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool { self.window = UIWindow(frame: UIScreen.main.bounds) //  MainViewController   NavigationController, //     . let navC: UINavigationController = UINavigationController(rootViewController: MainViewController()) self.window?.rootViewController = navC self.window?.backgroundColor = UIColor.white self.window?.makeKeyAndVisible() return true } 

HTTPCommunication.swift फ़ाइल बनाएँ। और हम इसमें निम्न कोड लिखते हैं।

 import UIKit //   NSObject,   (conform) NSObjectProtocol, //   URLSessionDownloadDelegate    , //     ,     . class HTTPCommunication: NSObject { //  completionHandler   -  ,   //           //    . var completionHandler: ((Data) -> Void)! // retrieveURL(_: completionHandler:)    //  url    func retrieveURL(_ url: URL, completionHandler: @escaping ((Data) -> Void)) { } } //    ,    NSObject //  (conforms)  URLSessionDownloadDelegate, //        //  . extension HTTPCommunication: URLSessionDownloadDelegate { //        //         . func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didFinishDownloadingTo location: URL) { } } 

अब हम इन फ़ंक्शन का कोड लिखेंगे।

कोड पुनः प्राप्त करें (_ url:, पूरा करने वाला :)

 //        , //     @escaping. func retrieveURL(_ url: URL, completionHandler: @escaping ((Data) -> Void)) { self.completionHandler = completionHandler let request: URLRequest = URLRequest(url: url) let session: URLSession = URLSession(configuration: .default, delegate: self, delegateQueue: nil) let task: URLSessionDownloadTask = session.downloadTask(with: request) //        , //   . task.resume() } 

कोड की प्रतिलिपि बनाएं urlSession (_ सत्र:, डाउनलोड करें:, didFinishDownloadingTo :)

 func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didFinishDownloadingTo location: URL) { do { //         //  .      // ,   try,     //   do {} catch {} let data: Data = try Data(contentsOf: location) //    completionHandler   . //         , //     ,    //  ,       . DispatchQueue.main.async(execute: { self.completionHandler(data) }) } catch { print("Can't get data from location.") } } 

हम MainViewController.swift फ़ाइल बनाते हैं और निम्न कोड की प्रतिलिपि बनाते हैं, जो आवश्यक इंटरफ़ेस बनाता है:

 import UIKit class MainViewController: UIViewController { lazy var jokeLabel: UILabel = { let label: UILabel = UILabel(frame: CGRect.zero) label.lineBreakMode = .byWordWrapping label.textAlignment = .center label.numberOfLines = 0 label.font = UIFont.systemFont(ofSize: 16) label.sizeToFit() self.view.addSubview(label) return label }() //       . var jokeID: Int = 0 // ActivityView   ,    //  ,   . lazy var activityView: UIActivityIndicatorView = { let activityView: UIActivityIndicatorView = UIActivityIndicatorView(activityIndicatorStyle: .gray) activityView.hidesWhenStopped = true activityView.startAnimating() view.addSubview(activityView) return activityView }() lazy var stackView: UIStackView = { let mainStackView: UIStackView = UIStackView(arrangedSubviews: [self.jokeLabel]) //        mainStackView.spacing = 50 mainStackView.axis = .vertical mainStackView.distribution = .fillEqually self.view.addSubview(mainStackView) return mainStackView }() override func viewDidLoad() { super.viewDidLoad() self.title = "Chuck Norris Jokes" //     stackView  activityView, //      . //     stackView  //    label. self.configConstraints() // (E.2) //        //     . self.retrieveRandomJokes() // (E.3) } func retrieveRandomJokes() { } } extension MainViewController { func configConstraints() { //   autoresizingMask  (constraints) //  false,        //  self.stackView.translatesAutoresizingMaskIntoConstraints = false NSLayoutConstraint.activate([ self.stackView.centerYAnchor.constraint(equalTo: self.view.centerYAnchor), self.stackView.leadingAnchor.constraint(equalTo: self.view.layoutMarginsGuide.leadingAnchor), self.stackView.trailingAnchor.constraint(equalTo: self.view.layoutMarginsGuide.trailingAnchor) ]) self.activityView.translatesAutoresizingMaskIntoConstraints = false //    (constraints)  activityView, //      label:   X  Y  //  label  X  Y. NSLayoutConstraint.activate([ self.activityView.centerXAnchor.constraint(equalTo: self.jokeLabel.centerXAnchor), self.activityView.centerYAnchor.constraint(equalTo: self.jokeLabel.centerYAnchor) ]) } } 

हमने इंटरफ़ेस का पता लगाया, अब आप कार्यक्षमता में भर सकते हैं।

यहाँ पुनः प्राप्त हैवृद्धिमान जोक्स () कोड

 func retrieveRandomJokes() { let http: HTTPCommunication = HTTPCommunication() //     url  ,    force unwrap  //  url ,      let url: URL = URL(string: "http://api.icndb.com/jokes/random")! http.retrieveURL(url) { //    self  ,  weak self [weak self] (data) -> Void in //      json // ,  ,     .  //     json   , //     . guard let json = String(data: data, encoding: String.Encoding.utf8) else { return } //  : JSON: { "type": "success", "value": // { "id": 391, "joke": "TNT was originally developed by Chuck // Norris to cure indigestion.", "categories": [] } } print("JSON: ", json) do { let jsonObjectAny: Any = try JSONSerialization.jsonObject(with: data, options: []) // ,       Any //    ,    . guard let jsonObject = jsonObjectAny as? [String: Any], let value = jsonObject["value"] as? [String: Any], let id = value["id"] as? Int, let joke = value["joke"] as? String else { return } //     , //       . self.activityView.stopAnimating() self.jokeID = id self.jokeLabel.text = joke } catch { print("Can't serialize data.") } } } 

अब एप्लिकेशन को चलाएं और निम्नलिखित परिणाम प्राप्त करें।

जबकि हम साइट से मजाक का इंतजार कर रहे हैं।



अंत में, मजाक को लोड और प्रदर्शित किया जाता है।



अगले लेख में, हम स्विफ्ट में फिर से लिखे गए एप्लिकेशन के दूसरे भाग को देखेंगे, जो आपको प्रोग्राम को फिर से शुरू किए बिना नए चुटकुले प्राप्त करने की अनुमति देता है, साथ ही चुटकुले के लिए वोट देता है।