👨🏼‍🎓 👨‍⚖️ 🏂🏽 स्वच्छ स्विफ्ट वास्तुकला अवलोकन 🎏 🌧️ 🍨

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

इस लेख में मैं iOS एप्लिकेशन के आर्किटेक्चर के बारे में बात करूंगा - क्लीन स्विफ्ट । हम मुख्य सैद्धांतिक बिंदुओं पर विचार करेंगे और व्यवहार में एक उदाहरण का विश्लेषण करेंगे।

सिद्धांत

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

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

राय

स्टोरीबोर्ड, XIB, या UI तत्व कोड के माध्यम से लिखे गए हैं।

ViewController

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

Interactor

इसमें दृश्य का व्यावसायिक तर्क होता है।

यह नेटवर्क, डेटाबेस और डिवाइस मॉड्यूल के साथ काम करता है।

इंटरएक्टर ViewController (डेटा या खाली) के साथ एक अनुरोध प्राप्त करता है, इसे संसाधित करता है और यदि आवश्यक हो, तो प्रस्तुतकर्ता के लिए नया डेटा स्थानांतरित करता है।

प्रस्तुतकर्ता

वह प्रदर्शन के लिए डेटा तैयार करने में लगे हुए हैं।

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

मॉडल

वीआईपी चक्र के घटकों के बीच डेटा स्थानांतरित करने के लिए संरचनाओं का एक सेट। चक्र के प्रत्येक वृत्त में 3 प्रकार की संरचनाएँ हैं:

अनुरोध - ViewController से इंटरेक्टर में स्थानांतरण के लिए डेटा संरचना (TextField से पाठ, आदि)
उत्तर - इंटरेक्टर से प्रस्तुतकर्ता में स्थानांतरण के लिए डेटा के साथ संरचना (नेटवर्क से डाउनलोड किया गया, आदि)
ViewModel - ViewController में वापस स्थानांतरित करने के लिए प्रस्तुतकर्ता में संसाधित डेटा (पाठ स्वरूपण, आदि) के साथ संरचना

मज़दूर

यदि इंटरप्रेनर तेजी से बढ़ रहा है, तो एप्लिकेशन के व्यावसायिक तर्क का एक हिस्सा उतारता है।

आप ऐसे श्रमिक भी बना सकते हैं जो सभी दृश्यों के लिए सामान्य हों, यदि उनकी कार्यक्षमता का उपयोग कई दृश्यों में किया जाता है।

एक उदाहरण के रूप में, वर्कर में, आप नेटवर्क या डेटाबेस के साथ काम करने का तर्क बना सकते हैं।

रूटर

राउटर के बीच बदलाव और डेटा ट्रांसफर के लिए जिम्मेदार सभी तर्क राउटर में लिए गए हैं ।

वीआईपी चक्र की तस्वीर को स्पष्ट करने के लिए, मैं एक मानक उदाहरण देता हूं - प्राधिकरण।

उपयोगकर्ता ने अपना उपयोगकर्ता नाम और पासवर्ड दर्ज किया, प्राधिकरण बटन पर क्लिक किया
ViewController IBAction आग लगाता है, जिसके बाद TextFields, (मॉडल>>) में दर्ज उपयोगकर्ता डेटा के साथ एक संरचना बनाई जाती है
निर्मित संरचना इंटरचोर में भ्रूण विधि के लिए पारित की जाती है
इंटरेक्टर नेटवर्क को एक अनुरोध भेजता है और प्राधिकरण की सफलता के बारे में प्रतिक्रिया प्राप्त करता है
प्राप्त आंकड़ों के आधार पर, परिणाम के साथ एक संरचना बनाता है (मॉडल -> प्रतिक्रिया) और प्रस्तुतकर्ता विधि में प्रस्तुतकर्ता विधि से पारित किया जाता है।
प्रस्तुतकर्ता आवश्यकतानुसार डेटा को स्वरूपित करता है और उन्हें लौटाता है (मॉडल -> ViewModel) ViewController में प्रदर्शन विधि के लिए।
ViewController उपयोगकर्ता को प्राप्त डेटा प्रदर्शित करता है। प्राधिकरण के मामले में, एक त्रुटि प्रदर्शित हो सकती है या राउटर का उपयोग करके किसी अन्य दृश्य को संक्रमण शुरू किया जा सकता है

