Alamofire — apa itu, HTTP-client di Swift dan cara kerjanya

Apa itu Alamofire?

Alamofire adalah klien HTTP untuk Swift, dibuat oleh Alamofire Software Foundation (awalnya Mattt Thompson pada tahun 2014). Pustaka ini mengabstraksi detail tingkat rendah URLSession, menyediakan API yang bersih dan ekspresif untuk komunikasi jaringan.

Filosofi dasar Alamofire adalah sintaks berantai, di mana parameter permintaan (URL, metode, header, parameter, encoder) diteruskan melalui panggilan berurutan. Ini membuat kode lebih mudah dibaca dan mengurangi kemungkinan kesalahan terkait konfigurasi URLRequest yang salah. Pendekatan deklaratif memungkinkan fokus pada apa yang perlu dilakukan, bukan pada detail cara mengatur koneksi. Pengembang mendeskripsikan hasil yang diinginkan, dan pustaka mengambil alih pekerjaan jaringan tingkat rendah.

Pustaka ini aktif didukung sejak 2014 dan telah melalui tujuh versi utama. Alamofire 5, yang terkini untuk 2025–2026, mencakup dukungan untuk Combine, async/await, konverter respons, EventMonitor untuk debugging, dan RequestInterceptor untuk mencegat permintaan. Setiap versi utama membawa peningkatan signifikan: Alamofire 4 menambahkan dukungan Codable, Alamofire 5 — Combine Publishers dan sistem pencegat permintaan yang ditingkatkan.

Ekosistem Alamofire mencakup pustaka tambahan: AlamofireImage untuk memuat dan menyimpan cache gambar, AlamofireNetworkActivityIndicator untuk indikator jaringan di bilah status iOS, dan AlamofireObjectMapper untuk integrasi dengan ObjectMapper. Komponen-komponen ini menjadikan Alamofire sebagai tumpukan jaringan yang lengkap, bukan sekadar klien HTTP.

Instalasi dan konfigurasi

Alamofire diinstal melalui Swift Package Manager (direkomendasikan), CocoaPods, atau Carthage. Di Xcode, cukup buka menu File → Add Packages, tempel URL repositori, dan tentukan versi.

// Swift Package Manager — tambahkan ke Package.swift
dependencies: [
    .package(url: "https://github.com/Alamofire/Alamofire.git",
             from: "5.9.0")
]

// Import di file
import Alamofire

Setelah instalasi, Alamofire tersedia secara global melalui ruang nama AF (singkatan dari Alamofire) tanpa konfigurasi tambahan. Sebagian besar proyek dimulai dengan menyiapkan Session dengan konfigurasi sendiri — ini memungkinkan pengaturan URL dasar, header standar, batas waktu, dan penangan sertifikat TLS.

let configuration = URLSessionConfiguration.default
configuration.timeoutIntervalForRequest = 30
let session = Session(configuration: configuration)

Membuat sesi sendiri melalui Session(configuration:) diperlukan ketika konfigurasi unik diperlukan untuk bagian aplikasi yang berbeda — misalnya, sesi terpisah untuk memuat gambar dengan caching agresif dan sesi terpisah untuk permintaan API dengan autentikasi. Sesi Alamofire tidak hanya menerima konfigurasi, tetapi juga interceptor, serverTrustManager, cachedResponseHandler, dan redirectHandler, yang memungkinkan kontrol penuh atas perilaku jaringan di semua tahap permintaan.

Fitur utama

Alamofire menyediakan berbagai fitur yang mencakup sebagian besar skenario komunikasi jaringan di aplikasi iOS. Mari kita lihat yang utama.

Permintaan HTTP

Sintaks dasar permintaan mencakup metode, URL, parameter, dan encoding. Semua metode HTTP standar didukung melalui enum HTTPMethod: get, post, put, patch, delete. Parameter dapat dikodekan sebagai parameter URL (URLEncoding), body JSON (JSONEncoding), atau format multipart (MultipartFormData).

AF.request("https://api.example.com/users", method: .post,
           parameters: ["name": "Alex", "role": "developer"])
    .validate()
    .responseDecodable(of: User.self) { response in
        switch response.result {
        case .success(let user):
            print("Pengguna dibuat: \(user)")
        case .failure(let error):
            print("Kesalahan: \(error)")
        }
    }

Metode validate() secara otomatis memeriksa kode status (200–299) dan tipe konten, mengembalikan kesalahan pada respons non-standar, yang menghilangkan pemeriksaan statusCode manual. responseDecodable menggunakan protokol Decodable untuk deserialisasi otomatis JSON ke struktur Swift — ini menghilangkan JSONSerialization manual dan mengurangi jumlah kode boilerplate saat bekerja dengan REST API.

