Alamofire是一个使用Swift编写的开源网络库,主要用于iOS、macOS和watchOS应用程序中进行HTTP请求和响应处理。它基于NSURLSession构建,提供了强大的、易于使用的API,并支持多种编码方式和网络安全性。
Alamofire的架构可以分为以下几个部分:
- SessionManager:这是Alamofire的核心部分,负责处理NSURLSession和请求管理。SessionManager提供了许多方法来创建和管理请求,以及对响应进行处理。
- Request:Request代表一个HTTP请求,可以指定请求的URL、HTTP方法、参数、头文件等。Request可以被设置为一个“数据请求”(DataRequest)或一个“下载请求”(DownloadRequest),分别用于处理普通的HTTP请求和文件下载。
- Response:Response代表一个HTTP响应,包含HTTP状态码、HTTP头、响应数据等信息。Response也可以被设置为“数据响应”(DataResponse)或“下载响应”(DownloadResponse),分别用于处理普通的HTTP响应和文件下载。
- Serializers:Serializers负责将请求和响应数据序列化和反序列化,支持多种编码方式和数据格式,比如JSON、XML、字符串等。
- Authenticators:Authenticators负责验证请求的身份和安全性,支持多种验证方式,比如基本身份验证、OAuth等。
SessionDelegate类图
GET请求
常用的get请求示例以及请求结果
Alamofire.request("https://httpbin.org/get", method: .get, parameters: nil, encoding: URLEncoding.default, headers: nil).responseJSON { (response) in
if(response.error == nil){
LLog("请求成功")
LLog(response.result.value)
}else{
LLog("请求失败\(String(describing: response.error))")
}
}
Get请求、有参数、使用Basic Auth授权访问(例如:jira)
var header:HTTPHeaders = [:]
if let authorizationHeader = Request.authorizationHeader(user: "xxxx", password: "xxxxxx") {
header[authorizationHeader.key] = authorizationHeader.value
}
// 此处的 URLEncoding.default (URLEncoding.queryString )会将parameters 拼接到url后面
Alamofire.request("https://httpbin.org/get", method: HTTPMethod.get, parameters: ["key":"value"], encoding: URLEncoding.default, headers: header).responseJSON { (response) in
if(response.error == nil){
LLog("请求成功")
LLog(response.result.value)
}else{
LLog("请求失败\(String(describing: response.error))")
}
}
POST请求 常用的post请求
Alamofire.request("https://httpbin.org/post", method: .post, parameters: ["key1":"value1","key2":"value2"], encoding: URLEncoding.default, headers: nil).responseJSON { (response) in
if(response.error == nil){
LLog("请求成功")
LLog(response.result.value)
}else{
LLog("请求失败\(String(describing: response.error))")
}
}
post请求,提交json格式的数据
// JSONEncoding.default === JSONEncoding.prettyPrinted
Alamofire.request("https://httpbin.org/post", method: .post, parameters: ["key1":"value1","key2":"value2"], encoding: JSONEncoding.default, headers: nil).responseJSON { (response) in
if(response.error == nil){
LLog("请求成功")
LLog(response.result.value)
}else{
LLog("请求失败\(String(describing: response.error))")
}
}
PUT、Delete 请求 参照POST(使用区别不大)
UPLOAD(上传文件)
上传文件示例
let data:Data = UIImageJPEGRepresentation(#imageLiteral(resourceName: "beauty.jpeg"), 0.2)!
let url = Bundle.main.url(forResource: "beauty", withExtension: "jpeg");
// 多文件上传
Alamofire.upload(multipartFormData: { (formdata) in
formdata.append(data, withName: "file", fileName: "beauty.jpeg", mimeType: "image/jpeg")
formdata.append(url!, withName: "file2")
}, to: UPLOAD_URL) { (encodingResult) in
switch encodingResult{
case .success(let uploadFile, _, _):
//上传进度回调
uploadFile.uploadProgress(closure: { (progress) in
debugPrint("上传进度\(progress)")
})
//上传结果回调
uploadFile.responseString(completionHandler: { (response) in
LLog(response.result.value)
})
break
case .failure( let error):
LLog(error);
break
}
}
备注:
想必大家也注意到上面的上传图片的代码,在append data的时候多了一个 filename的参数,在测试的时候,我发现这个参数是必须的,如果你传入的是data数据,但是如果你使用的是fileurl则可以不用这个参数,在alamofire中 会自己获取文件的名。
如果我们在append data的时候,不传入文件名,在上面的代码中 headers中则不会有 filename这个参数,此时使用charles抓包是会发现如下。
上传文件并携带参数
var param: [String:String] = [:];
param["postion"] = "portrait"
let url = Bundle.main.url(forResource: "beauty", withExtension: "jpeg");
// 2、多文件上传
Alamofire.upload(multipartFormData: { (formdata) in
formdata.append(url!, withName: "file2")
//拼接参数
for (key, value) in param {
formdata.append(value.data(using: String.Encoding.utf8)!, withName: key)
}
}, to: UPLOAD_URL) { (encodingResult) in
switch encodingResult{
case .success(let uploadFile, _, _):
//上传进度回调
uploadFile.uploadProgress(closure: { (progress) in
debugPrint("上传进度\(progress)")
})
//上传结果回调
uploadFile.responseJSON(completionHandler: { (response) in
LLog(response.result.value)
})
break
case .failure( let error):
LLog(error);
break
}
}