इस प्रकार, हमें घटकों में जिम्मेदारियों के वितरण के साथ एक एकल और सुसंगत संरचना मिलती है।

अभ्यास

अब एक छोटे व्यावहारिक उदाहरण पर नजर डालते हैं जो दिखाता है कि वीआईपी चक्र कैसे चलता है। इस उदाहरण में, हम दृश्य (स्क्रीन) खोलते समय डेटा लोडिंग का अनुकरण करेंगे। मैंने टिप्पणियों के साथ कोड के मुख्य खंडों को चिह्नित किया।

संपूर्ण वीआईपी चक्र प्रोटोकॉल से बंधा है, जो एप्लिकेशन को बाधित किए बिना किसी भी मॉड्यूल को बदलने की क्षमता प्रदान करता है।
एक DisplayLogic प्रोटोकॉल ViewController के लिए बनाया गया है, एक लिंक जिसे प्रस्तुतकर्ता को बाद में याद करने के लिए पारित किया गया है। इंटरेक्टर के लिए , दो BusinessLogic प्रोटोकॉल बनाए गए हैं, जो डेटा को संग्रहीत करने और राउटर के माध्यम से एक और दृश्य को इंटरएक्टर में स्थानांतरित करने के लिए, व्यू कॉन्ट्रोलर और डेटा स्रोत से कॉलिंग विधियों के लिए जिम्मेदार है। प्रस्तुतकर्ता सहभागिताकर्ता से कॉल करने के लिए PresentationLogic प्रोटोकॉल की सदस्यता लेता है। इस सब का कनेक्टिंग तत्व मॉडल है । इसमें संरचनाएं हैं जिनकी सहायता से वीआईपी चक्र के घटकों के बीच सूचना का आदान-प्रदान किया जाता है। हम इसके साथ कोड विश्लेषण शुरू करेंगे।

मॉडल

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

// Models
/// VIP
enum HomeModels {
/// VIP
enum FetchUser {
/// Interactor View Controller
struct Request {
let userName: String
}
/// Presentor Interactor
struct Response {
let userPhone: String
let userEmail: String
}
/// View Controller Presentor
struct ViewModel {
let userPhone: String
let userEmail: String
}
}
}

view raw CleanSwift - HomeModels.swift hosted with ❤ by GitHub

ViewController

जब क्लास को इनिशियलाइज़ किया जाता है, तो हम इस सीन के इंटरेक्टर और प्रेजेंटर क्लासेस को इंस्टेंट करते हैं और उनके बीच निर्भरता को स्थापित करते हैं।
ViewController'e में आगे इंटरएक्टर के लिए केवल एक लिंक है। इस लिंक का उपयोग करके, हम VIP साइकिल शुरू करने के लिए इंटरच्योर में fetchUser (अनुरोध :) विधि ) के लिए एक अनुरोध बनाएंगे ।

यहां यह ध्यान देने योग्य है कि सहभागिताकर्ता के लिए अनुरोध कैसे होता है। LoadUserInfromation () विधि में, हम अनुरोध संरचना का एक उदाहरण बनाते हैं, जहां हम प्रारंभिक मूल्य पास करते हैं। यह TextField , टेबल, और इसी तरह से लिया जा सकता है। अनुरोध संरचना का एक उदाहरण fetchUser (अनुरोध :) विधि, जो हमारे इंटरेक्टर के BusinessLogic प्रोटोकॉल में है, को दिया जाता है।

