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类图

swift socket框架 swift 网络框架_ios

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))")

  }

 }

swift socket框架 swift 网络框架_HTTP_02

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

  }

 }

swift socket框架 swift 网络框架_swift socket框架_03

备注:

想必大家也注意到上面的上传图片的代码,在append data的时候多了一个 filename的参数,在测试的时候,我发现这个参数是必须的,如果你传入的是data数据,但是如果你使用的是fileurl则可以不用这个参数,在alamofire中 会自己获取文件的名。

swift socket框架 swift 网络框架_xcode_04

如果我们在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

   }

  }