swift开源框架分析--Alamofire

Alamofire是一个使用Swift编写的开源网络库，主要用于iOS、macOS和watchOS应用程序中进行HTTP请求和响应处理。它基于NSURLSession构建，提供了强大的、易于使用的API，并支持多种编码方式和网络安全性。

Alamofire的架构可以分为以下几个部分：

1. SessionManager：这是Alamofire的核心部分，负责处理NSURLSession和请求管理。SessionManager提供了许多方法来创建和管理请求，以及对响应进行处理。

2. Request：Request代表一个HTTP请求，可以指定请求的URL、HTTP方法、参数、头文件等。Request可以被设置为一个“数据请求”（DataRequest）或一个“下载请求”（DownloadRequest），分别用于处理普通的HTTP请求和文件下载。

3. Response：Response代表一个HTTP响应，包含HTTP状态码、HTTP头、响应数据等信息。Response也可以被设置为“数据响应”（DataResponse）或“下载响应”（DownloadResponse），分别用于处理普通的HTTP响应和文件下载。

4. Serializers：Serializers负责将请求和响应数据序列化和反序列化，支持多种编码方式和数据格式，比如JSON、XML、字符串等。

5. Authenticators：Authenticators负责验证请求的身份和安全性，支持多种验证方式，比如基本身份验证、OAuth等。

SessionDelegate类图

GET请求

常用的get请求示例以及请求结果

?

1 2 3 4 5 6 7 8 9

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)

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14

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请求

?

1 2 3 4 5 6 7 8 9 10

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格式的数据

?

1 2 3 4 5 6 7 8 9 10 11

// 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(上传文件)

上传文件示例

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28

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抓包是会发现如下。

上传文件并携带参数

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34

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    }   }