Alamofire 的基本用法

1. Alamofire 的请求方式

1.1 GET 请求 (默认就是get请求)
    Alamofire.request(urlString).responseJSON { (response) in
        
        print(response.request)  // original URL request
        print(response.response) // URL response
        print(response.data)     // server data
        print(response.result)   // result of response serialization

        if let JSON = response.result.value {
            print("JSON: \(JSON)")
        }
    }
1.2 其他方式请求
// 参数method 就是设置请求类型的, 以post为例
    Alamofire.request(urlString, method: .post, parameters: parameters as? Parameters, encoding: URLEncoding.default, headers: nil).responseJSON { (response) in

        switch response.result {
        case .success(let json):

            print("json: \(json)")
        case .failure(let error):

            debugPrint(error.localizedDescription)
        }
    }
  1. request 的第一个参数url支持多种类型(String、URL、Request),在框架内部已经为我们处理好了,怎么方便怎么用
  2. Alamofire.request 后得到DataRequest 类型对象, 直接调用responseJSON获取json数据
1.3 Alamofire 的request
public func request(
    _ url: URLConvertible,
    method: HTTPMethod = .get,
    parameters: Parameters? = nil,
    encoding: ParameterEncoding = URLEncoding.default,
    headers: HTTPHeaders? = nil)
    -> DataRequest
  1. 默认不设置请求方法为get方法,因此使用中get方法,不需要配置直接通过url发起请求
  2. 参数Parameters为字典类型,默认为空

2. Alamofire 设置公共参数

  1. 创建MyAdapter类继承协议,并实现协议方法
import UIKit
import Alamofire

// MARK: 遵守RequestAdapter 协议
class MyAdapter: RequestAdapter {

    // 实现adapt 协议方法, 来完成公共参数的配置
    func adapt(_ urlRequest: URLRequest) throws -> URLRequest {
        var request = urlRequest
        // 需要什么就设置什么
        request.setValue("device", forHTTPHeaderField: "iOS")
        request.setValue("vision", forHTTPHeaderField: "1.0.0")
        return request
    }
}
  1. 设置开发中使用到的公共参数
    // 配置公共信息: 这里的default是个单列,属性设置一次就好,不用在每次请求前设置
    Alamofire.SessionManager.default.adapter = MyAdapter()
    Alamofire.request(urlString, method: .post, parameters: parameters as? Parameters, encoding: URLEncoding.default, headers: nil).responseJSON { (response) in

        switch response.result {
        case .success(let json):

            print("json: \(json)")
        case .failure(let error):

            debugPrint(error.localizedDescription)
        }
    }

3. Alamofire 请求重定向

  1. 创建MyAdapter类继承协议,并实现协议方法, 设置属性就和设置公共参数一样
import UIKit
import Alamofire

// MARK: 遵守RequestAdapter 协议
class MyAdapter: RequestAdapter {
    
    // 重新设置了请求URLRequest对象,改变了请求url
    func adapt(_ urlRequest: URLRequest) throws -> URLRequest {
        let newRequest = URLRequest.init(url: URL(string: "https://www.baidu.com")!)
        return newRequest
    }
}

4. Alamofire 的自定义验证

调用validate方法,实现参数闭包,在闭包内拦截错误消息,对错误响应统一处理.

    Alamofire.request(urlString, method: .post, parameters: parameters as? Parameters, encoding: URLEncoding.default, headers: nil).responseJSON { (response) in
        
        switch response.result {
        case .success(let json):
            print("json: \(json)")
            success(json)
        case .failure(let error):
            debugPrint(error.localizedDescription)
            failure(error)
        }
    }.validate { (request, response, data) -> Request.ValidationResult in
        
        print("validate中的response: \(response)")
        guard let _ = data else {
            return .failure(NSError(domain: "没有数据", code: 9999, userInfo: nil))
        }
        if response.statusCode == 404 {
            return .failure(NSError(domain: "系统繁忙", code: response.statusCode, userInfo: nil))
        }
        return .success
    }

5. Alamofire 上传文件(以文字+图片为例)

    func upload(status: String,images:[UIImage], success:@escaping (Any?)->(), failure:@escaping (Any?)->()){
        // 请求url
        let urlString = "上传文件的地址"
        let statusString = "一些文字内容"
        
        Alamofire.upload(multipartFormData: { (formData) in
            
            // 普通参数 - 拼接到表单
            formData.append(access_token.data(using: .utf8)!, withName: "access_token")
            formData.append(statusString.data(using: .utf8)!, withName: "status")
            /*
             - 参数01 上传的二进制文件
             - 参数02 服务器指定的名字 pic  mp4 mp3 区分客户端上传的是什么文件描述
             - 参数03 文件路径名字 一般可以随意些 及时你写了 服务器也不用
             - 参数04 告知服务器我们上传的文件的类型 一般可以传入application/octet-stream
             */
            // 如果一次发布9张图片怎么办 -> 通过循环方式上传
            let data = images.first?.pngData()
            if let d = data {
                formData.append(d, withName: "pic", fileName: "xxxxf", mimeType: "application/octet-stream")
            }
        }, to: urlString) { (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):
                        success(json)
                        break
                    case .failure(let error):
                        failure(error)
                        break
                    }
                })
                break
            case .failure(let error):
                failure(error)
                break
            }
            print("result:\(result)")
        }
    }

待更新...

你可能感兴趣的:(Alamofire 的基本用法)