// ViewController
///
protocol HomeDisplayLogic: class {
///
func displayUser(_ viewModel: HomeModels.FetchUser.ViewModel)
}
final class HomeViewController: UIViewController {
/// Interactor'a
var interactor: HomeBusinessLogic?
override init(nibName nibNameOrNil: String?, bundle nibBundleOrNil: Bundle?) {
super.init(nibName: nibNameOrNil, bundle: nibBundleOrNil)
setup()
}
required init?(coder aDecoder: NSCoder) {
super.init(coder: aDecoder)
setup()
}
///
private func setup() {
// VIP
let interactor = HomeInteractor()
let presenter = HomePresenter()
//
interactor.presenter = presenter
presenter.viewController = self
// Interactor View Controller
self.interactor = interactor
}
override func viewDidLoad() {
super.viewDidLoad()
//
fetchUser()
}
/// Interactor
private func loadUserInfromation() {
// Interactor
let request = HomeModels.FetchUser.Request(userName: "Aleksey")
// Interactor'a
interactor?.fetchUser(request)
}
}
/// HomeDisplayLogic
extension HomeViewController: HomeDisplayLogic {
func displayUser(_ viewModel: HomeModels.FetchUser.ViewModel) {
print(viewModel)
}
}

view raw CleanSwift - HomeViewController.swift hosted with ❤ by GitHub

Interactor

इंटरेक्टर वर्ग के एक उदाहरण में PresentationLogic प्रोटोकॉल का लिंक है, जिसके तहत प्रस्तुतकर्ता के हस्ताक्षर हैं।

FetchUser (अनुरोध :) विधि में कोई भी डेटा लोड करने का तर्क हो सकता है। उदाहरण के लिए, मैंने अभी-अभी स्थिरांक बनाए हैं, कथित रूप से प्राप्त आंकड़ों के साथ।

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

// Interactor
/// Interactor'a
protocol HomeBusinessLogic: class {
///
func fetchUser(_ request: HomeModels.FetchUser.Request)
}
final class HomeInteractor: HomeBusinessLogic {
///
var presenter: HomePresentationLogic?
func fetchUser(_ request: HomeModels.FetchUser.Request) {
//
//
let userPhone = "+7 (999) 111-22-33"
let userEmail = "im@alekseypleshkov.ru"
// ...
// Presentor'
let response = HomeModels.FetchUser.Response(userPhone: userPhone, userEmail: userEmail)
// Presentor'
presenter?.presentUser(response)
}
}

view raw CleanSwift - HomeInteractor.swift hosted with ❤ by GitHub

प्रस्तुतकर्ता

इसमें DisplayLogic प्रोटोकॉल का लिंक है, जिसके तहत ViewController साइन किया गया है। इसमें कोई व्यावसायिक तर्क नहीं है, लेकिन इसे प्रदर्शित करने से पहले केवल प्राप्त आंकड़ों को प्रारूपित किया जाता है। उदाहरण में, हमने फोन नंबर को स्वरूपित किया, ViewModel संरचना का एक उदाहरण तैयार किया, और इसे DisplayCogic प्रोटोकॉल में DisplayUser (viewModel :) विधि का उपयोग करके ViewController में पारित कर दिया, जहां डेटा पहले से ही प्रदर्शित है।

///
protocol HomePresentationLogic: class {
/// Interactor'a
func presentUser(_ response: HomeModels.FetchUser.Response)
}
final class HomePresenter: HomePresentationLogic {
/// View Controller'a
weak var viewController: HomeDisplayLogic?
func presentUser(_ response: HomeModels.FetchUser.Response) {
//
let formattedPhone = response.userPhone.replacingOccurrences(of: "-", with: " ")
// ViewModel View Controller
let viewModel = HomeModels.FetchUser.ViewModel(userPhone: formattedPhone, userEmail: response.userEmail)
// View Controller'a
viewController?.displayUser(viewModel)
}
}

view raw CleanSwift - HomePresenter.swift hosted with ❤ by GitHub

निष्कर्ष

