iOS Alamofire库的使用

Alamofire 是 iOS/macOS 开发中最常用的网络请求库之一,基于 Swift 编写,封装了 URLSession,提供了链式调用、JSON 解析、文件上传/下载等高级功能。以下是 Alamofire 的具体用法和示例,涵盖常见场景。


  1. 安装 Alamofire
    通过 CocoaPods 安装
    Podfile 中添加:
ruby 复制代码
pod 'Alamofire', '~> 5.8'

然后运行 pod install

通过 Swift Package Manager (SPM)

在 Xcode 的 File > Add Packages 中输入:

复制代码
https://github.com/Alamofire/Alamofire.git 

  1. 基本用法
    (1) 发起 GET 请求
swift 复制代码
import Alamofire 
 
AF.request("https://httpbin.org/get").response { response in 
    switch response.result {
    case .success(let data):
        print("请求成功: \(String(describing: data))")
    case .failure(let error):
        print("请求失败: \(error)")
    }
}

(2) 带参数的 GET 请求

swift 复制代码
let parameters = ["page": 1, "limit": 10]
 
AF.request("https://httpbin.org/get", parameters: parameters).responseJSON { response in 
    switch response.result {
    case .success(let json):
        print("JSON 数据: \(json)")
    case .failure(let error):
        print("请求失败: \(error)")
    }
}

(3) 发起 POST 请求

swift 复制代码
let parameters = ["username": "test", "password": "123456"]
 
AF.request("https://httpbin.org/post", method: .post, parameters: parameters).responseJSON { response in 
    switch response.result {
    case .success(let json):
        print("POST 成功: \(json)")
    case .failure(let error):
        print("POST 失败: \(error)")
    }
}

(4) 使用 Encodable 发送 JSON

如果你的参数是 Encodable 对象(如 struct),可以这样:

swift 复制代码
struct User: Encodable {
    let name: String 
    let age: Int 
}
 
let user = User(name: "John", age: 25)
 
AF.request("https://httpbin.org/post", method: .post, parameters: user, encoder: JSONParameterEncoder.default).responseJSON { response in 
    switch response.result {
    case .success(let json):
        print("POST 成功: \(json)")
    case .failure(let error):
        print("POST 失败: \(error)")
    }
}

  1. 高级用法
    (1) 文件上传
swift 复制代码
let fileURL = Bundle.main.url(forResource: "test", withExtension: "jpg")!
 
AF.upload(fileURL, to: "https://httpbin.org/post").uploadProgress { progress in 
    print("上传进度: \(progress.fractionCompleted)")
}.responseJSON { response in 
    switch response.result {
    case .success(let json):
        print("上传成功: \(json)")
    case .failure(let error):
        print("上传失败: \(error)")
    }
}

(2) 文件下载

swift 复制代码
let destination: DownloadRequest.Destination = { _, _ in 
    let documentsURL = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
    let fileURL = documentsURL.appendingPathComponent("image.jpg")
    return (fileURL, [.removePreviousFile, .createIntermediateDirectories])
}
 
AF.download("https://httpbin.org/image/jpeg", to: destination).response { response in 
    if let filePath = response.fileURL?.path {
        print("文件已保存到: \(filePath)")
    }
}

(3) 请求头 & 认证

swift 复制代码
let headers: HTTPHeaders = [
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
]
 
AF.request("https://httpbin.org/headers", headers: headers).responseJSON { response in 
    switch response.result {
    case .success(let json):
        print("带 Header 的请求: \(json)")
    case .failure(let error):
        print("请求失败: \(error)")
    }
}

(4) 拦截请求(RequestInterceptor)

可以统一处理认证、重试等逻辑:

swift 复制代码
struct AuthInterceptor: RequestInterceptor {
    func adapt(_ urlRequest: URLRequest, for session: Session, completion: @escaping (Result<URLRequest, Error>) -> Void) {
        var request = urlRequest 
        request.setValue("Bearer YOUR_TOKEN", forHTTPHeaderField: "Authorization")
        completion(.success(request))
    }
}
 
let session = Session(interceptor: AuthInterceptor())
session.request("https://httpbin.org/headers").responseJSON { response in 
    // 处理响应 
}

  1. 错误处理
    Alamofire 提供了详细的错误信息:
swift 复制代码
AF.request("https://httpbin.org/status/404").validate().response { response in 
    if let error = response.error {
        if let statusCode = response.response?.statusCode {
            print("HTTP 状态码错误: \(statusCode)")
        }
        print("详细错误: \(error.localizedDescription)")
    }
}

  1. 结合 Combine(iOS 13+)
    Alamofire 支持 Combine,可以轻松集成到响应式编程中:
swift 复制代码
import Combine 
 
AF.request("https://httpbin.org/get")
    .publishDecodable(type: ResponseModel.self)
    .sink { completion in 
        if case .failure(let error) = completion {
            print("请求失败: \(error)")
        }
    } receiveValue: { response in 
        print("收到数据: \(response.value)")
    }
    .store(in: &cancellables)

总结

功能 示例
GET 请求 AF.request("https://example.com/get")
POST 请求 AF.request("https://example.com/post", method: .post, parameters: params)
文件上传 AF.upload(fileURL, to: "https://example.com/upload")
文件下载 AF.download("https://example.com/file", to: destination)
请求头 headers: HTTPHeaders = ["Authorization": "Bearer token"]
错误处理 response.validate().responseJSON { ... }

Alamofire 让网络请求变得更简单,适用于大多数 HTTP 请求场景。建议结合 Codable 解析 JSON 数据,提升代码可维护性。

相关推荐
谈吐大方的鹏sir13 小时前
SwiftUI-TextField组件学习
ios
谈吐大方的鹏sir16 小时前
SwiftUI-Button组件学习
ios
谈吐大方的鹏sir19 小时前
SwiftUI-Image组件学习
ios
鹏多多.19 小时前
flutter-完美解决键盘弹出遮挡输入框的问题
android·flutter·ios·前端框架
杂雾无尘21 小时前
SwiftUI 动画新技能,让你的应用「活」起来!
ios·swiftui·swift
林大鹏天地1 天前
iOS18系统 [YYKVStorage _dbClose] 偶现崩溃
ios
林大鹏天地1 天前
使用Xcode16打包后,App在暗夜模式下,iOS18 切换Tabbar的item,会有一根白色线条闪过。
ios
2501_915909061 天前
iOS 加固工具实战解析,主流平台审核机制与工具应对策略
android·ios·小程序·https·uni-app·iphone·webview
2501_915106321 天前
iOS WebView 调试实战,第三方脚本加载失败与内容安全策略冲突问题排查指南
android·ios·小程序·https·uni-app·iphone·webview
笑尘pyrotechnic2 天前
DocC的简单使用
ios·objective-c