👐🏾 🧑🏼 🛀🏽 राउटर और डेटा पासिंग क्लीन स्विफ्ट आर्किटेक्चर 🚟 👲🏻 🥊

नमस्कार पाठक जी!

पिछले लेख में, मैंने क्लीन स्विफ्ट आर्किटेक्चर के वीआईपी चक्र के बारे में बात की थी। अब हम सबसे महत्वपूर्ण विषयों में से एक पर स्पर्श करेंगे - दृश्यों के बीच डेटा का संक्रमण और हस्तांतरण ।

सिद्धांत

राउटर घटक नेविगेशन और डेटा ट्रांसफर लॉजिक के लिए जिम्मेदार है, जो दृश्य का हिस्सा है (वैकल्पिक रूप से)। यह इंटरएक्टर और प्रस्तुतकर्ता के साथ ViewController में आरंभीकृत है।

राउटर दो प्रोटोकॉल लागू करता है - रूटिंग लोजिक और डेटापासिंग , जिसे हम अपनी कार्यक्षमता से भर देंगे। रूटिंग लोजिक में एक विशिष्ट दृश्य में संक्रमण के लिए जिम्मेदार तरीके शामिल होने चाहिए। DataPassing में चर dataStore होता है , जो प्रोटोकॉल DataStore को संदर्भित करता है। सहभागिता दृश्य डेटास्टोर प्रोटोकॉल को लागू करता है और इसमें संग्रहीत चर के साथ काम करता है। राउटर में ही इसके दृश्य के ViewController का लिंक होता है।

ViewController के लिंक का उपयोग करते हुए, राउटर दृश्यों के बीच कूदता है। ऐसा करने के लिए, आप Segue का उपयोग कर सकते हैं या एक दृश्य बना सकते हैं, जिसे आप एक प्रोग्राम बनाना चाहते हैं, प्रोग्रामेटिक रूप से। किस विधि का उपयोग किया जाता है यह महत्वपूर्ण नहीं है, हमारे लिए मुख्य बात यह है कि व्यूकोट्रॉलर वर्ग के एक उदाहरण के लिए एक लिंक है जिसे हम स्विच कर रहे हैं।

DataStore के लिंक का उपयोग करके हम एक दृश्य के इंटरैक्शनर से उस दृश्य के इंटरएक्टर तक डेटा स्थानांतरित करेंगे, जिसे हम स्थानांतरित कर रहे हैं। और, जैसा कि पहले उल्लेख किया गया है, यह राउटर है जिसे यह जानने की आवश्यकता है कि यह कैसे करना है।

अभ्यास

एक उदाहरण के लिए, हम टेक्स्ट को टेक्स्टफिल्ड से अन्य दृश्य के लेबल पर स्थानांतरित करेंगे। आइए दृश्यों के बीच संक्रमण के दो तरीकों पर विचार करें - सेग के अनुसार और प्रोग्रामिक रूप से।

राउटर वर्ग में विधियों के 3 शब्दार्थ समूह होते हैं:

अनुमार्गण कार्यान्वयन से विधियाँ
नेविगेशन के लिए जिम्मेदार तरीके (नेविगेट करें, बिना सेगमेंट के संक्रमण)
डेटा ट्रांसफर के तरीके (पासडाटा, अगर ट्रांसफर के लिए डेटा है)

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

ओवरडाइडिंग तैयारी (के लिए: प्रेषक :) सेग के साथ काम करते समय वैकल्पिक है। आप इसे कोड से बाहर कर सकते हैं और PerformSegue (withIdentifier: भेजने वाले :) को राउटर विधि में कॉल कर सकते हैं। तैयारी केवल तभी आवश्यक है जब आपको डेटा ट्रांसफर के साथ ही Segue का उपयोग करने की आवश्यकता हो।