Pemrosesan respons

Alamofire mendukung beberapa jenis penangan respons: response (data mentah), responseJSON (kamus/array), responseString (teks), responseData (Data), dan responseDecodable (model Decodable). Konverter respons dapat dibuat kustom — untuk protobuf, format grafis, atau protokol sendiri.

Unggah dan unduh file

Untuk mengunggah data ke server digunakan upload, yang mendukung Data, File, dan MultipartFormData. Mengunduh file besar dilakukan melalui download dengan kemampuan melanjutkan melalui resumeData setelah koneksi terputus. Kedua operasi mendukung pelacakan kemajuan melalui uploadProgress dan downloadProgress dengan nilai pecahan dari 0 hingga 1 untuk ditampilkan di antarmuka pengguna.

Unggahan multipart dengan Alamofire sangat nyaman: metode upload(multipartFormData:) menerima closure di mana bagian formulir ditambahkan melalui append. Setiap bagian dapat berisi data, file, atau aliran, serta nama dan tipe mime sendiri. Alamofire secara otomatis menghitung batas multipart dan mengatur header Content-Type yang benar, membebaskan pengembang dari pembentukan body permintaan secara manual. Untuk file besar, disarankan menggunakan transmisi streaming (stream provider) daripada memuat seluruh file ke memori — ini mencegah melampaui batas memori pada perangkat seluler dengan sumber daya terbatas. Skenario umum — mengirim avatar pengguna bersama dengan data profil dalam satu permintaan multipart, yang mengurangi jumlah panggilan HTTP dan menyederhanakan pemrosesan di sisi server.

Alamofire vs URLSession

Perbandingan Alamofire dan URLSession asli membantu dalam pengambilan keputusan arsitektur. Alamofire tidak menggantikan URLSession — ia dibangun di atasnya dan menggunakan mekanisme konfigurasi, caching, dan tugas latar belakang yang sama. Semua fungsionalitas URLSession tersedia melalui Alamofire, tetapi dengan sintaks deklaratif yang lebih nyaman.

Di proyek besar, Alamofire mengurangi jumlah kode untuk permintaan jaringan sebesar 30–50% dan menyederhanakan penanganan kesalahan. Di proyek kecil atau dengan persyaratan ketat pada ukuran biner, URLSession asli lebih disukai karena tidak memiliki ketergantungan eksternal.

Alamofire 5 modern terintegrasi dengan Combine melalui properti publishDecodable, yang mengembalikan Publisher, memungkinkan pembangunan rantai permintaan reaktif dengan penanganan kesalahan dan transformasi data. Untuk async/await tersedia metode dengan akhiran value — misalnya, AF.request(url).serializingDecodable(User.self).value, yang membuat sintaks sangat ringkas dan mengingatkan pada kerja dengan URLSession asli. Saat menggunakan async/await, tidak diperlukan closure, dan penanganan kesalahan dilakukan melalui blok do-catch standar Swift, yang menyederhanakan pemeliharaan kode dan keterbacaannya dalam jangka panjang.

Contoh kode

Mari kita lihat contoh yang lebih kompleks — permintaan dengan interceptor yang secara otomatis menambahkan token otorisasi dan melakukan percobaan ulang pada kesalahan 401. Ini adalah skenario umum untuk aplikasi dengan autentikasi JWT.

class AuthInterceptor: RequestInterceptor {
    func adapt(_ urlRequest: URLRequest,
               for session: Session,
               completion: @escaping (Result<URLRequest, Error>) -> Void) {
        var request = urlRequest
        request.setValue("Bearer \(TokenManager.shared.token)",
                         forHTTPHeaderField: "Authorization")
        completion(.success(request))
    }

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

Interceptor AuthInterceptor mengimplementasikan dua protokol: adapt (menambahkan token ke setiap permintaan) dan retry (mencoba memperbarui token pada kesalahan 401). Metode retry memeriksa kode status respons dan, jika menerima 401, meminta token baru melalui TokenManager. Setelah pembaruan berhasil, permintaan diulang secara otomatis.

Penggunaan interceptor dengan sesi:

let session = Session(interceptor: AuthInterceptor())
session.request("https://api.example.com/profile")
    .responseDecodable(of: Profile.self) { response in
        print(response.result)
    }

Semua permintaan melalui sesi ini secara otomatis melewati AuthInterceptor — token ditambahkan ke header, dan pada 401 dilakukan pembaruan dan pengulangan. Ini menghilangkan duplikasi kode autentikasi di setiap permintaan dan memusatkan logika kerja dengan token.