Swift पर HTTP क्लाइंट: सही तरीके से अनुरोध करना

परिचय: आपके Swift एप्लिकेशन के लिए सही HTTP क्लाइंट क्यों महत्वपूर्ण है

आधुनिक iOS और macOS एप्लिकेशन शायद ही कभी रिमोट सर्वर के साथ इंटरैक्शन के बिना काम करते हैं। चाहे वह REST API से डेटा लोड करना हो, एनालिटिक्स भेजना हो या क्लाउड सेवाओं के साथ काम करना हो — Swift में HTTP क्लाइंट नेटवर्क इंटरैक्शन की नींव है। हालांकि, कई डेवलपर्स, विशेष रूप से शुरुआती, सामान्य गलतियाँ करते हैं: वे एरर हैंडलिंग को अनदेखा करते हैं, भाषा की आधुनिक क्षमताओं (async/await) का उपयोग नहीं करते हैं, या नेटवर्क कॉल से "स्पेगेटी कोड" बनाते हैं। इस लेख में, हम सर्वोत्तम प्रथाओं का पालन करते हुए Swift में एक विश्वसनीय और कुशल HTTP क्लाइंट लिखने का तरीका समझेंगे।

1. URLSession की मूल बातें: नेटवर्क अनुरोधों का हृदय

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

1.1. बेसिक HTTP क्लाइंट बनाना

चलिए एक सरल स्ट्रक्चर से शुरू करते हैं जो GET अनुरोध करेगा। संभावित त्रुटियों का वर्णन करने के लिए enum और लचीलेपन के लिए प्रोटोकॉल का उपयोग करें:

import Foundation

enum HTTPClientError: Error {    case invalidURL    case noData    case decodingError(Error)    case networkError(Error)    case statusCode(Int)}

protocol HTTPClientProtocol {    func get<T: Decodable>(from urlString: String, responseType: T.Type) async throws -> T}

final class HTTPClient: HTTPClientProtocol {    private let session: URLSession    private let decoder: JSONDecoder        init(session: URLSession = .shared, decoder: JSONDecoder = JSONDecoder()) {        self.session = session        self.decoder = decoder    }        func get<T: Decodable>(from urlString: String, responseType: T.Type) async throws -> T {        guard let url = URL(string: urlString) else {            throw HTTPClientError.invalidURL        }                var request = URLRequest(url: url)        request.httpMethod = "GET"        request.setValue("application/json", forHTTPHeaderField: "Accept")                let (data, response) = try await session.data(for: request)                guard let httpResponse = response as? HTTPURLResponse else {            throw HTTPClientError.networkError(NSError(domain: "Invalid response", code: -1))        }                guard (200...299).contains(httpResponse.statusCode) else {            throw HTTPClientError.statusCode(httpResponse.statusCode)        }                do {            return try decoder.decode(T.self, from: data)        } catch {            throw HTTPClientError.decodingError(error)        }    }}

1.2. async/await क्यों?

Swift 5.5 के आने से पहले, डेवलपर्स क्लोजर (completion handlers) या थर्ड-पार्टी लाइब्रेरी (Alamofire) का उपयोग करते थे। Async/await कोड को रैखिक, समझने योग्य और आसानी से पढ़ने योग्य बनाता है। त्रुटियों को नेस्टेड क्लोजर के बजाय do-catch के माध्यम से हैंडल किया जाता है।

2. POST, PUT, DELETE: विभिन्न HTTP विधियों के साथ काम करना

एक वास्तविक HTTP क्लाइंट को सभी बुनियादी विधियों को सपोर्ट करना चाहिए। आइए डेटा भेजने और संसाधनों को अपडेट करने के लिए प्रोटोकॉल में विधियाँ जोड़ें।

2.1. POST और PUT के लिए प्रोटोकॉल का विस्तार

extension HTTPClientProtocol {    func post<T: Decodable, U: Encodable>(        to urlString: String,        body: U,        responseType: T.Type    ) async throws -> T {        guard let url = URL(string: urlString) else {            throw HTTPClientError.invalidURL        }                var request = URLRequest(url: url)        request.httpMethod = "POST"        request.setValue("application/json", forHTTPHeaderField: "Content-Type")        request.setValue("application/json", forHTTPHeaderField: "Accept")        request.httpBody = try JSONEncoder().encode(body)                return try a
```