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

यह लेख स्विफ्ट 3 पर आईओएस में एक एपीआई के माध्यम से सर्वर के साथ बातचीत करने वाले लेख का एक हिस्सा है। भाग 1 और स्विफ्ट 3 पर ऑब्जेक्टिव-सी में लिखे गए एक पुराने लेख को अपडेट करना है।

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

अनुरोध प्राप्त करें

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

पोस्ट अनुरोध

POST URL को आगे की प्रक्रिया के लिए डेटा भेजता है। पैरामीटर GET के समान प्रारूप का उपयोग करके अनुरोध निकाय में शामिल किए गए हैं। उदाहरण के लिए, यदि हम दो फ़ील्ड, एक नाम और एक आयु वाले फ़ॉर्म को पोस्ट करना चाहते हैं, तो हम अनुरोध बॉडी में नाम = मार्टिन और उम्र = 29 के समान कुछ भेजेंगे।

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

हमारे आवेदन में, हम चुटकुले को रैंक करने के लिए POST का उपयोग करते हैं। हम रिमोट सर्वर पर वोट (या +1, या -1) भेजेंगे।

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

W3C मानक नियमों को परिभाषित करता है जो परिभाषित करता है कि प्रत्येक मामले के लिए एक पहचानने योग्य प्रतिनिधित्व क्या है। हमारे मामले में, हमें मानक के फॉर्म-यूआरएल-एन्कोडेड भाग (उदाहरण के लिए, param1 = var1 & param2 = var2) के बाद मापदंडों को प्रस्तुत करने की आवश्यकता है।

WebView

प्रोग्रामिंग भाषा टूल का उपयोग करके, हम दूरस्थ सर्वर को अनुरोध भेज सकते हैं। वेब पेज प्रदर्शित करने से पहले ब्राउजर्स यही करते हैं। अंतर केवल उत्तर की सामग्री में है। HTML मानक का उपयोग करके वेब पेज तैयार किए जाते हैं, जो विभिन्न मार्कअप टैग को रेखांकन करने के लिए नियमों के एक सेट को परिभाषित करता है। ये नियम सरल प्रतीत होते हैं, लेकिन W3C मानक का पालन करते हुए पूरे पृष्ठ को प्रदर्शित करना एक कठिन कार्य है। सौभाग्य से, iOS में एक अंतर्निहित UIWebView घटक है जो प्रसिद्ध WebKit इंजन का उपयोग करता है और HTML / CSS / जावास्क्रिप्ट की व्याख्या करता है और एक UIView के अंदर पूरे वेब पेज प्रदर्शित करता है।

ऐसे कई मामले हैं जहां हम नेविगेशन के प्रवाह को नियंत्रित करना चाहते हैं। उदाहरण के लिए, हम यह जानना चाहते हैं कि कुछ सामग्री या विशिष्ट URL कब लोड किया गया है।

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

webView:shouldStartLoadWithRequest:navigationType: webViewDidStartLoad: webViewDidFinishLoad: webView:didFailLoadWithError: 

पहली विधि का उपयोग करके, हम विशिष्ट अनुरोधों को अनुमति या अवरुद्ध करके नेविगेशन के प्रवाह को नियंत्रित कर सकते हैं। अन्य तीन विधियाँ सूचनात्मक घटनाएँ हैं (विधि नाम घटना का अच्छा विचार देते हैं)।

POST अनुरोध के माध्यम से मतदान का कार्यान्वयन

हम MainViewController.swift और HTTPCommunication.swift फ़ाइलों को जोड़ेंगे , और एक नई WebViewController.swift फ़ाइल बनाएँ, जिसमें हम अपने webView को परिभाषित करते हैं।

सबसे पहले, एक नया WebViewController.swift फ़ाइल बनाएं और उसमें WebViewController क्लास को परिभाषित करें:

WebViewController.swift

 import UIKit class WebViewController: UIViewController { } extension WebViewController { } 

