Swinject Swift: पूरी गाइड उदाहरणों के साथ

Swinject क्या है और इसकी आवश्यकता क्यों है?

Swinject Swift भाषा के लिए एक हल्की Dependency Injection (DI) लाइब्रेरी है। यह ऑब्जेक्ट्स के बीच निर्भरताओं (dependencies) को प्रबंधित करने का एक सरल और घोषणात्मक तरीका प्रदान करती है, जिससे कोड अधिक मॉड्यूलर, टेस्ट करने योग्य और मेंटेन करने योग्य बनता है।

पारंपरिक दृष्टिकोण में, ऑब्जेक्ट्स स्वयं अपनी निर्भरताएँ बनाते हैं, जिससे कोड में कड़ी कपलिंग (tight coupling) होती है। उदाहरण के लिए, UserService क्लास सीधे NetworkClient का इंस्टेंस बना सकता है। यदि आप टेस्टिंग के लिए NetworkClient को मॉक ऑब्जेक्ट से बदलना चाहते हैं, तो आपको UserService का कोड बदलना होगा। Swinject इस समस्या को हल करता है, ऑब्जेक्ट्स के निर्माण और जुड़ाव को एक अलग कंटेनर में रखकर।

Swinject के मुख्य लाभ:

• कपलिंग कम करना: क्लासेस को यह नहीं पता होता कि उनकी निर्भरताएँ कैसे बनती हैं।
• टेस्टेबिलिटी में सुधार: वास्तविक निर्भरताओं को मॉक और स्टब से आसानी से बदला जा सकता है।
• कॉन्फ़िगरेशन सरल बनाना: सभी निर्भरता कॉन्फ़िगरेशन एक ही स्थान पर इकट्ठा होती है।
• लाइफसाइकल सपोर्ट: ऑब्जेक्ट्स के जीवनकाल का प्रबंधन (सिंगलटन, नया इंस्टेंस, आदि)।
• स्वच्छ आर्किटेक्चर: SOLID सिद्धांतों, विशेष रूप से Dependency Inversion Principle का पालन करने में मदद करता है।

Swinject विशेष रूप से बड़े प्रोजेक्ट्स में उपयोगी है, जहाँ क्लासेस और उनकी निर्भरताओं की संख्या बढ़ती है, और मैन्युअल प्रबंधन जटिल और त्रुटि-प्रवण हो जाता है।

Swinject की स्थापना (Installation)

Swinject को Swift Package Manager (SPM) या CocoaPods के माध्यम से स्थापित किया जाता है। हम दोनों तरीकों पर विचार करेंगे।

Swift Package Manager के माध्यम से स्थापना (अनुशंसित)

Xcode में, File → Add Packages... पर जाएँ। सर्च बार में रिपॉजिटरी URL डालें: https://github.com/Swinject/Swinject.git। आवश्यक संस्करण चुनें (आमतौर पर नवीनतम स्थिर संस्करण) और Add Package पर क्लिक करें।

वैकल्पिक रूप से, आप अपने Package.swift में निर्भरता जोड़ सकते हैं:

// swift-tools-version:5.7
import PackageDescription

let package = Package(
    name: "YourProject",
    dependencies: [
        .package(url: "https://github.com/Swinject/Swinject.git", from: "2.8.0")
    ],
    targets: [
        .target(
            name: "YourTarget",
            dependencies: ["Swinject"])
    ]
)

CocoaPods के माध्यम से स्थापना

अपने Podfile में जोड़ें:

pod 'Swinject', '~> 2.8'

फिर pod install कमांड चलाएँ।

नोट: Python (pip) या Node.js (npm) के विपरीत, Swift में कोई एकल पैकेज मैनेजर नहीं है, लेकिन SPM मानक है और Xcode में अंतर्निहित है।

कोड उदाहरण के साथ त्वरित शुरुआत

आइए एक सरल उदाहरण देखें: हमारे पास एक प्रोटोकॉल LoggerProtocol और इसका कार्यान्वयन ConsoleLogger है। हम चाहते हैं कि UserService क्लास Dependency Injection के माध्यम से लॉगर प्राप्त करे।

import Swinject

// 1. प्रोटोकॉल परिभाषित करें
protocol LoggerProtocol {
    func log(message: String)
}

// 2. प्रोटोकॉल का कार्यान्वयन
class ConsoleLogger: LoggerProtocol {
    func log(message: String) {
        print("LOG: \(message)")
    }
}

// 3. वह क्लास जो निर्भरता का उपयोग करता है
class UserService {
    private let logger: LoggerProtocol

    // इनिशियलाइज़र के माध्यम से इंजेक्शन
    init(logger: LoggerProtocol) {
        self.logger = logger
    }

    func createUser(name: String) {
        logger.log(message: "Creating user: \(name)")
        // उपयोगकर्ता बनाने का तर्क
    }
}

// 4. कंटेनर सेटअप करें
let container = Container()
container.register(LoggerProtocol.self) { _ in ConsoleLogger() }
container.register(UserService.self) { r in
    UserService(logger: r.resolve(LoggerProtocol.self)!)
}

// 5. उपयोग
let userService = container.resolve(UserService.self)!
u