इस वास्तुकला के साथ, हमें जिम्मेदारियों को वितरित करने, आवेदन के परीक्षण की सुविधा में सुधार करने, कार्यान्वयन के व्यक्तिगत वर्गों की प्रतिकृतिता और एक टीम में काम करने के लिए कोड लिखने के लिए मानक का अवसर मिला।

अंत तक पढ़ने के लिए धन्यवाद।

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

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

दृश्य के सभी घटक: लिंक
एक लेख लिखने में मदद: बास्टियन

	// Models
	/// VIP
	enum HomeModels {

	/// VIP
	enum FetchUser {

	/// Interactor View Controller
	struct Request {
	let userName: String
	}

	/// Presentor Interactor
	struct Response {
	let userPhone: String
	let userEmail: String
	}

	/// View Controller Presentor
	struct ViewModel {
	let userPhone: String
	let userEmail: String
	}
	}
	}

	// ViewController
	///
	protocol HomeDisplayLogic: class {

	///
	func displayUser(_ viewModel: HomeModels.FetchUser.ViewModel)
	}

	final class HomeViewController: UIViewController {

	/// Interactor'a
	var interactor: HomeBusinessLogic?

	override init(nibName nibNameOrNil: String?, bundle nibBundleOrNil: Bundle?) {
	super.init(nibName: nibNameOrNil, bundle: nibBundleOrNil)
	setup()
	}

	required init?(coder aDecoder: NSCoder) {
	super.init(coder: aDecoder)
	setup()
	}

	///
	private func setup() {
	// VIP
	let interactor = HomeInteractor()
	let presenter = HomePresenter()

	//
	interactor.presenter = presenter
	presenter.viewController = self

	// Interactor View Controller
	self.interactor = interactor
	}

	override func viewDidLoad() {
	super.viewDidLoad()

	//
	fetchUser()
	}

	/// Interactor
	private func loadUserInfromation() {
	// Interactor
	let request = HomeModels.FetchUser.Request(userName: "Aleksey")

	// Interactor'a
	interactor?.fetchUser(request)
	}
	}

	/// HomeDisplayLogic
	extension HomeViewController: HomeDisplayLogic {

	func displayUser(_ viewModel: HomeModels.FetchUser.ViewModel) {
	print(viewModel)
	}
	}

	// Interactor
	/// Interactor'a
	protocol HomeBusinessLogic: class {

	///
	func fetchUser(_ request: HomeModels.FetchUser.Request)
	}

	final class HomeInteractor: HomeBusinessLogic {

	///
	var presenter: HomePresentationLogic?

	func fetchUser(_ request: HomeModels.FetchUser.Request) {
	//
	//
	let userPhone = "+7 (999) 111-22-33"
	let userEmail = "im@alekseypleshkov.ru"
	// ...
	// Presentor'
	let response = HomeModels.FetchUser.Response(userPhone: userPhone, userEmail: userEmail)

	// Presentor'
	presenter?.presentUser(response)
	}
	}

	///
	protocol HomePresentationLogic: class {

	/// Interactor'a
	func presentUser(_ response: HomeModels.FetchUser.Response)
	}

	final class HomePresenter: HomePresentationLogic {

	/// View Controller'a
	weak var viewController: HomeDisplayLogic?

	func presentUser(_ response: HomeModels.FetchUser.Response) {
	//
	let formattedPhone = response.userPhone.replacingOccurrences(of: "-", with: " ")

	// ViewModel View Controller
	let viewModel = HomeModels.FetchUser.ViewModel(userPhone: formattedPhone, userEmail: response.userEmail)

	// View Controller'a
	viewController?.displayUser(viewModel)
	}
	}

स्वच्छ स्विफ्ट वास्तुकला अवलोकन

सिद्धांत

राय

ViewController

Interactor

प्रस्तुतकर्ता

मॉडल

मज़दूर

रूटर

अभ्यास

मॉडल

ViewController

Interactor

प्रस्तुतकर्ता

निष्कर्ष

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

More articles: