Alamofire-Request

request.png

一、简述

在Alamofire中为了方便管理，明确分工，Alamofire对整个请求过程做了明确划分，并统一交由SessionManager来管理。SessionManager负责SessionDelegate、URLSession、URLRequest等对象创建与管理。先看一段请求示例：

let urlStr = "http://onapp.yahibo.top/public/?s=api/test/list"
let url = URL.init(string: urlStr)!
Alamofire.request(url,method: .post,parameters: ["page":"1","size":"20"]).responseJSON {
    (response) in
    switch response.result{
    case .success(let json):
        print("json:\(json)")
        break
    case .failure(let error):
        print("error:\(error)")
        break
    }
}

这里的request相当于Alamofire的一个请求api，内部实现了所有需要的请求配置，此外也封装了download、upload、stream等请求api供用户直接使用。一般请求流程为url -> request -> task -> response，一般url为String类型的资源链接，request才是我们请求的重中之重。在Alamofire中对请求流程都做了任务细分，下面以request作为主线向下探索，看看框架是如何细分的。

二、URLRequest常规配置

下面看一下常规配置：

let url = URL.init(string: "1⃣协议://2⃣主机地址/3⃣路径/4⃣参数1&参数2")!
var request  = URLRequest.init(url: url)
request.httpMethod = HTTPMethod.post.rawValue
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
let postData = ["username":"hibo","password":"123456"]
request.httpBody = try?JSONSerialization.data(withJSONObject: postData, options: [])
request.timeoutInterval = 30
request.cachePolicy = .useProtocolCachePolicy

需要一系列参数配置，可能根据不同需要要做更多的配置，项目中几乎每个页面都需要网络请求，对于以上的代码量，肯定是要做封装处理，提取通用代码复用，开放配置参数，供特殊需求使用。

三、对URLRequest的封装

open func request(
    _ url: URLConvertible,
    method: HTTPMethod = .get,
    parameters: Parameters? = nil,
    encoding: ParameterEncoding = URLEncoding.default,
    headers: HTTPHeaders? = nil)
    -> DataRequest
{
    var originalRequest: URLRequest?

    do {
        originalRequest = try URLRequest(url: url, method: method, headers: headers)
        let encodedURLRequest = try encoding.encode(originalRequest!, with: parameters)
        return request(encodedURLRequest)
    } catch {
        return request(originalRequest, failedWith: error)
    }
}
  • url：请求资源连接
  • method：HTTPMethod枚举类型参数，设置请求类型默认get类型
  • Parameters：请求参数，字典类型，默认为nil
  • encoding：支持编码格式，有三种类型：URLEncoding、JSONEncoding、PropertyListEncoding默认URLEncoding
  • headers：请求头参数设置默认为空

以上为对外引出常规参数，用户根据需求设置，内部有默认值，用户不设置则启用默认值（通用属性值）。以上几个参数即是URLRequest的属性，请求中的主要属性。

四、参数处理

在开发中，我们常常使用GET请求或POST请求。GET请求，请求参数是拼接在地址上的&或/符合分隔，常用于获取数据；POST请求将参数封装在请求体中，常用数据提交。

下面看一下框架是如何处理这些参数的：

public func encode(_ urlRequest: URLRequestConvertible, with parameters: Parameters?) throws -> URLRequest {
    var urlRequest = try urlRequest.asURLRequest()

    guard let parameters = parameters else { return urlRequest }

    if let method = HTTPMethod(rawValue: urlRequest.httpMethod ?? "GET"), encodesParametersInURL(with: method) {
        guard let url = urlRequest.url else {
            throw AFError.parameterEncodingFailed(reason: .missingURL)
        }

        if var urlComponents = URLComponents(url: url, resolvingAgainstBaseURL: false), !parameters.isEmpty {
            let percentEncodedQuery = (urlComponents.percentEncodedQuery.map { $0 + "&" } ?? "") + query(parameters)
            urlComponents.percentEncodedQuery = percentEncodedQuery
            urlRequest.url = urlComponents.url
        }
    } else {
        if urlRequest.value(forHTTPHeaderField: "Content-Type") == nil {
            urlRequest.setValue("application/x-www-form-urlencoded; charset=utf-8", forHTTPHeaderField: "Content-Type")
        }

        urlRequest.httpBody = query(parameters).data(using: .utf8, allowLossyConversion: false)
    }

    return urlRequest
}
  • 没有参数直接返回URLRequest对象
  • 有参数则需要对分别处理参数，GET需要拼接，POST需要添加添加至httpBody请求体中
  • percentEncodedQuery获取域名后的参数并与请求参数拼接

query函数对参数做了拼接处理。如下：

private func query(_ parameters: [String: Any]) -> String {
    var components: [(String, String)] = []

    for key in parameters.keys.sorted(by: <) {
        let value = parameters[key]!
        components += queryComponents(fromKey: key, value: value)
    }
    return components.map { "\($0)=\($1)" }.joined(separator: "&")
}
  • 传入一个字典参数
  • 对字典key的ASCII码进行排序，重新组合成一个元组数组
  • queryComponents内部进行递归操作，将key和value进行百分号编码，并放回元组中
  • 通过map结合元组元素形成新的数组，在通过joined函数将数组元素拼接，两个元素直接用&符分隔

queryComponents

