הגדרת Alamofire לבקשות רשת באפליקציות iOS

הגדרת Alamofire לבקשות רשת באפליקציות iOS

אתה משתמש ב-URLSession ובכל פעם כותב עשרות שורות כדי לרענן טוקנים, לטפל ב-401, להעלות קבצים? Alamofire 5 פותר את זה ישירות מהקופסה. אנחנו רואים לעתים קרובות פרויקטים שבהם שכבת הרשת מפוזרת בין בקרי התצוגה — מה שמוביל לכפילות קוד, קושי בבדיקות ובאגים כשהאפי משתנה. במקום זאת, אנחנו מניחים את הארכיטקטורה הנכונה מהיום הראשון באמצעות תבניות מוכחות, שזכו לאמון של יותר מ-20 לקוחות.

Alamofire הוא לא רק wrapper סביב URLSession. זהו framework עם תמיכה ב-async/await, Combine, שרשור בקשות, ניסיונות חוזרים אוטומטיים ו-certificate pinning. עבור אפליקציות עם הרשאות, העלאת מדיה ודרישות אבטחה מחמירות, הוא הכרחי. בואו נפרק איך להגדיר אותו בצורה מקצועית כדי לחסוך עד 40% (1200$) מזמן הפיתוח של שכבת הרשת (בהתבסס על מאגר Alamofire GitHub).

למה להשתמש ב-Alamofire? (אנטי-תבניות וארכיטקטורה)

קריאה ל-AF.request() ישירות מ-ViewModel יוצרת צימוד הדוק ל-framework ומקשה על בדיקות יחידה. במקום זאת, בודדו את שכבת הרשת באמצעות פרוטוקולים. אנחנו משתמשים בארכיטקטורת שלוש שכבות שהוכחה ביותר מ-20 פרויקטים:

• APIClient — סינגלטון או מוזרק, המחזיק Session עם קונפיגורציה.
• Router — enum עם URLRequestConvertible עבור כל נקודות הקצה.
• Models — structs מסוג Codable.

enum UserRouter: URLRequestConvertible {
    case getProfile(id: String)
    case updateProfile(UserUpdateRequest)

    var method: HTTPMethod {
        switch self {
        case .getProfile:
            return .get
        case .updateProfile:
            return .patch
        }
    }

    func asURLRequest() throws -> URLRequest {
        var request = try URLRequest(url: baseURL.appendingPathComponent(path))
        request.method = method
        return try encoder.encode(self, into: request)
    }
}

גישה זו מבטיחה שכל נקודת קצה מתוארת באופן אחיד, ואתה יכול לבדוק על ידי העברת מימוש מדומה של APIClientProtocol. התוצאה: הפחתה של 60% בבאגים בעת רפקטורינג של האפי.

הגדרה שלב אחר שלב (5 שלבים)

1. צור Session עם RequestInterceptor
2. הגדר Router באמצעות URLRequestConvertible
3. יישם API Client עם Decoding
4. הוסף טיפול בשגיאות
5. בדוק עם Mock Session

תהליך זה של 5 שלבים אורך 1–3 ימים ומפחית את התחזוקה העתידית ב-50%, וחוסך בערך 800$ בעלויות ארוכות טווח.

איך ליישם רענון טוקן אוטומטי?

ללא RequestInterceptor, היית צריך לבדוק ידנית את סטטוס התגובה, לקרוא ל-refresh ולנסות שוב. Alamofire עושה זאת בשקיפות:

class AuthInterceptor: RequestInterceptor {
    func adapt(_ urlRequest: URLRequest, for session: Session, completion: @escaping (Result<URLRequest, Error>) -> Void) {
        var request = urlRequest
        request.headers.add(.authorization(bearerToken: tokenStore.accessToken))
        completion(.success(request))
    }

    func retry(_ request: Request, for session: Session, dueTo error: Error, completion: @escaping (RetryResult) -> Void) {
        guard request.response?.statusCode == 401 else {
            completion(.doNotRetry)
            return
        }
        refreshToken { result in
            switch result {
            case .success:
                completion(.retry)
            case .failure(let e):
                completion(.doNotRetryWithError(e))
            }
        }
    }
}

session.request(router)
    .validate(statusCode: 200..<300)
    .responseDecodable(of: T.self, decoder: decoder) { response in
        switch response.result {
        case .success(let value):
            // ok
        case .failure(let error):
            if let data = response.data, let apiError = try? decoder.decode(APIError.self, from: data) {
                // показываем apiError.message
            }
        }
    }

session.upload(multipartFormData: { formData in
    formData.append(imageData, withName: "photo", fileName: "photo.jpg", mimeType: "image/jpeg")
}, with: router)
.uploadProgress { progress in
    updateProgressBar(progress.fractionCompleted)
}

let manager = ServerTrustManager(evaluators: [
    "api.example.com": PinnedCertificatesTrustEvaluator()
])
let session = Session(serverTrustManager: manager)