final class HomeViewController: UIViewController {
// ...
override func prepare(for segue: UIStoryboardSegue, sender: Any?) {
// Segue
if let scene = segue.identifier {
// , Router
// router?.routeToNAME(segue:)
let selector = NSSelectorFromString("routeTo\(scene)WithSegue:")
// ,
// Segue
if let router = router, router.responds(to: selector) {
router.perform(selector, with: segue)
}
}
}
// ...
}

view raw CleanSwift - ViewController - Router - Prepare.swift hosted with ❤ by GitHub

अब हम आखिरकार सबसे दिलचस्प बात पर आते हैं - राउटर कोड। उदाहरण में टिप्पणियां हैं, इसलिए हम केवल मुख्य बिंदुओं पर विचार करेंगे।

इस राउटर में, हम दो दृश्यों के साथ काम करते हैं - होम और डिटेल । होम दृश्य से संक्रमण भी दो तरह से संभाला जाता है - सेग और प्रोग्राम द्वारा। डेटा को होम सीन से डिटेल सीन में ट्रांसफर कर दिया जाता है।

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

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

उदाहरण में, हमारे पास एक रूटटेटेल (segue :) विधि है। सेग पैरामीटर वैकल्पिक है विधि में एक कार्यान्वयन है जो आपको Segue का उपयोग किए बिना इसे कॉल करने की अनुमति देता है। संक्रमण के दोनों मामलों में, हमें हमारे HomeViewController'a और HomeDataStore'a होम दृश्य के गैर-वैकल्पिक मान मिलते हैं , साथ ही ViewController और DataStore डिटेल दृश्य के लिंक भी मिलते हैं । यहां यह इस तथ्य पर ध्यान देने योग्य है कि डिटीडीएस एक चर है और पास- दाता पैरामीटर (इन-आउट) का उपयोग करके पासडाटाटोडेल विधि से पारित किया जाता है । यह महत्वपूर्ण है क्योंकि बिना इनवॉइस के, हमें सभी DataStore प्रोटोकॉल को "केवल कक्षाओं के साथ लागू करना संभव है" (प्रोटोकॉल DetailDataStore: class) के रूप में चिह्नित करना होगा, और यह मजबूत लिंक कैप्चर करने सहित कई कठिनाइयों को पूरा करता है।

import UIKit
/// @objc
/// prepare View Controller'e
@objc protocol HomeRoutingLogic {
/// Detail View Controller
func routeToDetail(segue: UIStoryboardSegue?)
}
protocol HomeDataPassing {
var dataStore: HomeDataStore? { get }
}
final class HomeRouter: NSObject, HomeRoutingLogic, HomeDataPassing {
// MARK: - Private
// MARK: - Public
weak var viewController: HomeViewController?
var dataStore: HomeDataStore?
// MARK: - HomeRoutingLogic
func routeToDetail(segue: UIStoryboardSegue?) {
if let segue = segue {
//
// Segue
// Detail View Controller
// Data Store Router'e
guard
let homeDS = dataStore,
let detailVC = segue.destination as? DetailViewController,
var detailDS = detailVC.router?.dataStore
else { fatalError("Fail route to detail") }
// , , ,
// ""
passDataToDetail(source: homeDS, destination: &detailDS)
} else {
// ,
// Segue
// Detail View Controller Storyboard'a
// Data Store Router'e
guard
let viewController = viewController,
let homeDS = dataStore,
let storyboard = viewController.storyboard,
let detailVC = storyboard.instantiateViewController(withIdentifier: "Detail") as? DetailViewController,
var detailDS = detailVC.router?.dataStore
else { fatalError("Fail route to detail") }
passDataToDetail(source: homeDS, destination: &detailDS)
// , ""
navigateToDetail(source: viewController, destination: detailVC)
}
}
// MARK: - Navigation
private func navigateToDetail(source: HomeViewController, destination: DetailViewController) {
source.navigationController?.pushViewController(destination, animated: true)
}
// MARK: - Passing data
/// destination inout,
/// Data Store
private func passDataToDetail(source: HomeDataStore, destination: inout DetailDataStore) {
// HomeDataStore DetailDataStore
destination.message = source.message
}
}

view raw CleanSwift - Router - Full.swift hosted with ❤ by GitHub

निष्कर्ष

वह सब है। अंत तक पढ़ने के लिए धन्यवाद! यदि आप कार्रवाई में लेख को आज़माना चाहते हैं तो नीचे मैं परियोजना का लिंक छोड़ दूंगा।

लेखों की श्रृंखला

स्वच्छ स्विफ्ट वास्तुकला अवलोकन
स्वच्छ स्विफ्ट वास्तुकला में राउटर और डेटा पासिंग (आप यहां हैं)
क्लीन स्विफ्ट आर्किटेक्चर के कार्यकर्ता
स्वच्छ स्विफ्ट वास्तुकला में इकाई परीक्षण
एक सरल ऑनलाइन स्टोर आर्किटेक्चर क्लीन स्विफ्ट का एक उदाहरण

प्रोजेक्ट का लिंक
एक लेख लिखने में मदद: बास्टियन

	final class HomeViewController: UIViewController {
	// ...

	override func prepare(for segue: UIStoryboardSegue, sender: Any?) {
	// Segue
	if let scene = segue.identifier {

	// , Router
	// router?.routeToNAME(segue:)
	let selector = NSSelectorFromString("routeTo\(scene)WithSegue:")

	// ,
	// Segue
	if let router = router, router.responds(to: selector) {
	router.perform(selector, with: segue)
	}
	}
	}

	// ...
	}


	import UIKit

	/// @objc
	/// prepare View Controller'e
	@objc protocol HomeRoutingLogic {
	/// Detail View Controller
	func routeToDetail(segue: UIStoryboardSegue?)
	}

	protocol HomeDataPassing {
	var dataStore: HomeDataStore? { get }
	}

	final class HomeRouter: NSObject, HomeRoutingLogic, HomeDataPassing {

	// MARK: - Private

	// MARK: - Public

	weak var viewController: HomeViewController?
	var dataStore: HomeDataStore?

	// MARK: - HomeRoutingLogic

	func routeToDetail(segue: UIStoryboardSegue?) {
	if let segue = segue {
	//
	// Segue

	// Detail View Controller
	// Data Store Router'e
	guard
	let homeDS = dataStore,
	let detailVC = segue.destination as? DetailViewController,
	var detailDS = detailVC.router?.dataStore
	else { fatalError("Fail route to detail") }

	// , , ,
	// ""
	passDataToDetail(source: homeDS, destination: &detailDS)
	} else {
	// ,
	// Segue

	// Detail View Controller Storyboard'a
	// Data Store Router'e
	guard
	let viewController = viewController,
	let homeDS = dataStore,
	let storyboard = viewController.storyboard,
	let detailVC = storyboard.instantiateViewController(withIdentifier: "Detail") as? DetailViewController,
	var detailDS = detailVC.router?.dataStore
	else { fatalError("Fail route to detail") }

	passDataToDetail(source: homeDS, destination: &detailDS)

	// , ""
	navigateToDetail(source: viewController, destination: detailVC)
	}
	}

	// MARK: - Navigation

	private func navigateToDetail(source: HomeViewController, destination: DetailViewController) {
	source.navigationController?.pushViewController(destination, animated: true)
	}

	// MARK: - Passing data

	/// destination inout,
	/// Data Store
	private func passDataToDetail(source: HomeDataStore, destination: inout DetailDataStore) {

	// HomeDataStore DetailDataStore
	destination.message = source.message
	}
	}

राउटर और डेटा पासिंग क्लीन स्विफ्ट आर्किटेक्चर

सिद्धांत

अभ्यास

निष्कर्ष

लेखों की श्रृंखला

More articles: