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

Alamofire क्या है और इसकी ज़रूरत क्यों है

Alamofire Swift भाषा में नेटवर्क रिक्वेस्ट के लिए एक शानदार और शक्तिशाली लाइब्रेरी है। यह HTTP-रिक्वेस्ट करने, रिस्पॉन्स प्रोसेस करने, डेटा अपलोड/डाउनलोड करने और ऑथेंटिकेशन व सीरियलाइज़ेशन के लिए आसान इंटरफ़ेस देती है। यह पूरी तरह Swift में लिखी गई है और iOS, macOS, tvOS और watchOS को सपोर्ट करती है।

Alamofire इस्तेमाल करने के मुख्य कारण:

• आसान उपयोग — समझने में आसान API, जो URLSession की तुलना में कोड कम करता है।
• ऑटोमैटिक सीरियलाइज़ेशन — JSON, Property List और कस्टम फॉर्मेट का बिल्ट-इन सपोर्ट।
• रिक्वेस्ट चेनिंग — कई रिक्वेस्ट को आसानी से जोड़कर क्रम में प्रोसेस करें।
• एरर हैंडलिंग — नेटवर्क और सर्वर एरर की विस्तृत जानकारी।
• SSL पिनिंग सपोर्ट — सर्वर से सुरक्षित कनेक्शन।
• फ़ाइल डाउनलोड — प्रोग्रेस और रिज़्यूम सपोर्ट के साथ।
• सक्रिय कम्युनिटी — नियमित अपडेट और ढेरों उदाहरण।

Alamofire इंस्टॉलेशन

Alamofire को Swift Package Manager (SPM), CocoaPods या Carthage के ज़रिए इंस्टॉल किया जा सकता है। सबसे अच्छा तरीका SPM है।

Swift Package Manager (SPM) से इंस्टॉल करें

1. Xcode में अपना प्रोजेक्ट खोलें: File → Add Packages...
2. रिपॉजिटरी URL डालें: https://github.com/Alamofire/Alamofire.git
3. वर्शन चुनें (नवीनतम स्थिर वर्शन) और Add Package पर क्लिक करें।
4. पैकेज आपके target में जुड़ गया है, यह जाँच लें।

CocoaPods से इंस्टॉल करें

# Podfile
platform :ios, '13.0'
use_frameworks!

target 'YourApp' do
  pod 'Alamofire', '~> 5.9'
end

इसके बाद pod install कमांड चलाएँ।

Carthage से इंस्टॉल करें

# Cartfile
github "Alamofire/Alamofire" ~> 5.9

फिर carthage update --platform iOS चलाएँ।

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

इंस्टॉल करने के बाद लाइब्रेरी को इम्पोर्ट करें और एक सरल GET-रिक्वेस्ट करें:

import Alamofire

// सरल GET-रिक्वेस्ट
AF.request("https://jsonplaceholder.typicode.com/posts/1")
    .responseJSON { response in
        switch response.result {
        case .success(let data):
            print("प्राप्त डेटा: \(data)")
        case .failure(let error):
            print("एरर: \(error.localizedDescription)")
        }
    }

यह कोड टेस्ट API को रिक्वेस्ट भेजता है, JSON प्राप्त करता है और कंसोल में दिखाता है। Alamofire अपने आप URL-सेशन, रिक्वेस्ट क्रिएशन और रिस्पॉन्स सीरियलाइज़ेशन हैंडल करता है।

Alamofire के मुख्य तरीके और फंक्शन

आइए लाइब्रेरी के 10 प्रमुख तरीकों को विस्तार से उदाहरणों के साथ समझते हैं।

1. AF.request() — बेसिक HTTP रिक्वेस्ट

क्या करता है: किसी भी HTTP मेथड (GET, POST, PUT, DELETE आदि) से दिए गए URL पर रिक्वेस्ट भेजता है।

पैरामीटर:

• _ url: URLConvertible — URL या URL स्ट्रिंग।
• method: HTTPMethod = .get — HTTP मेथड (get, post, put, delete, patch आदि)।
• parameters: Parameters? = nil — रिक्वेस्ट पैरामीटर का डिक्शनरी।
• encoding: ParameterEncoding = URLEncoding.default — पैरामीटर एन्कोडिंग का तरीका।
• headers: HTTPHeaders? = nil — रिक्वेस्ट हेडर।
• interceptor: RequestInterceptor? = nil — रिक्वेस्ट को मॉडिफाई करने के लिए इंटरसेप्टर।

उदाहरण:

let parameters: [String: Any] = [
    "userId": 1,
    "title": "नया पोस्ट",
    "body": "पोस्ट का टेक्स्ट"
]

AF.request("https://jsonplaceholder.typicode.com/posts",
           method: .post,
           parameters: parameters,
           encoding: JSONEncoding.default)
    .responseJSON { response in
        // रिस्पॉन्स हैंडल करें
    }