-
目前在iOS开发中,请求网络数据,我们经常会使用第三方框架,而比较出名的莫过于AFNetworking
-
不过AFNetworking是使用OC开发的框架,作者又专门针对Swift开发了另外一个框架就是Alamofire。
Alamofire地址: https://github.com/Alamofire/Alamofire
功能
- 链式请求/响应方法
- URL / JSON / plist参数编码
- 上传文件/数据/流/多表单数据
- 使用请求或者断点下载来下载文件
- 使用URL凭据进行身份认证
- HTTP响应验证
- 包含进度的上传和下载闭包
- cURL命令的输出
- 动态适配和重试请求
- TLS证书和Public Key Pinning
- 网络可达性
- 全面的单元和集成测试覆盖率
组件库
为了让Alamofire
专注于核心网络的实现,Alamofire生态系统还有另外两个库:
-
AlamofireImage:一个图片库,包括图像响应序列化器、
UIImage
和UIImageView
的扩展、自定义图像滤镜、内存中自动清除和基于优先级的图像下载系统。 - AlamofireNetworkActivityIndicator:控制iOS应用的网络活动指示器。包含可配置的延迟计时器来帮助减少闪光,并且支持不受Alamofire管理的URLSession实例。
要求的使用环境
- iOS 10.0+ / macOS 10.12+ / tvOS 10.0+ / watchOS 3.0+
- Xcode 10.1+
- Swift 4.2+
安装方法
CocoaPods
[图片上传失败...(image-8d0309-1554876987904)]
iOS版本和Alamofire
版本可以自己根据实际情况自行更改。
源文件:
[图片上传失败...(image-222a41-1554876987904)]
Alamofire:定义全局的function,方便使用,常用的request,upload,downlaod
SessionManager:管理与服务器通信的session,底层基于NSURLSession
MultipartFormData:上传文件的表单
NetworkReachabilityManager:对网络状态的判断
Notifications:发起request时的通知,DidResume,DidSuspend,DidCancel,DidComplete
Result:服务器返回的接口,枚举类型
Timeline:主要负责记录整个请求过程中的时间点。主要提供给我们进行debug 的操作,比如我们整个request的初始化用了多少时间,序列化结果用了多长时间(请求开始的时刻,首次从服务器接收到数据或者发送数据给服务器的时刻,从请求开始到首次收到服务器响应的时间间隔等)
upload:上传文件的request
validation:拿到服务器的接口可以先进行验证 ,code 200
基本使用
- 参数
请求接口url
-
method :请求方式
public enum HTTPMethod: String {
case options = "OPTIONS" case get = "GET" case head = "HEAD" case post = "POST" case put = "PUT" case patch = "PATCH" case delete = "DELETE" case trace = "TRACE" case connect = "CONNECT"
}
3.encoding:参数编码
4.headers:请求头
[图片上传失败...(image-8386c1-1554876987904)]
Alamofire默认情况下包含五种不同的响应handler:
// 响应 Handler - 未序列化的响应
func response( queue: DispatchQueue?, completionHandler: @escaping (DefaultDataResponse) -> Void)
-> Self
// 响应数据 Handler - 序列化成数据类型
func responseData( queue: DispatchQueue?, completionHandler: @escaping (DataResponse<Data>) -> Void)
-> Self
// 响应字符串 Handler - 序列化成字符串类型
func responseString( queue: DispatchQueue?, encoding: String.Encoding?, completionHandler: @escaping (DataResponse<String>) -> Void)
-> Self
// 响应 JSON Handler - 序列化成Any类型
func responseJSON( queue: DispatchQueue?, completionHandler: @escaping (DataResponse<Any>) -> Void)
-> Self
// 响应 PropertyList (plist) Handler - 序列化成Any类型
func responsePropertyList( queue: DispatchQueue?, completionHandler: @escaping (DataResponse<Any>) -> Void))
-> Self
解析JSON
[图片上传失败...(image-b4ff33-1554876987904)]
NSJSONSerialzation有很大的局限性,采用SwiftJSON库安全,优雅,不用担心数组越界,不用判断节点,拆包什么的,代码如下
func requestData() {
//[http://www.httpbin.org](http://www.httpbin.org/) 调试接口用的网站。输入参数作为返回
let urlString = "[http://www.httpbin.org/get](http://www.httpbin.org/get)"
let params = ["name":"Keivn","age":"18"]
Alamofire.request(urlString, method: .get, parameters: params, encoding: URLEncoding.default, headers: ["Content-type":"application/x-www-form-urlencoded"]).responseJSON { (response) in
if let v = response.result.value {
let json = JSON(v)//可以直接转化为JSON对象,是个结构体
debugPrint(json["args"]["name"].stringValue)
}else{
debugPrint(response.result.error ?? "")
}
}
}
SwiftJSON地址:https://github.com/SwiftyJSON/SwiftyJSON
上传下载文件
[图片上传失败...(image-844e06-1554876987903)] [图片上传失败...(image-d97543-1554876987903)]
[图片上传失败...(image-97959c-1554876987903)]
监听网络
[图片上传失败...(image-1b1b38-1554876987903)]
//网络请求前判断网络
func resuestData() {
if networkManage?.isReachable ?? false {
}else{
//
}
}