अब हम अपने सभी HTTP संचालन के लिए जिम्मेदार वर्ग में POST अनुरोध करने के लिए कार्यक्षमता को कार्यान्वित करते हैं: HTTPCommunication वर्ग। ऐसा करने के लिए, HTTPCommunication.swift में एक नया पोस्टर्ल (_: params: पूर्णहैंडलर :) विधि जोड़ें, जो पिछले पुनर्प्राप्ति के समान है (_: पूर्णहैंडलर :) विधि।

HTTPCommunication.swift

 class HTTPCommunication: NSObject { … func retrieveURL(_ url: URL, completionHandler: @escaping ((Data) -> Void)) { … } // TODO:    } // end of class HTTPCommunication 

विधि कोड

 func postURL(_ url: URL, params: [String: Int], completionHandler: @escaping ((Data) -> Void)) { // (K.1) self.completionHandler = completionHandler // (K.2) func postBody(params: [String: Int]) -> Data? { // (K.3) var paramsArr: [String] = [] for (key, value) in params { paramsArr.append("\(key)=\(value)") } let postBodyString: String = paramsArr.joined(separator: "&") let postBodyData: Data? = postBodyString.data(using: .utf8) return postBodyData } var request: URLRequest = URLRequest(url: url) // (K.4) request.httpMethod = "POST" request.httpBody = postBody(params: params) let session: URLSession = URLSession(configuration: .default, delegate: self, delegateQueue: nil) // (K.5) let task: URLSessionDownloadTask = session.downloadTask(with: request) task.resume() } 

(K.1) बंद होने के साथ, हम इस फ़ंक्शन के बाहर काम करेंगे, इसलिए हम इसे @ से बचते हैं।
(K.2) हम पूर्ण बंदहैंडलर संपत्ति में पारित बंद को संग्रहीत करते हैं।
(K.3) हम एक विधि लिखते हैं जो पारित मापदंडों के शब्दकोश को स्ट्रिंग रूप में परिवर्तित करती है, और फिर इस स्ट्रिंग को utf8 एन्कोडिंग में डेटा प्रकार में एनकोड करती है।
(K.4) हम उत्तीर्ण url के साथ एक अनुरोध बनाते हैं और इसे कॉन्फ़िगर करते हैं: POST को विधि के रूप में सेट करते हैं, और utf8 के साथ डेटा प्रकार के हमारे पैरामीटर को अनुरोध निकाय के रूप में बनाते हैं।
(K.5) अंत में, डिफ़ॉल्ट कॉन्फ़िगरेशन और स्वयं के रूप में एक प्रतिनिधि के साथ एक सत्र बनाएं। और हम इस अनुरोध के परिणाम को अस्थायी भंडारण में लोड करने के लिए एक कार्य बनाते हैं। अंत में, कार्य को डीफ्रॉस्ट करें।

अब हम MainViewController.swift में आवश्यक इंटरफ़ेस जोड़ते हैं। वोटिंग के लिए दो बटन जोड़ें वोटअप और वोटडाउन, जो क्रमशः वर्तमान मजाक की रेटिंग को बढ़ाएगा या घटाएगा। हम "चक कौन?" बटन भी जोड़ते हैं, जिसे हम वेब दृश्य पर अनुभाग में कार्यक्षमता से भर देंगे।

MainViewController.swift में, इनिशियलाइज़ेशन कोड votUpButton, वोटडाउनबटन और chuckWhoButton डालें।

MainViewController.swift

 lazy var jokeLabel: UILabel! = … var jokeID: Int! lazy var activityView: UIActivityIndicatorView! = … //TODO:    lazy var stackView: UIStackView! = … 

बटन प्रारंभिक कोड

 lazy var voteUpButton: UIButton! = { // (L.1) let button: UIButton = UIButton(type: .system) // (L.2) button.setTitle("Vote Up", for: .normal) button.sizeToFit() button.addTarget(self, action: #selector(self.voteUp), for: .touchUpInside) // (L.3) self.view.addSubview(button) // (L.4) return button // (L.5) }() lazy var voteDownButton: UIButton! = { let button: UIButton = UIButton(type: .system) button.setTitle("Vote Down", for: .normal) button.sizeToFit() button.addTarget(self, action: #selector(self.voteDown), for: .touchUpInside) self.view.addSubview(button) return button }() lazy var chuckWhoButton: UIButton! = { let button: UIButton = UIButton(type: .system) button.setTitle("Chuck Who?", for: .normal) button.sizeToFit() button.addTarget(self, action: #selector(self.chuckWho), for: .touchUpInside) self.view.addSubview(button) return button }() 

तीनों बटन के लिए इनिशियलाइज़ेशन कोड समान है।

(एल। 1) हम एक आलसी चर घोषित करते हैं और इसे बंद करने के साथ शुरू करते हैं।
(L.2) क्लोजर के अंदर, हम बटन के लिए एक स्थानीय चर को परिभाषित करते हैं, एक सिस्टम प्रकार, नाम और आकार निर्दिष्ट करते हैं।
(L.3) हम बटन के साथ संबंधित कार्रवाई जब दबाया जाता है।
(L.4) दृश्य पदानुक्रम में जोड़ें।
(L.5) और हम इस स्थानीय वैरिएबल को हमारे आलसी वेरिएबल को असाइन करते हैं।

इसके बाद, MainViewController.swift में, बटन के लिए विधि कोड डालें

MainViewController.swift

 class MainViewController: UIViewController { … func retrieveRandomJokes() { … } // TODO:    } // end of class MainViewController 

बटन के लिए विधि कोड

 func voteUp() { let http: HTTPCommunication = HTTPCommunication() // (M.1) let params: [String: Int] = ["joke_id": self.jokeID, "vote": 1] // (M.2) if let url = URL(string: "http://example.com/rater/vote") { // (M.3) http.postURL(url, params: params) { (data) in // (M.4) print("\(data). Voted Up") } } } func voteDown() { let http: HTTPCommunication = HTTPCommunication() let params: [String: Int] = ["joke_id": self.jokeID, "vote": -1] if let url = URL(string: "http://example.com/rater/vote") { http.postURL(url, params: params) { (data) in print("\(data). Voted Down") } } } func chuckWho() { } 

ऊपर और नीचे मतदान करने के तरीकों का कोड समान है।

(M.1) सर्वर के साथ संचार के लिए एक क्लास ऑब्जेक्ट बनाएं।
(M.2) हम उन मापदंडों का एक शब्दकोश बनाते हैं, जिसमें हमारे द्वारा मतदान किए जाने वाले मजाक की आईडी शामिल होती है, और वोट का वास्तविक मूल्य +1 या -1 होता है।
(M.3) अगला, हम सुरक्षित रूप से अपने प्रशिक्षण डोमेन http://example.com/rater/vote. के एड्रेस बार से url प्राप्त करते हैं http://example.com/rater/vote.
(M.4) और हम POST के माध्यम से अपने मापदंडों के लिए एक अनुरोध भेजते हैं। और कंसोल को प्रिंट करें जो अनुरोध पूरा होने का संकेत देता है।

इसके बाद, MainViewController.swift में हम UI को किए गए परिवर्तनों को ध्यान में रखते हुए, configStackView विधि के कोड को फिर से लिखते हैं।

MainViewController.swift

 func configStackView() -> UIStackView { let innerStackView: UIStackView = UIStackView(arrangedSubviews: [self.voteUpButton, self.voteDownButton]) // (N.1) innerStackView.axis = .horizontal // (N.2) innerStackView.distribution = .fillEqually let mainStackView: UIStackView = UIStackView(arrangedSubviews: [self.jokeLabel, innerStackView, self.chuckWhoButton]) // (N.3) mainStackView.spacing = 50 // (N.4) mainStackView.axis = .vertical mainStackView.distribution = .fillEqually self.view.addSubview(mainStackView) // (N.5) return mainStackView } 

(N.1) वोटिंग के लिए इनरस्टैक व्यू बनाएं जिसमें दो बटन हों।
(एन। 2) हम ऊर्ध्वाधर अक्ष को उजागर करते हैं; वितरण समान है।
(N.3) मुख्य मेनस्टैक व्यू में, इनरस्टैक व्यू और चक नॉरिस के बारे में बटन को पिछले भाग से लेबल में जोड़ें।
(N.4) मेनस्टैक व्यू कॉन्फ़िगर करें।
(N.5) मेनस्टैक व्यू को पदानुक्रम में जोड़ें।

हम अपना एप्लिकेशन लॉन्च करते हैं और इंटरफ़ेस को अंजीर में देखते हैं। 1


अंजीर। 1 मतदान के लिए जोड़ा बटन के साथ हमारे आवेदन का इंटरफ़ेस

हम यह सत्यापित करते हैं कि जब मजाक के लिए या उसके खिलाफ मतदान किया जाता है, तो निम्न संदेश कंसोल में प्रदर्शित होते हैं:

345 bytes. Voted Up

या

345 bytes. Voted Down

जो सर्वर पर सफलतापूर्वक पूर्ण किए गए POST अनुरोध को इंगित करता है।

हमने icndb API और GET HTTP वर्ब का उपयोग करके एक मजाकिया आवेदन लिखा है। हम UIView पर इन चुटकुलों को दिखाने में सक्षम थे और हर मजाक की सराहना की जा सकती है। ये क्रियाएं दूरस्थ सर्वर पर एक POST अनुरोध भेजती हैं, जिससे हमारा अनुमान बचाना चाहिए।

वेब पेज प्रदर्शित करने के लिए webViews का उपयोग करना

हम चक नॉरिस के बारे में विकिपीडिया पृष्ठ प्रदर्शित करने के लिए एक वेब व्यू जोड़ रहे होंगे। वह एक बटन के स्पर्श में भ्रमित हो जाता है।

WebViewController.swift फ़ाइल में, निम्न फ़ंक्शन स्टब लिखें:

WebViewController.swift

 import UIKit class WebViewController: UIViewController { lazy var webView: UIWebView = { // (O.1) self.configWebView() }() lazy var toolbar: UIToolbar = { // (O.2) self.configToolbar() }() override func viewDidLoad() { super.viewDidLoad() } func back() { // (O.3) self.webView.goBack() } func forward() { self.webView.goForward() } } extension WebViewController { func configWebView() -> UIWebView { // (O.4) } func configToolbar() -> UIToolbar { // (O.5) } func configConstraints() { // (O.6) } } 

(O.1) हम webView के लिए आलसी चर बनाते हैं
(O.2) और टूलबार।
(O.3) हम लिंक पर जाने के इतिहास पर नेविगेशन के लिए आगे और पीछे के तरीके बनाते हैं।
(O.4) हम एक्सटेंशन में webView आरंभीकरण विधियों को जोड़ते हैं
(O.5) और टूलबार
(O.6) और इंटरफ़ेस के लिए बाधा।

अब हम प्रत्येक फ़ंक्शन के कोड को पेंट करते हैं:

 func configWebView() -> UIWebView { let webView: UIWebView = UIWebView() // (P.1) self.view.addSubview(webView) return webView } 

(P.1) हम वेब व्यू को इनिशियलाइज़ करते हैं और पदानुक्रम में दृश्य जोड़ते हैं।

 func configToolbar() -> UIToolbar { let toolbar: UIToolbar = UIToolbar(frame: CGRect.zero) // (Q.1) let backButton: UIBarButtonItem = UIBarButtonItem(title: "<", style: .plain, target: self, action: #selector(self.back)) // (Q.2) let forwardButton: UIBarButtonItem = UIBarButtonItem(title: ">", style: .plain, target: self, action: #selector(self.forward)) toolbar.setItems([backButton, forwardButton], animated: false) // (Q.3) toolbar.backgroundColor = UIColor.lightGray // (Q.4) self.view.addSubview(toolbar) return toolbar } 

(Q.1) शून्य फ्रेम वाला टूलबार बनाएं।
(Q.2) हम आने वाले लिंक के इतिहास को नेविगेट करने के लिए दो बटन बनाते हैं। नाम के साथ "<" और ">" और क्रियाएँ वेब दृश्य में संबंधित विधि से जुड़ी हुई हैं।
(Q.3) इन बटनों को टूलबार में जोड़ें।
(Q.4) बैकग्राउंड कलर को सेट करें, जैसे नेविगेशनबार, लाइट ग्रे। और पदानुक्रम में दृश्य जोड़ें।

 func configConstraints() { self.webView.translatesAutoresizingMaskIntoConstraints = false // (R.1) NSLayoutConstraint.activate([ // (R.2) self.webView.topAnchor.constraint(equalTo: self.topLayoutGuide.topAnchor), self.webView.leadingAnchor.constraint(equalTo: self.view.leadingAnchor), self.webView.trailingAnchor.constraint(equalTo: self.view.trailingAnchor), self.webView.bottomAnchor.constraint(equalTo: self.toolbar.topAnchor) ]) self.toolbar.translatesAutoresizingMaskIntoConstraints = false NSLayoutConstraint.activate([ // (R.3) self.toolbar.leadingAnchor.constraint(equalTo: self.view.leadingAnchor), self.toolbar.trailingAnchor.constraint(equalTo: self.view.trailingAnchor), self.toolbar.bottomAnchor.constraint(equalTo: self.view.bottomAnchor), self.toolbar.heightAnchor.constraint(equalToConstant: 44.0) ]) } 

(R.1) ऑटोराइज़िंग मास्क को अक्षम करें ताकि वे हमारे अवरोधों के साथ संघर्ष न करें
(R.2) वेब व्यू के लिए, दृश्य के सभी चार पक्षों को कॉन्फ़िगर करें।
(R.3) टूलबार के लिए, शीर्ष के अलावा, दृश्य के तीन किनारों को कॉन्फ़िगर करें, लेकिन इसके अलावा ऊंचाई को मानक 14.0 पर सेट करें।

और कोड ViewDidLoad () को निम्नानुसार फिर से लिखें:

 override func viewDidLoad() { super.viewDidLoad() self.configConstraints() // (S.1) if let url = URL(string: "http://en.wikipedia.org/wiki/Chuck_Norris") { // (S.2) let request: URLRequest = URLRequest(url: url) // (S.3) self.webView.loadRequest(request) // (S.4) } } 

(एस .१) बाधाओं की स्थापना को आमंत्रित करें।
(S.2) विकिपीडिया पृष्ठ en.wikipedia.org/wiki/Chuck_Norris के एड्रेस बार से सुरक्षित रूप से यूआरएल प्राप्त करें
(S.3) हम url से अनुरोध बनाते हैं।
(S.4) और हम webView में दिए गए अनुरोध को निष्पादित करते हैं।

हम MainViewController पर लौटते हैं और इसे चक नॉरिस के बारे में जानकारी देने की विधि से भरते हैं।

MainViewController.swift

 func chuckWho() { self.navigationController?.show(WebViewController(), sender: self) // (T.1) } 

(T.1) जब आप नेविगेशनकंट्रोलर स्टैक पर इस बटन को क्लिक करते हैं, तो वेब व्यू का एक नया उदाहरण डालें।

अंजीर। 2 दर्शाता है कि वेबव्यू हमारे आवेदन में कैसा दिखता है।


अंजीर। 2. वेब व्यू का अंतिम दृश्य हमने लागू किया है