public func queryComponents(fromKey key: String, value: Any) -> [(String, String)] {
    var components: [(String, String)] = []

    if let dictionary = value as? [String: Any] {
        for (nestedKey, value) in dictionary {
            components += queryComponents(fromKey: "\(key)[\(nestedKey)]", value: value)
        }
    } else if let array = value as? [Any] {
        for value in array {
            components += queryComponents(fromKey: arrayEncoding.encode(key: key), value: value)
        }
    } else if let value = value as? NSNumber {
        if value.isBool {
            components.append((escape(key), escape(boolEncoding.encode(value: value.boolValue))))
        } else {
            components.append((escape(key), escape("\(value)")))
        }
    } else if let bool = value as? Bool {
        components.append((escape(key), escape(boolEncoding.encode(value: bool))))
    } else {
        components.append((escape(key), escape("\(value)")))
    }

    return components
}
  • 递归操作，遍历到数据的每一层，直到键值对的值为非字典和数组类型，开始对key和value做百分号编码操作
  • escape为编码函数

GET请求

通过query来拼接并做百分号编码所有的键值对，处理成"username=hibo&password=123456"这种形式，直接拼接至请求域名上，request.url为域名，上面通过urlComponents.percentEncodedQuery已经拆分出来了资源路径因此，拼接的连接为：host+资源路径（s=api/test/list/）+&+参数

POST请求

在没有Content-Type配置的情况下给默认配置。如下：

urlRequest.setValue("application/x-www-form-urlencoded; charset=utf-8", forHTTPHeaderField: "Content-Type")

把query拼接后的参数转换为Data类型数据，传给请求体httpBody。至此GET或其他请求的参数就已经设置完毕。URLRequest设置完成后，就可以创建任务发送请求了。下面看一下框架怎么处理。

五、发送请求

顺着代码找到另一个request方法：

open func request(_ urlRequest: URLRequestConvertible) -> DataRequest {
    var originalRequest: URLRequest?

    do {
        originalRequest = try urlRequest.asURLRequest()
        let originalTask = DataRequest.Requestable(urlRequest: originalRequest!)

        let task = try originalTask.task(session: session, adapter: adapter, queue: queue)
        let request = DataRequest(session: session, requestTask: .data(originalTask, task))

        delegate[task] = request

        if startRequestsImmediately { request.resume() }

        return request
    } catch {
        return request(originalRequest, failedWith: error)
    }
}

这里只做了三步处理：

  1. 在这个方法中并没有发起请求，而是将发起任务的session和request，交给了DataRequest，对任务分层，manager说我这只管维持你们需要的参数，具体任务自己带回家去做，分工明确，思路更清晰。

  2. 绑定绑定返回task和request，以便SessionDelegate做任务下发，在SessionDelegate中通过task获取taskDelegate对象

  3. 有manager管理任务的启动request.resume()

DataRequest

init(session: URLSession, requestTask: RequestTask, error: Error? = nil) {
    self.session = session

    switch requestTask {
    case .data(let originalTask, let task):
        taskDelegate = DataTaskDelegate(task: task)
        self.originalTask = originalTask
    case .download(let originalTask, let task):
        taskDelegate = DownloadTaskDelegate(task: task)
        self.originalTask = originalTask
    case .upload(let originalTask, let task):
        taskDelegate = UploadTaskDelegate(task: task)
        self.originalTask = originalTask
    case .stream(let originalTask, let task):
        taskDelegate = TaskDelegate(task: task)
        self.originalTask = originalTask
    }

    delegate.error = error
    delegate.queue.addOperation { self.endTime = CFAbsoluteTimeGetCurrent() }
}
  • 通过枚举来配置不同的任务代理

TaskDelegate

分多个子类，具有不同职能。子类如下：

DataTaskDelegate
DownloadTaskDelegate
UploadTaskDelegate

根据不同任务类型，由Request类确定不同的处理类，stream类的任务有基类处理。该类中都对外声明了相应代理事件的闭包，以便对外传递代理消息。如下：

var progressHandler: (closure: Request.ProgressHandler, queue: DispatchQueue)?
var uploadProgressHandler: (closure: Request.ProgressHandler, queue: DispatchQueue)?

该闭包都是在Request类中或者拓展方法中实现的，实际不是实现只是桥接到界面中实现，从而代理事件传递直接传到界面闭包。

总结

1、SessionManager

  • httpAdditionalHeaders参数配置
  • 创建URLRequest
  • 创建URLSession
  • URLSessionDelegate代理移交给SessionDelegate
  • 发起任务请求

2、SessionDelegate

  • 实现所有网络请求的代理方法，并对外声明闭包，通过闭包向外传递代理响应事件
  • 如果外部没有实现接收代理事件的闭包，会将代理事件通过task标识移交给TaskDelegate中具体的子类来处理

3、Request

  • 负责任务的创建，保留URLSession对象即URLRequest对象
  • 负责任务下发，下发至TaskDelegate中
  • 实现数据传递方法，对外设置闭包参数，内部将闭包桥接至TaskDelegate中，即实现TaskDelegate中对外声明的闭包
  • 方法返回self实现链式调用

4、TaskDelegate

  • 创建子类，负责具体任务实现
  • 对外声明闭包向外传递代理消息
  • 改类对象在Request中使用
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 194,242评论 5赞 459
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 81,769评论 2赞 371
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 141,484评论 0赞 319
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 52,133评论 1赞 263
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 61,007评论 4赞 355
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 46,080评论 1赞 272
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 36,496评论 3赞 381
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 35,190评论 0赞 253
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 39,464评论 1赞 290
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,549评论 2赞 309
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,330评论 1赞 326
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 32,205评论 3赞 312
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 37,567评论 3赞 298
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,889评论 0赞 17
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,160评论 1赞 250
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 41,475评论 2赞 341
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 40,650评论 2赞 335