所有类型请求，Alamofire都直接提供，通过Alamofire直接调用，配置相关参数即可。示例如下：
1、GET请求
let urlStr = "http://onapp.yahibo.top/public/?s=api/test/list"
Alamofire.request(url).responseJSON { (response) in
switch response.result {
case .success(let json):
print(json)
break
case .failure(let error):
print("error:\(error)")
break
}
}
-
url支持多种类型，String、URL、Request，在框架内部已经为我们处理好了，怎么方便怎么用 - 直接调用
responseJSON获取json数据
request的参数如下：
public func request(
_ url: URLConvertible,
method: HTTPMethod = .get,
parameters: Parameters? = nil,
encoding: ParameterEncoding = URLEncoding.default,
headers: HTTPHeaders? = nil)
- 默认不设置请求方法为
get方法，因此使用中get方法，不需要配置直接通过url发起请求 - 参数
Parameters为字典类型，默认为空，会根据method做不同处理
2、POST请求
let urlStr = "http://onapp.yahibo.top/public/?s=api/test/list"
Alamofire.request(url, method: .post, parameters: ["name":"hibo","password":"123456"]).responseJSON { (response) in
switch response.result {
case .success(let json):
print(json)
break
case .failure(let error):
print("error:\(error)")
break
}
}
- 需要设置
method参数为post
3、文件下载
let videoUrl = "http://onapp.yahibo.top/public/videos/video.mp4"
Alamofire.download(videoUrl, to: { (videoUrl, response) -> (destinationURL: URL, options: DownloadRequest.DownloadOptions) in
let documentsURL = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
let time = Date().timeIntervalSince1970
let fileURL = documentsURL.appendingPathComponent("\(time).mp4")
print("沙盒路径：\(documentsURL)")
return (fileURL, [.removePreviousFile, .createIntermediateDirectories])
}).downloadProgress { (progress) in
print(progress)
}
- 获取沙盒路径转存视频文件
4、上传表单
let imgArr:Array = [UIImage.init(named: "headimg"),UIImage.init(named: "headimg")]
Alamofire.upload(multipartFormData: { (formData) in
formData.append("hibo".data(using: .utf8)!, withName: "name")
formData.append("123456".data(using: .utf8)!, withName: "password")
for i in 0 ... imgArr.count-1 {
let data = imgArr[i]!.pngData()
let fileName = "image_\(i).png"
formData.append(data!, withName: "image[]", fileName: fileName, mimeType: "image/png")
}
}, to: url) { (result) in
switch result {
case .success(let upload, _, _):
upload.uploadProgress(closure: { (progress) in
print(progress)
}).responseJSON(completionHandler: { (response) in
switch response.result {
case .success(let json):
print(json)
break
case .failure(let error):
print("error:\(error)")
break
}
})
break
case .failure(let error):
print(error)
break
}
print("result:\(result)")
}
- 能够同时上传其他参数和图片
-
image[]后台通过image获取到的是一个数组 -
fileName图片名称 - 在
result中监听上传进度，获取上传结果
5、后台下载
设置全局对象：
struct BackgroundManager {
static let shared = BackgroundManager()
let manager: SessionManager = {
let configuration = URLSessionConfiguration.background(withIdentifier:"com.yahibo.background_id")
configuration.httpAdditionalHeaders = SessionManager.defaultHTTPHeaders
return SessionManager(configuration: configuration)
}()
}
调用发起下载请求：
BackgroundManager.shared.manager.download(url) { (url, response) -> (destinationURL: URL, options: DownloadRequest.DownloadOptions) in
let documentsURL = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
let fileURL = documentsURL.appendingPathComponent("\(self.currentDateStr()).mp4")
return (fileURL, [.removePreviousFile, .createIntermediateDirectories])
}.downloadProgress(queue: DispatchQueue.global(qos: .utility)) { (progress) in
print(progress)
}.response(queue: DispatchQueue.global(qos: .utility), completionHandler: { (response) in
print("完成下载：\(response)")
})
开启后台下载权限并赋值系统闭包：
//设置此处开启后台下载权限
func application(_ application: UIApplication, handleEventsForBackgroundURLSession identifier: String, completionHandler: @escaping () -> Void) {
BackgroundManager.shared.manager.backgroundCompletionHandler = completionHandler
}
后台下载与其他请求不同，需要开启权限，并将系统闭包传递到请求代理方法中，后台下载完成，通过闭包通知系统及时刷新界面。
manager设置为全局变量为方便调用。
6、设置公共参数
实现RequestAdapter协议方法
class MyAdapter: RequestAdapter{
func adapt(_ urlRequest: URLRequest) throws -> URLRequest {
var request = urlRequest
request.setValue("hibotoken", forHTTPHeaderField: "token")
request.setValue("device", forHTTPHeaderField: "iOS")
request.setValue("vision", forHTTPHeaderField: "1.0.0")
return request
}
}
- 创建
MyAdapter类继承协议，并实现协议方法 - 设置开发中使用到的公共参数
设置属性
let url = "http://onapp.yahibo.top/public/?s=api/test/list”
Alamofire.SessionManager.default.adapter = MyAdapter()
Alamofire.request(url).responseJSON { (response) in
switch response.result {
case .success(let json):
print(json)
break
case .failure(let error):
print("error:\(error)")
break
}
}
这里的default是个单列，属性设置一次就好，不用在每次请求前设置。
7、请求重定向
实现RequestAdapter协议方法
class redireatAdapter: RequestAdapter{
func adapt(_ urlRequest: URLRequest) throws -> URLRequest {
let newURLRequest = URLRequest.init(url: URL.init(string: "http://onapp.yahibo.top/public/?s=api/test")!)
return newURLRequest
}
}
- 重新设置了请求
URLRequest对象，改变了请求url
设置属性
let url = "http://onapp.yahibo.top/public/?s=api/test/list”
Alamofire.SessionManager.default.adapter = redireatAdapter()
Alamofire.request(url).responseJSON { (response) in
switch response.result {
case .success(let json):
print(json)
break
case .failure(let error):
print("error:\(error)")
break
}
}
该重定向不常用，如应用被逆向，给个重定向，就是不给你数据。
8、重新请求
同上面协议，创建子类实现方法，调用即可。
实现协议方法
class MyRetrier: RequestRetrier{
var count: Int = 0
func should(_ manager: SessionManager, retry request: Request, with error: Error, completion: @escaping RequestRetryCompletion) {
if count<3 {
completion(true,2)
count += 1
}else{
completion(false,2)
}
}
}
- 设定重新发送请求3次
- 延时2秒再发送请求
设置属性
Alamofire.SessionManager.default.retrier = MyRetrier()
请求失败后，就会隔时重新发送请求。
9、自定义验证
let urlStr = "http://onapp.yahibo.top/public/?s=api/test/list2"
let url = URL.init(string: urlStr)!
Alamofire.SessionManager.default.retrier = MyRetrier()
Alamofire.request(url).responseJSON {
(response) in
switch response.result{
case .success(let json):
print("json:\(json)")
break
case .failure(let error):
print("error:\(error)")
break
}
}.validate{ (request, response, data) -> Request.ValidationResult in
print(response)
guard let _ = data else {
return .failure(NSError(domain: "没有数据啊", code: 10086, userInfo: nil))
}
if response.statusCode == 404 {
return .failure(NSError(domain: "密码错误", code: response.statusCode, userInfo: nil))
}
return .success
}
调用
validate方法，实现参数闭包，在闭包内拦截错误消息。
我使用该框架，可能会对框架进一步封装，对错误响应统一处理，如错误消息，通过弹框通知用户，处理loading视图。不知道大佬们都怎么处理。
网友评论